iOS

sudo gem install cocoapods

pod init

platform :ios, '8.0'
target 'App' do

# TRTC 精简版（推荐）
# 安装包体积增量最小，仅支持实时音视频（TRTC）和 直播播放器（TXLivePlayer）两项功能。
pod 'TXLiteAVSDK_TRTC', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_TRTC.podspec'

# LiteAVSDK 全功能版
# 包含实时音视频（TRTC）、直播播放器（TXLivePlayer）、RTMP 推流（TXLivePusher）、点播播放器（TXVodPlayer）和短视频录制和编辑（UGSV）等众多功能。
pod 'TXLiteAVSDK_Professional', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_Professional.podspec'

# IM 基础版
pod 'TXIMSDK_iOS'

# IM 增强版（推荐）
pod 'TXIMSDK_Plus_iOS'
# pod 'TXIMSDK_Plus_Swift_iOS'

# IM 增强版 xcframework 版本（推荐）
pod 'TXIMSDK_Plus_iOS_XCFramework'
# pod 'TXIMSDK_Plus_Swift_iOS_XCFramework'

end

pod install

pod update

Privacy - Microphone Usage Description, 同时填入麦克风使用目的提示语

// 从即时通信 IM 控制台获取应用 SDKAppID。
// 添加 V2TIMSDKListener 的事件监听器，self 是 id<V2TIMSDKListener> 的实现类，如果您不需要监听 IM SDK 的事件，这个步骤可以忽略。
[[V2TIMManager sharedInstance] addIMSDKListener:self];
// 初始化 IM SDK，调用这个接口后，可以立即调用登录接口。
[[V2TIMManager sharedInstance] initSDK:sdkAppID config:config];

// SDK 初始化后会抛出一些事件，例如连接状态、登录票据过期等
- (void)onConnecting {
    NSLog(@"IM SDK 正在连接到腾讯云服务器");
}

- (void)onConnectSuccess {
    NSLog(@"IM SDK 已经成功连接到腾讯云服务器");
}

// 移除事件监听器
// self 是 id<V2TIMSDKListener> 的实现类
[[V2TIMManager sharedInstance] removeIMSDKListener:self];
// 反初始化 SDK
[[V2TIMManager sharedInstance] unInitSDK];

// 创建 TRTC SDK 实例（单例模式）
_trtcCloud = [TRTCCloud sharedInstance];
// 设置事件监听器
_trtcCloud.delegate = self;

// 来自 SDK 的各类事件通知（比如：错误码，警告码，音视频状态参数等）
- (void)onError:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg extInfo:(nullable NSDictionary *)extInfo {
    NSLog(@"%d: %@", errCode, errMsg);
}

- (void)onWarning:(TXLiteAVWarning)warningCode warningMsg:(nullable NSString *)warningMsg extInfo:(nullable NSDictionary *)extInfo {
    NSLog(@"%d: %@", warningCode, warningMsg);
}

// 移除事件监听器
_trtcCloud.delegate = nil;
// 销毁 TRTC SDK 实例（单例模式）
[TRTCCloud destroySharedIntance];

// 登录：userID 可自定义，userSig 参考步骤一生成获取
[[V2TIMManager sharedInstance] login:userID userSig:userSig succ:^{
    NSLog(@"success");
} fail:^(int code, NSString *desc) {
    // 如果返回以下错误码，表示使用 UserSig 已过期，请您使用新签发的 UserSig 进行再次登录。
    // 1. ERR_USER_SIG_EXPIRED（6206）
    // 2. ERR_SVR_ACCOUNT_USERSIG_EXPIRED（70001）
    // 注意：其他的错误码，请不要在这里调用登录接口，避免 IM SDK 登录进入死循环。
    NSLog(@"failure, code:%d, desc:%@", code, desc);
}];

// 登出
[[V2TIMManager sharedInstance] logout:^{
    NSLog(@"success");
} fail:^(int code, NSString *desc) {
    NSLog(@"failure, code:%d, desc:%@", code, desc);
}];

// 创建群组
[[V2TIMManager sharedInstance] createGroup:GroupType_AVChatRoom groupID:groupID groupName:groupName succ:^(NSString *groupID) {
    // 创建群组成功
} fail:^(int code, NSString *desc) {
    // 创建群组失败
}];


// 监听群组创建通知
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupCreated:(NSString *)groupID {
    // 群创建回调，groupID 为新创建群组的 ID
}

// 加入群组
[[V2TIMManager sharedInstance] joinGroup:groupID msg:message succ:^{
    // 加入群组成功
} fail:^(int code, NSString *desc) {
    // 加入群组失败
}];

// 监听加入群组事件
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onMemberEnter:(NSString *)groupID memberList:(NSArray<V2TIMGroupMemberInfo *>*)memberList {
    // 有人加入群组
}

- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // 以字符串房间号为例，建议和 IM 群组号保持一致
    params.strRoomId = roomId;
    params.userId = userId;
    // 从业务后台获取到的 UserSig
    params.userSig = getUserSig(userId);
    // 替换成您的 SDKAppID
    params.sdkAppId = SDKAppID;
    // 语聊互动场景进房需指定用户角色
    params.role = TRTCRoleAudience;
    // 以语聊互动进房场景为例
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneVoiceChatRoom];
}

// 进房结果事件回调
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result 代表加入房间所消耗的时间(毫秒)
        [self toastTip:@"Enter room succeed!"];
    } else {
        // result 代表进房失败的错误码
        [self toastTip:@"Enter room failed!"];
    }
}

[[V2TIMManager sharedInstance] quitGroup:groupID succ:^{
    // 退出群组成功
} fail:^(int code, NSString *desc) {
    // 退出群组失败
}];

[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onMemberLeave:(NSString *)groupID member:(V2TIMGroupMemberInfo *)member {
    // 群成员离开回调
}

- (void)exitTrtcRoom {
    self.trtcCloud = [TRTCCloud sharedInstance];
    [self.trtcCloud stopLocalAudio];
    [self.trtcCloud exitRoom];
}

// 监听 onExitRoom 回调即可获知自己的退房原因
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        // 主动调用 exitRoom 退出房间
        NSLog(@"Exit current room by calling the 'exitRoom' api of sdk ...");
    } else if (reason == 1) {
        // 被服务器踢出当前房间
        NSLog(@"Kicked out of the current room by server through the restful api...");
    } else if (reason == 2) {
        // 当前房间整个被解散
        NSLog(@"Current room is dissolved by server through the restful api...");
    }
}

[[V2TIMManager sharedInstance] dismissGroup:groupID succ:^{
    // 解散群组成功
} fail:^(int code, NSString *desc) {
    // 解散群组失败
}];

[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupDismissed:(NSString *)groupID opUser:(V2TIMGroupMemberInfo *)opUser {
    // 群被解散回调
}

// 听众发送上麦请求，userId 为主播 ID，data 可传入标识信令的 json
- (void)sendInvitationWithUserId:(NSString *)userId data:(NSString *)data {
    [[V2TIMManager sharedInstance] invite:userId data:data onlineUserOnly:YES offlinePushInfo:nil timeout:0 succ:^{
        NSLog(@"sendInvitation success");
    } fail:^(int code, NSString *desc) {
        NSLog(@"sendInvitation error %d", code);
    }];
}

// 主播收到上麦请求, inviteID 为该条请求 ID，inviter 为请求者 ID
[[V2TIMManager sharedInstance] addSignalingListener:self];
- (void)onReceiveNewInvitation:(NSString *)inviteID inviter:(NSString *)inviter groupID:(NSString *)groupID inviteeList:(NSArray<NSString *> *)inviteeList data:(NSString * __nullable)data {
    NSLog(@"received invitation: %@ from %@", inviteID, inviter);
}

// 同意上麦请求
- (void)acceptInvitationWithInviteID:(NSString *)inviteID data:(NSString *)data {
    [[V2TIMManager sharedInstance] accept:inviteID data:data succ:^{
        NSLog(@"acceptInvitation success");
    } fail:^(int code, NSString *desc) {
        NSLog(@"acceptInvitation error %d", code);
    }];
}

// 拒绝上麦请求
- (void)rejectInvitationWithInviteID:(NSString *)inviteID data:(NSString *)data {
    [[V2TIMManager sharedInstance] reject:inviteID data:data succ:^{
        NSLog(@"rejectInvitation success");
    } fail:^(int code, NSString *desc) {
        NSLog(@"rejectInvitation error %d", code);
    }];
}

// 本地保存的全量麦位信息列表
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// 同意上麦请求的回调
- (void)onInviteeAccepted:(NSString *)inviteID invitee:(NSString *)invitee data:(NSString * __nullable)data {
    NSLog(@"received accept invitation: %@ from %@", inviteID, invitee);
    NSInteger seatIndex = [self findSeatIndex:inviteID];
    [self takeSeatWithIndex:seatIndex];
}

// 听众开始上麦
- (void)takeSeatWithIndex:(NSInteger)seatIndex {
    // 创建麦位信息实例，存储修改后的麦位信息
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUsed;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = self.userId;
    
    // 将麦位信息对象序列化为 JSON 格式
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // 设置群属性，已有该群属性则更新其 value 值，没有该群属性则添加该属性
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // 修改群属性成功，切换 TRTC 角色并开始推流
        [self.trtcCloud switchRole:TRTCRoleAnchor];
        [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
    } fail:^(int code, NSString *desc) {
        // 修改群属性失败，上麦失败
    }];
}

// 本地保存的全量麦位信息列表
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// 主播端调用该接口修改群属性保存的麦位信息
- (void)pickSeatWithUserId:(NSString *)userId seatIndex:(NSInteger)seatIndex {
    // 创建麦位信息实例，存储修改后的麦位信息
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUsed;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = self.userId;
    
    // 将麦位信息对象序列化为 JSON 格式
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // 设置群属性，已有该群属性则更新其 value 值，没有该群属性则添加该属性
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // 修改群属性成功，触发 onGroupAttributeChanged 回调
    } fail:^(int code, NSString *desc) {
        // 修改群属性失败，上麦失败
    }];
}

// 听众端收到群属性变更回调，匹配自身信息成功后开始推流
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupAttributeChanged:(NSString *)groupID attributes:(NSMutableDictionary<NSString *,NSString *> *)attributes {
    // 上一次本地保存的全量麦位信息列表
    NSArray *oldSeatArray = self.seatInfoArray;
    // 最新从 groupAttributeMap 中解析的全量麦位信息列表
    NSArray *newSeatArray = [self getSeatListFromAttr:attributes seatSize:self.seatSize];
    // 遍历全量麦位信息列表，对比新旧麦位信息
    for (int i = 0; i < self.seatSize; i++) {
        SeatInfoModel *oldInfo = oldSeatArray[i];
        SeatInfoModel *newInfo = newSeatArray[i];
        if (oldInfo.status != newInfo.status && newInfo.status == SeatInfoStatusUsed) {
            if ([newInfo.userId isEqualToString:self.userId]) {
                // 匹配自身信息成功，切换 TRTC 角色并开始推流
                [self.trtcCloud switchRole:TRTCRoleAnchor];
                [self.trtcCloud startLocalAudio:TRTCAudioQualityDefault];
            } else {
                // 更新本地麦位列表，渲染本地麦位视图
            }
        }
    }
}

// 本地保存的全量麦位信息列表
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

- (void)leaveSeatWithIndex:(NSInteger)seatIndex {
    // 创建麦位信息实例，存储修改后的麦位信息
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUnused;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = @"";
    
    // 将麦位信息对象序列化为 JSON 格式
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // 设置群属性，已有该群属性则更新其 value 值，没有该群属性则添加该属性
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // 修改群属性成功，切换 TRTC 角色并停止推流
        [self.trtcCloud switchRole:TRTCRoleAudience];
        [self.trtcCloud stopLocalAudio];
    } fail:^(int code, NSString *desc) {
        // 修改群属性失败，下麦失败
    }];
}

// 本地保存的全量麦位信息列表
@property (nonatomic, copy) NSArray<SeatInfoModel *> *seatInfoArray;

// 主播端调用该接口修改群属性保存的麦位信息
- (void)kickSeatWithIndex:(NSInteger)seatIndex {
    // 创建麦位信息实例，存储修改后的麦位信息
    SeatInfoModel *localInfo = self.seatInfoArray[seatIndex];
    SeatInfoModel *seatInfo = [[SeatInfoModel alloc] init];
    seatInfo.status = SeatInfoStatusUnused;
    seatInfo.mute = localInfo.mute;
    seatInfo.userId = @"";
    
    // 将麦位信息对象序列化为 JSON 格式
    NSString *jsonStr = seatInfo.toJSONString;
    NSDictionary *dict = @{ [NSString stringWithFormat:@"seat%ld", seatIndex]: jsonStr };
    
    // 设置群属性，已有该群属性则更新其 value 值，没有该群属性则添加该属性
    [[V2TIMManager sharedInstance] setGroupAttributes:self.groupId attributes:dict succ:^{
        // 修改群属性成功，触发 onGroupAttributeChanged 回调
    } fail:^(int code, NSString *desc) {
        // 修改群属性失败，踢麦失败
    }];
}

// 连麦听众端收到群属性变更回调，匹配自身信息成功后停止推流
[[V2TIMManager sharedInstance] addGroupListener:self];
- (void)onGroupAttributeChanged:(NSString *)groupID attributes:(NSMutableDictionary<NSString *,NSString *> *)attributes {
    // 上一次本地保存的全量麦位信息列表
    NSArray *oldSeatArray = self.seatInfoArray;
    // 最新从 groupAttributeMap 中解析的全量麦位信息列表
    NSArray *newSeatArray = [self getSeatListFromAttr:attributes seatSize:self.seatSize];
    // 遍历全量麦位信息列表，对比新旧麦位信息
    for (int i = 0; i < self.seatSize; i++) {
        SeatInfoModel *oldInfo = oldSeatArray[i];
        SeatInfoModel *newInfo = newSeatArray[i];
        if (oldInfo.status != newInfo.status && newInfo.status == SeatInfoStatusUnused) {
            if ([newInfo.userId isEqualToString:self.userId]) {
                // 匹配自身信息成功，切换 TRTC 角色并停止推流
                [self.trtcCloud switchRole:TRTCRoleAudience];
                [self.trtcCloud stopLocalAudio];
            } else {
                // 更新本地麦位列表，渲染本地麦位视图
            }
        }
    }
}