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

end

pod install

pod update

// 创建 TRTC SDK 实例（单例模式）
self.trtcCloud = [TRTCCloud sharedInstance];
// 设置事件监听器
self.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);
}

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

- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // 以字符串房间号为例
    params.strRoomId = roomId;
    params.userId = userId;
    // 从业务后台获取到的 UserSig
    params.userSig = [self generateUserSig:userId];
    // 替换成您的 SDKAppID
    params.sdkAppId = SDKAppID;
    // 建议均以观众角色进房
    params.role = TRTCRoleAudience;
    // 进房场景须选择 LIVE
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE];
}

// 进房结果事件回调
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result 代表加入房间所消耗的时间(毫秒)
        NSLog(@"Enter room succeed!");
        // 开启补黑帧的实验性接口
        [self.trtcCloud callExperimentalAPI:@"{\\"api\\":\\"enableBlackStream\\",\\"params\\": {\\"enable\\":true}}"];
    } else {
        // result 代表进房失败的错误码
        NSLog(@"Enter room failed!");
    }
}

// 切换为主播角色
[self.trtcCloud switchRole:TRTCRoleAnchor];

// 切换角色事件回调
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(NSString *)errMsg {
    if (errCode == ERR_NULL) {
        // 设置媒体音量类型
        [self.trtcCloud setSystemVolumeType:TRTCSystemVolumeTypeMedia];
        // 上行本地音频流，设置音质
        [self.trtcCloud startLocalAudio:TRTCAudioQualityMusic];
    }
}

// 获取音频特效管理类
self.audioEffectManager = [self.trtcCloud getAudioEffectManager];

// originMusicId: 自定义原唱音乐标识；originMusicUrl: 原唱音乐资源地址
TXAudioMusicParam *originMusicParam = [[TXAudioMusicParam alloc] init];
originMusicParam.ID = originMusicId;
originMusicParam.path = originMusicUrl;
// 是否将原唱发布到远端(否则仅本地播放)
originMusicParam.publish = YES;

// accompMusicId: 自定义伴奏音乐标识；accompMusicUrl: 伴奏音乐资源地址
TXAudioMusicParam *accompMusicParam = [[TXAudioMusicParam alloc] init];
accompMusicParam.ID = accompMusicId;
accompMusicParam.path = accompMusicUrl;
// 是否将伴奏发布到远端(否则仅本地播放)
accompMusicParam.publish = YES;

// 开始播放原唱音乐
[self.audioEffectManager startPlayMusic:originMusicParam onStart:^(NSInteger errCode) {
    // onStart
} onProgress:^(NSInteger progressMs, NSInteger durationMs) {
    // onProgress
} onComplete:^(NSInteger errCode) {
    // onComplete
}];

// 开始播放伴奏音乐
[self.audioEffectManager startPlayMusic:originMusicParam onStart:^(NSInteger errCode) {
    // onStart
} onProgress:^(NSInteger progressMs, NSInteger durationMs) {
    // onProgress
} onComplete:^(NSInteger errCode) {
    // onComplete
}];

// 切换至原唱音乐
[self.audioEffectManager setMusicPlayoutVolume:originMusicId volume:100];
[self.audioEffectManager setMusicPublishVolume:originMusicId volume:100];
[self.audioEffectManager setMusicPlayoutVolume:accompMusicId volume:0];
[self.audioEffectManager setMusicPublishVolume:accompMusicId volume:0];

// 切换至伴奏音乐
[self.audioEffectManager setMusicPlayoutVolume:originMusicId volume:0];
[self.audioEffectManager setMusicPublishVolume:originMusicId volume:0];
[self.audioEffectManager setMusicPlayoutVolume:accompMusicId volume:100];
[self.audioEffectManager setMusicPublishVolume:accompMusicId volume:100];

[self.audioEffectManager startPlayMusic:musicParam onStart:^(NSInteger errCode) {
    // 音乐开始播放
} onProgress:^(NSInteger progressMs, NSInteger durationMs) {
    // 根据最新进度和本地歌词进度误差，判断是否需要 seek
    // 通过发送 SEI 消息传递歌曲进度
    NSDictionary *dic = @{
        @"musicId": @(self.musicId),
        @"progress": @(progressMs),
        @"duration": @(durationMs),
    };
    JSONModel *json = [[JSONModel alloc] initWithDictionary:dic error:nil];
    [self.trtcCloud sendSEIMsg:json.toJSONData repeatCount:1];
} onComplete:^(NSInteger errCode) {
    // 音乐播放完成
}];

// 切换为观众角色
[self.trtcCloud switchRole:TRTCRoleAudience];

// 切换角色事件回调
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(NSString *)errMsg {
    if (errCode == ERR_NULL) {
        // 停止播放伴奏音乐
        [[self.trtcCloud getAudioEffectManager] stopPlayMusic:self.musicId];
        // 停止本地音频的采集和发布
        [self.trtcCloud stopLocalAudio];
    }
}

// 退出房间
[self.trtcCloud exitRoom];

// 退出房间事件回调
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        NSLog(@"主动调用 exitRoom 退出房间");
    } else if (reason == 1) {
        NSLog(@"被服务器踢出当前房间");
    } else if (reason == 2) {
        NSLog(@"当前房间整个被解散");
    }
}

// 进入房间
- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // 以字符串房间号为例
    params.strRoomId = roomId;
    params.userId = userId;
    // 从业务后台获取到的 UserSig
    params.userSig = [self generateUserSig:userId];
    // 替换成您的 SDKAppID
    params.sdkAppId = SDKAppID;
    // 建议均以观众角色进房
    params.role = TRTCRoleAudience;
    // 进房场景须选择 LIVE
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE];
}

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

- (void)onUserVideoAvailable:(NSString *)userId available:(BOOL)available {
    if (available) {
        [self.trtcCloud startRemoteView:userId view:nil];
    } else {
        [self.trtcCloud stopRemoteView:userId];
    }
}

- (void)onRecvSEIMsg:(NSString *)userId message:(NSData *)message {
    JSONModel *json = [[JSONModel alloc] initWithData:message error:nil];
    NSDictionary *dic = json.toDictionary;
    int32_t musicId = [dic[@"musicId"] intValue];
    NSInteger progress = [dic[@"progress"] integerValue];
    NSInteger duration = [dic[@"duration"] integerValue];
    // ......
    // TODO 更新歌词控件逻辑：
    // 根据接收到的最新进度和本地歌词进度误差，判断是否需要 seek 歌词控件
    // ......
}

// 退出房间
[self.trtcCloud exitRoom];

// 退出房间事件回调
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        NSLog(@"主动调用 exitRoom 退出房间");
    } else if (reason == 1) {
        NSLog(@"被服务器踢出当前房间");
    } else if (reason == 2) {
        NSLog(@"当前房间整个被解散");
    }
}

- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    // 创建 TRTCCloud 主实例（人声实例）
    TRTCCloud *mainCloud = [TRTCCloud sharedInstance];
    // 创建 TRTCCloud 子实例（音乐实例）
    TRTCCloud *subCloud = [mainCloud createSubCloud];
    
    // 主实例（人声实例）进房
    TRTCParams *params = [[TRTCParams alloc] init];
    params.strRoomId = roomId;
    params.userId = userId;
    params.userSig = userSig;
    params.sdkAppId = SDKAppID;
    params.role = TRTCRoleAnchor;
    [mainCloud enterRoom:params appScene:TRTCAppSceneLIVE];
    
    // 子实例开启手动订阅模式，默认不订阅远端流
    [subCloud setDefaultStreamRecvMode:NO video:NO];
    // 子实例（音乐实例）进房
    TRTCParams *bgmParams = [[TRTCParams alloc] init];
    bgmParams.strRoomId = roomId;
    // 子实例用户名不能与房间内其他用户重复
    bgmParams.userId = [userId stringByAppendingString:@"_bgm"];
    bgmParams.userSig = userSig;
    bgmParams.sdkAppId = SDKAppID;
    bgmParams.role = TRTCRoleAnchor;
    [subCloud enterRoom:bgmParams appScene:TRTCAppSceneLIVE];
}

// 主实例进房结果事件回调
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // 主实例取消订阅子实例发布的音乐流
        [self.trtcCloud muteRemoteAudio:[self.userId stringByAppendingString:@"_bgm"] mute:YES];
        // 主实例开启补黑帧的实验性接口
        [self.trtcCloud callExperimentalAPI:@"{\\"api\\":\\"enableBlackStream\\",\\"params\\": {\\"enable\\":true}}"];
        // 主实例开启合唱模式的实验性接口
        [self.trtcCloud callExperimentalAPI:@"{\\"api\\":\\"enableChorus\\",\\"params\\":{\\"enable\\":true,\\"audioSource\\":0}}"];
        // 主实例开启低延时模式的实验性接口
        [self.trtcCloud callExperimentalAPI:@"{\\"api\\":\\"setLowLatencyModeEnabled\\",\\"params\\":{\\"enable\\":true}}"];
        // 主实例启用音量大小回调
        TRTCAudioVolumeEvaluateParams *aveParams = [[TRTCAudioVolumeEvaluateParams alloc] init];
        aveParams.interval = 300;
        [self.trtcCloud enableAudioVolumeEvaluation:YES withParams:aveParams];
        // 主实例设置全程媒体音量类型
        [self.trtcCloud setSystemVolumeType:TRTCSystemVolumeTypeMedia];
        // 主实例采集和发布本地音频，同时设置音质
        [self.trtcCloud startLocalAudio:TRTCAudioQualityMusic];
    } else {
        // result 代表进房失败的错误码
        NSLog(@"Enter room failed");
    }
}

// 子实例进房结果事件回调
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // 子实例开启合唱模式的实验性接口
        [self.subCloud callExperimentalAPI:@"{\\"api\\":\\"enableChorus\\",\\"params\\":{\\"enable\\":true,\\"audioSource\\":1}}"];
        // 子实例开启低延时模式的实验性接口
        [self.subCloud callExperimentalAPI:@"{\\"api\\":\\"setLowLatencyModeEnabled\\",\\"params\\":{\\"enable\\":true}}"];
        // 子实例设置全程媒体音量类型
        [self.subCloud setSystemVolumeType:TRTCSystemVolumeTypeMedia];
        // 子实例设置音质
        [self.subCloud setAudioQuality:TRTCAudioQualityMusic];
    } else {
        // result 代表进房失败的错误码
        NSLog(@"Enter room failed");
    }
}

- (void)startPublishMediaToRoomWithRoomId:(NSString *)roomId userId:(NSString *)userId {
    // 创建 TRTCPublishTarget 对象
    TRTCPublishTarget *target = [[TRTCPublishTarget alloc] init];
    // 混流后回推到房间
    target.mode = TRTCPublishMixStreamToRoom;
    TRTCUser *mixStreamIdentity = [[TRTCUser alloc] init];
    mixStreamIdentity.strRoomId = roomId;
    // 混流机器人用户名不能与房间内其他用户重复
    mixStreamIdentity.userId = [userId stringByAppendingString:@"_robot"];
    target.mixStreamIdentity = mixStreamIdentity;
    
    // 设置转码后的音频流的编码参数(可自定义)
    TRTCStreamEncoderParam *encoderParam = [[TRTCStreamEncoderParam alloc] init];
    encoderParam.audioEncodedChannelNum = 2;
    encoderParam.audioEncodedKbps = 64;
    encoderParam.audioEncodedCodecType = 2;
    encoderParam.audioEncodedSampleRate = 48000;
    
    // 设置转码后的视频流的编码参数(混入黑帧必填)
    encoderParam.videoEncodedFPS = 15;
    encoderParam.videoEncodedGOP = 3;
    encoderParam.videoEncodedKbps = 30;
    encoderParam.videoEncodedWidth = 64;
    encoderParam.videoEncodedHeight = 64;
    
    // 设置音频混流参数
    TRTCStreamMixingConfig *mixingConfig = [[TRTCStreamMixingConfig alloc] init];
    // 默认情况下填空值即可，代表会混合房间中的所有音频
    mixingConfig.audioMixUserList = nil;
    
    // 配置视频混流模板(混入黑帧必填)
    TRTCVideoLayout *layout = [[TRTCVideoLayout alloc] init];
    mixingConfig.videoLayoutList = @[layout];
    
    // 开始混流回推
    [self.trtcCloud startPublishMediaStream:target encoderParam:encoderParam mixingConfig:mixingConfig];
}

- (void)updateNetworkTimeExample {
    [TXLiveBase sharedInstance].delegate = self;
    [TXLiveBase updateNetworkTime];
}

- (void)onUpdateNetworkTime:(int)errCode message:(NSString *)errMsg {
    // errCode 0: 校时成功且偏差在30ms以内；1: 校时成功但偏差可能在30ms以上；-1: 校时失败
    if (errCode == 0) {
        // 校时成功，获取 NTP 时间戳
        NSInteger ntpTime = [TXLiveBase getNetworkTimestamp];
    } else {
        NSLog(@"校时失败，可尝试重新校时");
    }
}

- (void)sendChorusSignalExample {
    __weak typeof(self) weakSelf = self;
    NSTimer *timer = [NSTimer timerWithTimeInterval:1.0 repeats:YES block:^(NSTimer * _Nonnull timer) {
        __strong typeof(weakSelf) strongSelf = weakSelf;
        NSDictionary *dic = @{
            @"cmd": @"startChorus",
            // 约定合唱开始时间: 当前 NTP 时间 + 延迟播放时间(例如3秒)
            @"startPlayMusicTS": @([TXLiveBase getNetworkTimestamp] + 3000),
            @"musicId": @(self.musicId),
            @"musicDuration": @([[strongSelf.subCloud getAudioEffectManager] getMusicDurationInMS:strongSelf.originMusicUri]),
        };
        JSONModel *json = [[JSONModel alloc] initWithDictionary:dic error:nil];
        [strongSelf.trtcCloud sendCustomCmdMsg:1 data:json.toJSONData reliable:NO ordered:NO];
    }];
    [[NSRunLoop currentRunLoop] addTimer:timer forMode:NSRunLoopCommonModes];
}