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, 同时填入麦克风使用目的提示语
Privacy - Camera 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 实例（单例模式）
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)setupTRTC {
    // 设置视频编码参数，决定远端用户看到的画面质量
    TRTCVideoEncParam *encParam = [[TRTCVideoEncParam alloc] init];
    encParam.videoResolution = TRTCVideoResolution_960_540;
    encParam.videoFps = 15;
    encParam.videoBitrate = 850;
    encParam.resMode = TRTCVideoResolutionModePortrait;
    [self.trtcCloud setVideoEncoderParam:encParam];
 
    // 开启本地摄像头预览(可指定使用前置/后置摄像头进行视频采集)
    [self.trtcCloud startLocalPreview:self.isFrontCamera view:self.previewView];
}

// 构造自定义数据
NSDictionary *dic = @{
    @"cmd": @"av_call",
    @"msg": @{
        // 指定通话类型(视频通话、语音通话)
        @"callType": @"videoCall",
        // 指定 TRTC 房间号(主叫端可随机生成)
        @"roomId": @"xxxRoomId",
    },
};
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:dic
                                                   options:NSJSONWritingPrettyPrinted
                                                     error:nil];
if (jsonData) {
    NSString *jsonString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
    // 发送呼叫邀请信令
    NSString *inviteId = [[V2TIMManager sharedInstance] invite:self.receiverId data:jsonString onlineUserOnly:false offlinePushInfo:self.offlinePushInfo timeout:self.timeout succ:^{
        // 发送呼叫邀请信令成功
        // 渲染呼叫页面，播放呼叫铃声
    } fail:^(int code, NSString *desc) {
        // 发送呼叫邀请信令失败
        // 提示呼叫失败，可以尝试重试
    }];
}

[[V2TIMManager sharedInstance] addSignalingListener:self];

#pragma mark - V2TIMSignalingListener

// 被叫用户收到呼叫请求, inviteID 为该条请求 ID，inviter 为主叫用户 ID
- (void)onReceiveNewInvitation:(NSString *)inviteID inviter:(NSString *)inviter groupID:(NSString *)groupID inviteeList:(NSArray<NSString *> *)inviteeList data:(NSString *)data {
    if (data && ![data isEqualToString:@""]) {
        NSData *jsonData = [data dataUsingEncoding:NSUTF8StringEncoding];
        NSDictionary *dictionary = [NSJSONSerialization JSONObjectWithData:jsonData
                                                                   options:NSJSONReadingMutableContainers
                                                                     error:nil];
        if (dictionary) {
            NSString *command = dictionary[@"cmd"];
            NSDictionary *msg = dictionary[@"msg"];
            if ([command isEqualToString:@"av_call"]) {
                NSString *callType = msg[@"callType"];
                NSString *roomId = msg[@"roomId"];
                
                // 渲染呼叫页面，播放呼叫铃声
            }
        }
    }
}

if ([callType isEqualToString:@"videoCall"]) {
    // 设置视频编码参数，决定远端用户看到的画面质量
    TRTCVideoEncParam *encParam = [[TRTCVideoEncParam alloc] init];
    encParam.videoResolution = TRTCVideoResolution_960_540;
    encParam.videoFps = 15;
    encParam.videoBitrate = 850;
    encParam.resMode = TRTCVideoResolutionModePortrait;
    [self.trtcCloud setVideoEncoderParam:encParam];

    // 开启本地摄像头预览(可指定使用前置/后置摄像头进行视频采集)
    [self.trtcCloud startLocalPreview:self.isFrontCamera view:self.previewView];
}

[[V2TIMManager sharedInstance] cancel:inviteId data:data succ:^{
    // 取消呼叫请求成功
    // 销毁呼叫页面，停止播放呼叫铃声
} fail:^(int code, NSString *desc) {
    // 取消呼叫请求失败
    // 提示取消失败，可以尝试重试
}];

#pragma mark - V2TIMSignalingListener

- (void)onInvitationCancelled:(NSString *)inviteID inviter:(NSString *)inviter data:(NSString *)data {
    // 销毁呼叫页面，停止播放呼叫铃声
}

[[V2TIMManager sharedInstance] accept:inviteId data:data succ:^{
    // 接听成功，渲染通话页面，停止播放呼叫铃声
    if ([callType isEqualToString:@"videoCall"]) {
        // 开始视频通话
        [self startVideoCall];
    } else {
        // 开始语音通话
        [self startAudioCall];
    }
} fail:^(int code, NSString *desc) {
    // 接听失败，提示异常或重试
}];

#pragma mark - V2TIMSignalingListener

- (void)onInviteeAccepted:(NSString *)inviteID invitee:(NSString *)invitee data:(NSString *)data {
    if ([self.callType isEqualToString:@"videoCall"]) {
        // 开始视频通话
        [self startVideoCall];
    } else {
        // 开始语音通话
        [self startAudioCall];
    }
}

- (void)startAudioCall {
    TRTCParams *params = [[TRTCParams alloc] init];
    // TRTC鉴权凭证, 在服务端生成
    params.sdkAppId = SDKAPPID;
    // TRTC应用标识, 在控制台获取
    params.userSig = USERSIG;
    // 以字符串房间号为例
    params.strRoomId = self.roomId;
    // 用户名, 建议和IM保持同步
    params.userId = self.userId;
    
    [self.trtcCloud startLocalAudio:TRTCAudioQualitySpeech];
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneAudioCall];
}

// 标记是否正在通话中
@property (nonatomic, assign) BOOL isOnCalling;

#pragma mark - TRTCCloudDelegate

// 进房结果事件回调
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // 进房成功，标识正在通话中
        self.isOnCalling = YES;
    } else {
        // 进房失败，提示通话异常
        self.isOnCalling = NO;
    }
}

- (void)startVideoCall {
    TRTCParams *params = [[TRTCParams alloc] init];
    // TRTC鉴权凭证, 在服务端生成
    params.sdkAppId = SDKAPPID;
    // TRTC应用标识, 在控制台获取
    params.userSig = USERSIG;
    // 以字符串房间号为例
    params.strRoomId = self.roomId;
    // 用户名, 建议和IM保持同步
    params.userId = self.userId;
    
    [self.trtcCloud startLocalAudio:TRTCAudioQualitySpeech];
    [self.trtcCloud enterRoom:params appScene:TRTCAppSceneVideoCall];
}

// 标记是否正在通话中
@property (nonatomic, assign) BOOL isOnCalling;

#pragma mark - TRTCCloudDelegate

// 进房结果事件回调
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        // 进房成功，标识正在通话中
        self.isOnCalling = YES;
    } else {
        // 进房失败，提示通话异常
        self.isOnCalling = NO;
    }
}

// 拉取远端视频流
- (void)onUserVideoAvailable:(NSString *)userId available:(BOOL)available {
    // 远端用户发布/取消了主路视频画面
    if (available) {
        // 订阅远端用户的视频流，并绑定视频渲染控件
        [self.trtcCloud startRemoteView:userId streamType:TRTCVideoStreamTypeBig view:self.previewView];
    } else {
        // 停止订阅远端用户的视频流，并释放渲染控件
        [self.trtcCloud stopRemoteView:userId streamType:TRTCVideoStreamTypeBig];
    }
}

NSDictionary *dic = @{
    @"cmd": @"av_call",
    @"msg": @{
        // 指定通话类型(视频通话、语音通话)
        @"callType": @"videoCall",
        // 指定拒接类型(主动拒接、忙线拒接)
        @"reason": @"active",
    },
};
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:dic
                                                   options:NSJSONWritingPrettyPrinted
                                                     error:nil];
if (jsonData) {
    NSString *jsonString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
    [[V2TIMManager sharedInstance] reject:self.inviteId data:jsonString succ:^{
        // 拒接成功，销毁呼叫页面，停止播放呼叫铃声
    } fail:^(int code, NSString *desc) {
        // 拒接失败，提示异常或重试
    }];
}

#pragma mark - V2TIMSignalingListener

- (void)onInviteeRejected:(NSString *)inviteID invitee:(NSString *)invitee data:(NSString *)data {
    if (data && ![data isEqualToString:@""]) {
        NSData *jsonData = [data dataUsingEncoding:NSUTF8StringEncoding];
        NSDictionary *dictionary = [NSJSONSerialization JSONObjectWithData:jsonData
                                                                   options:NSJSONReadingMutableContainers
                                                                     error:nil];
        if (dictionary) {
            NSString *command = dictionary[@"cmd"];
            NSDictionary *msg = dictionary[@"msg"];
            if ([command isEqualToString:@"av_call"]) {
                NSString *reason = msg[@"reason"];
                if ([reason isEqualToString:@"active"]) {
                    // 提示对方拒绝接听
                } else if ([reason isEqualToString:@"busy"]) {
                    // 提示对方忙线中
                }
                
                // 销毁呼叫页面，停止播放呼叫铃声
            }
        }
    }
}

- (void)hangup {
    [self.trtcCloud stopLocalAudio];
    [self.trtcCloud stopLocalPreview];
    [self.trtcCloud exitRoom];
}

#pragma mark - TRTCCloudDelegate

- (void)onExitRoom:(NSInteger)reason {
    // 已成功退出房间并挂断通话
    self.isOnCalling = NO;
}

#pragma mark - TRTCCloudDelegate

- (void)onRemoteUserLeaveRoom:(NSString *)userId reason:(NSInteger)reason {
    [self hangup];
}

- (void)onExitRoom:(NSInteger)reason {
    // 已成功退出房间并挂断通话
    self.isOnCalling = NO;
}