tencent cloud

sudo gem install cocoapods

pod init

platform :ios, '8.0'
    target 'App' do
    
    # TRTC Lite Edition
    # The installation package has the minimum incremental size. But it only supports two features of Real-Time Communication (TRTC) and TXLivePlayer for live streaming playback.
    pod 'TXLiteAVSDK_TRTC', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_TRTC.podspec'
    
    # Pro Edition
    # Includes a wide range of features such as Real-Time Communication (TRTC), TXLivePlayer for live streaming playback, TXLivePusher for RTMP push streams, TXVodPlayer for on-demand playback, and UGSV for short video recording and editing.
    # pod 'TXLiteAVSDK_Professional', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_Professional.podspec'

end

pod install

pod update

// Create TRTC SDK instance (Single Instance Pattern).
self.trtcCloud = [TRTCCloud sharedInstance];
// Set event listeners.
self.trtcCloud.delegate = self;

// Notifications from various SDK events (e.g., error codes, warning codes, audio and video status parameters, etc.).
- (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);
}

// Remove event listener.
self.trtcCloud.delegate = nil;
// Terminate TRTC SDK instance (Singleton Pattern).
[TRTCCloud destroySharedIntance];

- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // Take the room ID string as an example.
    params.strRoomId = roomId;
    params.userId = userId;
    // UserSig obtained from the business backend.
    params.userSig = [self generateUserSig:userId];
    // Replace with your SDKAppID.
    params.sdkAppId = SDKAppID;
    // It is recommended to enter the room as an audience role.
    params.role = TRTCRoleAudience;
    // LIVE should be selected for the room entry scenario.
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE];
}

// Event callback for the result of entering the room.
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result indicates the time taken (in milliseconds) to join the room.
        NSLog(@"Enter room succeed!");
        // Enable the experimental API for black frame insertion.
        [self.trtcCloud callExperimentalAPI:@"{\\"api\\":\\"enableBlackStream\\",\\"params\\": {\\"enable\\":true}}"];
    } else {
        // result indicates the error code when you fail to enter the room.
        NSLog(@"Enter room failed!");
    }
}

// Switched to the anchor role.
[self.trtcCloud switchRole:TRTCRoleAnchor];

// Event callback for switching the role.
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(NSString *)errMsg {
    if (errCode == ERR_NULL) {
        // Set media volume type.
        [self.trtcCloud setSystemVolumeType:TRTCSystemVolumeTypeMedia];
        // Upstream local audio streams and set audio quality.
        [self.trtcCloud startLocalAudio:TRTCAudioQualityMusic];
    }
}

// Obtain audio effects management.
self.audioEffectManager = [self.trtcCloud getAudioEffectManager];

// originMusicId: Custom identifier for the original vocal music. originMusicUrl: URL of the original vocal music resource.
TXAudioMusicParam *originMusicParam = [[TXAudioMusicParam alloc] init];
originMusicParam.ID = originMusicId;
originMusicParam.path = originMusicUrl;
// Whether to publish the original vocal music to remote (otherwise play locally only).
originMusicParam.publish = YES;

// accompMusicId: Custom identifier for the accompaniment music. accompMusicUrl: URL of the accompaniment music resource.
TXAudioMusicParam *accompMusicParam = [[TXAudioMusicParam alloc] init];
accompMusicParam.ID = accompMusicId;
accompMusicParam.path = accompMusicUrl;
// Whether to publish the accompaniment to remote (otherwise play locally only).
accompMusicParam.publish = YES;

// Start playing the original vocal music.
[self.audioEffectManager startPlayMusic:originMusicParam onStart:^(NSInteger errCode) {
    // onStart
} onProgress:^(NSInteger progressMs, NSInteger durationMs) {
    // onProgress
} onComplete:^(NSInteger errCode) {
    // onComplete
}];

// Start playing the accompaniment music.
[self.audioEffectManager startPlayMusic:originMusicParam onStart:^(NSInteger errCode) {
    // onStart
} onProgress:^(NSInteger progressMs, NSInteger durationMs) {
    // onProgress
} onComplete:^(NSInteger errCode) {
    // onComplete
}];

// Switch to the original vocal music.
[self.audioEffectManager setMusicPlayoutVolume:originMusicId volume:100];
[self.audioEffectManager setMusicPublishVolume:originMusicId volume:100];
[self.audioEffectManager setMusicPlayoutVolume:accompMusicId volume:0];
[self.audioEffectManager setMusicPublishVolume:accompMusicId volume:0];

// Switch to the accompaniment music.
[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) {
    // Start playing music.
} onProgress:^(NSInteger progressMs, NSInteger durationMs) {
    // Determine whether seek is needed based on the latest progress and the local lyrics progress deviation.
    // Song progress is transmitted by sending an SEI message.
    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) {
    // Music playback completed.
}];

// Switched to the audience role.
[self.trtcCloud switchRole:TRTCRoleAudience];

// Event callback for switching the role.
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(NSString *)errMsg {
    if (errCode == ERR_NULL) {
        // Stop playing accompaniment music.
        [[self.trtcCloud getAudioEffectManager] stopPlayMusic:self.musicId];
        // Stop local audio capture and publishing.
        [self.trtcCloud stopLocalAudio];
    }
}

// Exit the room.
[self.trtcCloud exitRoom];

// Exit room event callback.
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        NSLog(@"Proactively call exitRoom to exit the room.");
    } else if (reason == 1) {
        NSLog(@"Removed from the current room by the server.");
    } else if (reason == 2) {
        NSLog(@"The current room is dissolved.");
    }
}

// Enter the room.
- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    TRTCParams *params = [[TRTCParams alloc] init];
    // Take the room ID string as an example.
    params.strRoomId = roomId;
    params.userId = userId;
    // UserSig obtained from the business backend.
    params.userSig = [self generateUserSig:userId];
    // Replace with your SDKAppID.
    params.sdkAppId = SDKAppID;
    // It is recommended to enter the room as an audience role.
    params.role = TRTCRoleAudience;
    // LIVE should be selected for the room entry scenario.
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE];
}

// Event callback for the result of entering the room.
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // result indicates the time taken (in milliseconds) to join the room.
        NSLog(@"Enter room succeed!");
    } else {
        // result indicates the error code when you fail to enter the room.
        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: The logic of updating the lyric control.
    // Based on the received latest progress and the local lyrics progress deviation, determine whether a lyric control seek is necessary.
    // ......
}

// Exit the room.
[self.trtcCloud exitRoom];

// Exit room event callback.
- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        NSLog(@"Proactively call exitRoom to exit the room.");
    } else if (reason == 1) {
        NSLog(@"Removed from the current room by the server.");
    } else if (reason == 2) {
        NSLog(@"The current room is dissolved.");
    }
}

- (void)enterRoomWithRoomId:(NSString *)roomId userID:(NSString *)userId {
    // Create a TRTCCloud primary instance (vocal instance).
    TRTCCloud *mainCloud = [TRTCCloud sharedInstance];
    // Create a TRTCCloud sub-instance (music instance).
    TRTCCloud *subCloud = [mainCloud createSubCloud];
    
    // The primary instance (vocal instance) enters the room.
    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];
    
    // The sub-instance enables manual subscription mode. By default it does not subscribe to remote streams.
    [subCloud setDefaultStreamRecvMode:NO video:NO];
    // The sub-instance (music instance) enters the room.
    TRTCParams *bgmParams = [[TRTCParams alloc] init];
    bgmParams.strRoomId = roomId;
    // The sub-instance username must not duplicate with other users in the room.
    bgmParams.userId = [userId stringByAppendingString:@"_bgm"];
    bgmParams.userSig = userSig;
    bgmParams.sdkAppId = SDKAppID;
    bgmParams.role = TRTCRoleAnchor;
    [subCloud enterRoom:bgmParams appScene:TRTCAppSceneLIVE];
}

// Event callback for the result of primary instance entering the room.
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // The primary instance unsubscribe from music streams published by sub-instances.
        [self.trtcCloud muteRemoteAudio:[self.userId stringByAppendingString:@"_bgm"] mute:YES];
        // The primary instance uses the experimental API to enable black frame insertion.
        [self.trtcCloud callExperimentalAPI:@"{\\"api\\":\\"enableBlackStream\\",\\"params\\": {\\"enable\\":true}}"];
        // The primary instance uses the experimental API to enable chorus mode.
        [self.trtcCloud callExperimentalAPI:@"{\\"api\\":\\"enableChorus\\",\\"params\\":{\\"enable\\":true,\\"audioSource\\":0}}"];
        // The primary instance uses the experimental API to enable low-latency mode.
        [self.trtcCloud callExperimentalAPI:@"{\\"api\\":\\"setLowLatencyModeEnabled\\",\\"params\\":{\\"enable\\":true}}"];
        // The primary instance enables volume level callback.
        TRTCAudioVolumeEvaluateParams *aveParams = [[TRTCAudioVolumeEvaluateParams alloc] init];
        aveParams.interval = 300;
        [self.trtcCloud enableAudioVolumeEvaluation:YES withParams:aveParams];
        // The primary instance sets the global media volume type.
        [self.trtcCloud setSystemVolumeType:TRTCSystemVolumeTypeMedia];
        // The primary instance captures and publishes local audio, and sets audio quality.
        [self.trtcCloud startLocalAudio:TRTCAudioQualityMusic];
    } else {
        // result indicates the error code when you fail to enter the room.
        NSLog(@"Enter room failed");
    }
}

// Event callback for the result of sub-instance entering the room.
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // The sub-instance uses the experimental API to enable chorus mode.
        [self.subCloud callExperimentalAPI:@"{\\"api\\":\\"enableChorus\\",\\"params\\":{\\"enable\\":true,\\"audioSource\\":1}}"];
        // The sub-instance uses the experimental API to enable low-latency mode.
        [self.subCloud callExperimentalAPI:@"{\\"api\\":\\"setLowLatencyModeEnabled\\",\\"params\\":{\\"enable\\":true}}"];
        // The sub-instance sets global media volume type.
        [self.subCloud setSystemVolumeType:TRTCSystemVolumeTypeMedia];
        // The sub-instance sets audio quality.
        [self.subCloud setAudioQuality:TRTCAudioQualityMusic];
    } else {
        // result indicates the error code when you fail to enter the room.
        NSLog(@"Enter room failed");
    }
}

- (void)startPublishMediaToRoomWithRoomId:(NSString *)roomId userId:(NSString *)userId {
    // Create TRTCPublishTarget object.
    TRTCPublishTarget *target = [[TRTCPublishTarget alloc] init];
    // After mixing, the stream is relayed back to the room.
    target.mode = TRTCPublishMixStreamToRoom;
    TRTCUser *mixStreamIdentity = [[TRTCUser alloc] init];
    mixStreamIdentity.strRoomId = roomId;
    // The mixing stream robot's username must not duplicate with other users in the room.
    mixStreamIdentity.userId = [userId stringByAppendingString:@"_robot"];
    target.mixStreamIdentity = mixStreamIdentity;
    
    // Set the encoding parameters of the transcoded audio stream (can be customized).
    TRTCStreamEncoderParam *encoderParam = [[TRTCStreamEncoderParam alloc] init];
    encoderParam.audioEncodedChannelNum = 2;
    encoderParam.audioEncodedKbps = 64;
    encoderParam.audioEncodedCodecType = 2;
    encoderParam.audioEncodedSampleRate = 48000;
    
    // Set the encoding parameters of the transcoded video stream (black frame mixing required).
    encoderParam.videoEncodedFPS = 15;
    encoderParam.videoEncodedGOP = 3;
    encoderParam.videoEncodedKbps = 30;
    encoderParam.videoEncodedWidth = 64;
    encoderParam.videoEncodedHeight = 64;
    
    // Set audio mixing parameters.
    TRTCStreamMixingConfig *mixingConfig = [[TRTCStreamMixingConfig alloc] init];
    // By default, leave this field empty. It indicates that all audio in the room will be mixed.
    mixingConfig.audioMixUserList = nil;
    
    // Configure video mixed-stream template (black frame mixing required).
    TRTCVideoLayout *layout = [[TRTCVideoLayout alloc] init];
    mixingConfig.videoLayoutList = @[layout];
    
    // Start mixing and pushing back.
    [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: Time synchronization successful and deviation within 30 ms. 1: Time synchronization successful but deviation possibly above 30 ms. -1: Time synchronization failed.
    if (errCode == 0) {
        // Time synchronization successful and NTP timestamp obtained.
        NSInteger ntpTime = [TXLiveBase getNetworkTimestamp];
    } else {
        NSLog(@"Time synchronization failed, and you can try re-synchronization.");
    }
}

- (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",
            // Agreed chorus start time: Current NTP time + delayed playback time (for example, 3 seconds).
            @"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];
}