TUICalling API（iOS）

TUICalling 是基于腾讯云实时音视频（TRTC）和即时通信 IM 服务组合而成的，支持1v1和多人视频通话。TUICalling 是一个开源的 Class，依赖腾讯云的两个闭源 SDK，具体的实现过程请参见 实时视频通话（iOS）。

• TRTC SDK：使用 TRTC SDK 作为低延时音视频通话组件。
• IM SDK：使用 IM SDK 发送和处理信令消息。

说明：

TUIKit 系列组件同时使用了腾讯云 实时音视频 TRTC 和 即时通信 IM 两个基础 PaaS 服务，开通实时音视频后会同步开通即时通信IM服务。即时通信 IM 服务详细计费规则请参见 即时通信 - 价格说明，TRTC 开通会默认关联开通 IM SDK 的体验版，仅支持100个 DAU。

TUICalling API 概览

SDK 基础函数

TUICallingListener API 概览

事件回调

Type API 概览

通话类型

Role API 概览

用户角色类型

Event API 概览

事件类型

SDK 基础函数

sharedInstance

sharedInstance 是 TUICallingManager 的组件单例。

+ (instancetype)shareInstance;

call

C2C 邀请通话。

- (void)call:(NSArray<NSString *> *)userIDs type:(TUICallingType)type;

参数如下表所示：

setCallingListener

设置监听器。

- (void)setCallingListener:(id<TUICallingListerner>)listener;

参数如下表所示：

setCallingBell

设置铃声（建议在30s以内）。

- (void)setCallingBell:(NSString *)filePath;

参数如下表所示：

enableMuteMode

开启静音模式。

- (void)enableMuteMode:(BOOL)enable;

参数如下表所示：

enableCustomViewRoute

开启自定义视图。
开启后，会在呼叫/被叫开始回调中，接收到 CallingViewController 的实例，由开发者自行决定展示方式。

注意：

必须全屏展示，否则会有展示异常。

- (void)enableCustomViewRoute:(BOOL)enable;

参数如下表所示：

TUICallingListener 回调函数

shouldShowOnCallView

是否同意被叫时请求拉起接听页面。

- (BOOL)shouldShowOnCallView;

参数如下表所示：

onCallStart

呼叫开始回调。主叫、被叫均会触发。

 - (void)callStart:(NSArray<NSString *> *)userIDs type:(TUICallingType)type role:(TUICallingRole)role viewController:(UIViewController * _Nullable)viewController;

参数如下表所示：

onCallEnd

通话结束回调。主叫、被叫均会触发。enableCustomViewRoute 设置为 NO 时，此回调方法不会触发。

 - (void)callEnd:(NSArray<NSString *> *)userIDs type:(TUICallingType)type role:(TUICallingRole)role totalTime:(CGFloat)totalTime;

参数如下表所示：

onCallEvent

通话事件回调。enableCustomViewRoute 设置为 NO 时，此回调方法不会触发。

- (void)onCallEvent:(TUICallingEvent)event type:(TUICallingType)type role:(TUICallingRole)role message:(NSString *)message;

参数如下表所示：