TUIRoomEngine
Copyright (c) 2024 Tencent. All rights reserved.
Module: TUIRoomEngine @ TUIKitEngine
Function: TUIRoomEngine 主功能接口
Version: 3.2
TUIRoomEngine
TUIRoomEngine
函数列表 | 描述 |
获取 TUIRoomEngine 单例实例。 | |
销毁 TUIRoomEngine 单例实例。 | |
登录接口,初始化用户信息后才能进入房间并进行操作。 | |
退出登录接口,释放资源并离开房间。 | |
设置本地用户名称和头像。 | |
获取本地用户登录的基本信息。 | |
设置当前登录用户的详细信息。 | |
设置事件回调。 | |
移除事件回调。 | |
创建房间。 | |
解散房间。 | |
进入房间。 | |
进入房间。 | |
进入房间。 | |
离开房间。 | |
获取当前进入的房间信息。 | |
获取房间信息 | |
更新房间名称(只有管理员或房主能够调用) | |
更新房间麦位模式(只有管理员或房主能够调用) | |
更新房间密码 | |
获取房间自定义信息 | |
设置房间自定义信息,已有该属性则更新其 value 值,没有则添加该属性 | |
设置本地用户视频渲染的视图控件 | |
打开本地摄像头 | |
关闭本地摄像头 | |
开始推送本地视频。默认开启 | |
停止推送本地视频 | |
更新本地视频编码质量设置 | |
设置视频编码器的编码参数 | |
设置视频编码器分辨率模式(横屏分辨率 or 竖屏分辨率) | |
设置本地画面被暂停期间的替代图片 | |
开启重力感应模式 | |
开始屏幕分享(该接口仅支持移动端) | |
开始屏幕分享(该接口仅支持桌面端 Mac OS 系统) | |
结束屏幕分享 | |
枚举可分享的屏幕和窗口(该接口仅支持 Mac OS 系统) | |
选取要分享的屏幕或窗口(该接口仅支持 Mac OS 系统) | |
打开本地麦克风 | |
关闭本地麦克风 | |
更新本地音频编码质量设置 | |
暂停发布本地的音频流 | |
恢复发布本地的音频流 | |
开启系统声音分享 | |
设置远端用户视频渲染的视图控件 | |
开始播放远端用户视频 | |
停止播放远端用户视频 | |
将远端用户静音 | |
获取房间内的成员列表 | |
获取成员信息 | |
搜索成员信息 | |
修改用户角色(只有管理员或房主能够调用) | |
修改用户房间内昵称 | |
将远端用户踢出房间(只有管理员或房主能够调用) | |
为用户增加标记(只有房主能够调用) | |
为用户移除标记(只有房主能够调用) | |
根据标记获取房间内用户信息 | |
设置房间内成员自定义信息 | |
控制当前房间内所有用户是否可打开音频流、视频流采集设备的权限状态,例如:全员禁止打开麦克风、全员禁止打开摄像头(目前仅会议场景下可用,并且只有管理员或房主能够调用) | |
请求远端用户打开媒体设备(只有管理员或房主能够调用,device类型不支持SCREEN_SHARING) | |
关闭远端用户媒体设备(只有管理员或房主能够调用) | |
请求打开本地媒体设备(普通用户可用,device类型不支持SCREEN_SHARING) | |
获取麦位列表 | |
锁定麦位(只有管理员或房主能够调用,包括位置锁定、音频状态锁定和视频状态锁定) | |
上麦(上麦发言模式下,需要申请) | |
下麦 | |
移麦 | |
主持人/管理员 邀请用户上麦 | |
主持人/管理员 将用户踢下麦 | |
主持人/管理员 获取房间内申请上麦用户的请求列表 | |
禁用远端用户的发送文本消息能力(只有管理员或房主能够调用) | |
禁用所有用户的发送文本消息能力(只有管理员或房主能够调用) | |
发送文本消息 | |
发送自定义消息 | |
取消请求 | |
回复请求 | |
获得TRTC实例对象 | |
设置美颜级别 | |
设置美白级别 | |
获取插件 | |
获取设备管理类 | |
获取连线管理类 | |
获取 Battle 管理类 | |
调用实验性接口 |
sharedInstance
sharedInstance
获取 TUIRoomEngine 单例实例。
功能描述:
创建并返回 TUIRoomEngine 的全局共享实例(单例模式)。
适用于会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
使用单例模式可避免重复创建引擎实例,节省资源。
返回值说明:
返回 TUIRoomEngine 的单例实例。
使用示例:
// Objective-C调用示例TUIRoomEngine *engine = [TUIRoomEngine sharedInstance];// Swift调用示例let engine = TUIRoomEngine.sharedInstance()
注意
多次调用会返回同一个实例。
destroySharedInstance
destroySharedInstance
销毁 TUIRoomEngine 单例实例。
功能描述:
销毁 TUIRoomEngine 的全局共享实例。
释放引擎占用的所有资源。
调用后如需再次使用需要重新获取 sharedInstance。
使用示例:
// Objective-C调用示例[TUIRoomEngine destroySharedInstance];// Swift调用示例TUIRoomEngine.destroySharedInstance()
注意
为了避免销毁单例对象后引发未知异常,此接口不建议在程序运行期间调用。
调用此方法前请确保已退出所有房间。
调用此方法后所有引擎功能将不可用。
适用于会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
loginWithSDKAppId:userId:userSig:onSuccess:onError:
loginWithSDKAppId:userId:userSig:onSuccess:onError:
+ (void)loginWithSDKAppId: | (NSInteger)sdkAppId |
userId: | (NSString *)userId |
userSig: | (NSString *)userSig |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
登录接口,初始化用户信息后才能进入房间并进行操作。
功能描述:
初始化用户信息,建立与腾讯云实时音视频服务的连接。
适用于会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
若用户在线时被踢下线,SDK会通过 TUIRoomObserver 中的 onKickedOffLine 回调通知。
使用示例:
// Objective-C调用示例[TUIRoomEngine loginWithSDKAppId:1400000001userId:@"user123"userSig:@"xxxxxx"onSuccess:^{// 登录成功处理}onError:^(int code, NSString *message) {// 登录失败处理}];// Swift调用示例TUIRoomEngine.login(sdkAppId: 1400000001,userId: "user123",userSig: "xxxxxx",onSuccess: {// 登录成功处理},onError: { code, message in// 登录失败处理})
参数说明:
参数 | 描述 |
onError | 登录失败的回调。 |
onSuccess | 登录成功的回调。 |
sdkAppId | 它是腾讯云用于区分客户的唯一标识,进入腾讯云实时音视频 控制台创建应用,即可看到 SDKAppId。 |
userId | 用户唯一标识,用于区分不同用户。 |
userSig | 用户签名,用于腾讯云流量的认证。 |
注意
必须先调用此接口登录成功后才能进行其他操作。
同一个 SDKAppId 下的 userId 必须唯一。
userSig 需要由您的业务服务器生成。
logout:onError:
logout:onError:
+ (void)logout: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
退出登录接口,释放资源并离开房间。
功能描述:
主动退出当前登录状态。
释放引擎占用的所有资源。
如果当前在房间内,会自动执行离开房间操作。
调用后如需再次使用需要重新调用 login 接口。
使用示例:
// Objective-C调用示例[TUIRoomEngine logout:^{// 退出成功处理} onError:^(int code, NSString *message) {// 退出失败处理}];// Swift调用示例TUIRoomEngine.logout {// 退出成功处理} onError: { code, message in// 退出失败处理}
参数说明:
参数 | 描述 |
onError | 退出失败的回调,包含错误码和错误信息。 |
onSuccess | 退出成功的回调。 |
注意
调用此方法前请确保已完成所有必要的清理工作。
调用此方法后所有引擎功能将不可用。
适用于会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
如果网络异常导致退出失败,建议重试或提示用户检查网络。
setSelfInfoWithUserName:avatarUrl:onSuccess:onError:
setSelfInfoWithUserName:avatarUrl:onSuccess:onError:
+ (void)setSelfInfoWithUserName: | (NSString *)userName |
avatarUrl: | (NSString *)avatarURL |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
设置本地用户名称和头像。
功能描述:
设置本地用户的昵称和头像 URL。
修改后的信息会同步到房间内其他用户。
适用于会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
使用示例:
// Objective-C调用示例[TUIRoomEngine setSelfInfoWithUserName:@"John"avatarUrl:@"https://avatar.url"onSuccess:^{// 设置成功处理}onError:^(int code, NSString *message) {// 设置失败处理}];// Swift调用示例TUIRoomEngine.setSelfInfo(userName: "John",avatarUrl: "https://avatar.url",onSuccess: {// 设置成功处理},onError: { code, message in// 设置失败处理})
参数说明:
参数 | 描述 |
avatarURL | 用户头像 URL 地址。 |
onError | 设置失败的回调,包含错误码和错误信息。 |
onSuccess | 设置成功的回调。 |
userName | 用户昵称。 |
注意
头像 URL 需要是可访问的有效地址。
昵称和头像修改后会延迟至少10分钟同步到房间内其他用户。
getSelfInfo
getSelfInfo
获取本地用户登录的基本信息。
功能描述:
获取当前登录用户的详细信息。
包含用户 ID 、昵称、头像 URL 等基本信息。
适用于会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
返回值说明:
返回TUILoginUserInfo对象(TUILoginUserInfo)。
使用示例:
// Objective-C调用示例TUILoginUserInfo *userInfo = [TUIRoomEngine getSelfInfo];// Swift调用示例let userInfo = TUIRoomEngine.getSelfInfo()
注意
必须在登录成功后调用, 返回的是本地缓存的用户信息。
setSelfInfo:onSuccess:onError:
setSelfInfo:onSuccess:onError:
+ (void)setSelfInfo: | |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
设置当前登录用户的详细信息。
功能描述:
设置当前登录用户的基本信息,包括用户 ID 、昵称、头像 URL 等。
修改后的信息会同步到房间内其他用户。
支持会议房间类型和直播房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
使用示例:
// Objective-C调用示例TUILoginUserInfo *userInfo = [[TUILoginUserInfo alloc] init];userInfo.userId = @"user123";userInfo.userName = @"John";userInfo.avatarUrl = @"https://avatar.url";[TUIRoomEngine setSelfInfo:userInfoonSuccess:^{// 设置成功处理}onError:^(int code, NSString *message) {// 设置失败处理}];// Swift调用示例let userInfo = TUILoginUserInfo()userInfo.userId = "user123"userInfo.userName = "John"userInfo.avatarUrl = "https://avatar.url"TUIRoomEngine.setSelfInfo(userInfo: userInfo,onSuccess: {// 设置成功处理},onError: { code, message in// 设置失败处理})
参数说明:
参数 | 描述 |
callback | 调用接口的回调,用于通知接口调用的成功或者失败。 |
userInfo |
注意
必须在登录成功后调用。
头像URL需要是可访问的有效地址。
昵称和头像修改后会延迟至少10分钟同步到房间内其他用户。
addObserver:
addObserver:
- (void)addObserver: |
设置事件回调。
功能描述:
注册一个观察者对象以接收房间内的各种事件通知。
支持会议房间类型和直播房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
通过 TUIRoomObserver 获得各类事件通知(例如:错误码,远端用户进房,音视频状态参数等)。
使用示例:
// Objective-C调用示例TUIRoomEngine *engine = [TUIRoomEngine sharedInstance];[engine addObserver:self];// Swift调用示例let engine = TUIRoomEngine.sharedInstance()engine.addObserver(self)
参数说明:
参数 | 描述 |
observer | 遵循TUIRoomObserver协议的对象实例。 |
注意
必须在进入房间前调用。
添加的 observer 对象需要自行管理生命周期。
避免重复添加同一个 observer 。
退出房间后不会自动移除 observer ,需手动调用 removeObserver 。
removeObserver:
removeObserver:
- (void)removeObserver: |
移除事件回调。
功能描述:
注销之前注册的观察者对象,停止接收房间内的各种事件通知。
支持会议房间类型和直播房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
使用示例:
// Objective-C调用示例TUIRoomEngine *engine = [TUIRoomEngine sharedInstance];[engine removeObserver:self];// Swift调用示例let engine = TUIRoomEngine.sharedInstance()engine.removeObserver(self)
参数说明:
参数 | 描述 |
observer | 待移除的监听回调实例。 |
注意
移除不存在的 observer 可能会产生错误。
建议在观察者对象销毁前调用此方法。
createRoom:onSuccess:onError:
createRoom:onSuccess:onError:
- (void)createRoom: | |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
创建房间。
功能描述:
创建一个新的房间,支持会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
房间创建者自动成为房主。
需要提供房间信息参数来初始化房间设置。
使用示例:
// Objective-C调用示例TUIRoomInfo *roomInfo = [[TUIRoomInfo alloc] init];roomInfo.roomId = @"room123";roomInfo.roomType = TUIRoomTypeConference;roomInfo.name = @"Conference Room";[[TUIRoomEngine sharedInstance] createRoom:roomInfoonSuccess:^{NSLog(@"创建房间成功");}onError:^(TUIError code, NSString * _Nonnull message) {NSLog(@"创建房间失败: %@", message);}];// Swift调用示例let roomInfo = TUIRoomInfo()roomInfo.roomId = "room123"roomInfo.roomType = .conferenceroomInfo.name = "Conference Room"TUIRoomEngine.sharedInstance().createRoom(roomInfo, onSuccess: {print("创建房间成功")}, onError: { code, message inprint("创建房间失败: \(message)")})
参数说明:
参数 | 描述 |
callback | (Android/Win) 调用接口的回调,用于通知接口调用的成功或者失败, 失败回调会包含错误码和错误信息。 |
onError | (iOS) 失败回调(包含错误码和错误信息)。 |
onSuccess | (iOS) 成功回调。 |
roomInfo | 房间信息,可以初始化房间的一些设置。 |
注意
创建房间前需要先调用 login 方法登录。
创建不同类型的房间,会议类型 TUIRoomTypeConference / 直播类型 TUIRoomTypeLive 会影响后续的功能使用。
房间创建成功后,创建者自动成为房主。
同一用户在同一时间只能创建一个房间。
destroyRoom:onError:
destroyRoom:onError:
- (void)destroyRoom: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
解散房间。
功能描述:
解散当前所在的房间。
房间解散后,所有成员将被强制退出。
支持会议房间类型和直播房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
使用示例:
// Objective-C调用示例[[TUIRoomEngine sharedInstance] destroyRoom:^{NSLog(@"解散房间成功");} onError:^(TUIError code, NSString * _Nonnull message) {NSLog(@"解散房间失败: %@", message);}];// Swift调用示例TUIRoomEngine.sharedInstance().destroyRoom {print("解散房间成功")} onError: { code, message inprint("解散房间失败: \(message)")}
参数说明:
参数 | 描述 |
callback | (Android/Win) 调用接口的回调,用于通知接口调用的成功或者失败,失败回调会包含错误码和错误信息。 |
onError | (iOS) 失败回调(包含错误码和错误信息)。 |
onSuccess | (iOS) 成功回调。 |
注意
只有房主可以调用此接口。
房间解散后,SDK 会通过 TUIRoomObserver 中的 onRoomDismissed 回调通知房间内用户。
调用此接口前请确保已处理完所有房间内事务。
解散房间后无法恢复,如需继续使用需要重新创建房间。
enterRoom:onSuccess:onError:
enterRoom:onSuccess:onError:
- (void)enterRoom: | (NSString *)roomId |
onSuccess: | (TUIRoomInfoBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
进入房间。
功能描述:
此接口后期版本会将会废弃, 不建议使用。
进入房间建议使用
2.4 enterRoom(String roomId, TUIRoomDefine.RoomType roomType
或者 2.5 enterRoom(String roomId, TUIRoomDefine.RoomType roomType, TUIRoomDefine.EnterRoomOptions
接口。使用示例:
// Objective-C调用示例[[TUIRoomEngine sharedInstance] enterRoom:@"roomId123" onSuccess:^(TUIRoomInfo * _Nullable roomInfo) {NSLog(@"进入房间成功");} onError:^(TUIError code, NSString * _Nonnull message) {NSLog(@"进入房间失败: %@", message);}];// Swift调用示例TUIRoomEngine.sharedInstance().enterRoom("roomId123") { roomInfo inprint("进入房间成功")} onError: { code, message inprint("进入房间失败: \(message)")}
参数说明:
参数 | 描述 |
callback | (Android/Win) 调用接口的回调,用于通知接口调用的成功或者失败,失败回调会包含错误码和错误信息。 |
onError | (iOS) 失败回调(包含错误码和错误信息)。 |
onSuccess | (iOS) 成功回调。 |
roomId | 房间 ID。 |
注意
单设备允许同时进入的房间数限制 1 个,超过限制后,会退出最早加入的房间。
同账号多设备登录,只允许一个设备进入相同 ID 的会议房间,其他设备进入时,会踢掉较早进入的设备。
进入房间后,SDK 会通过 TUIRoomObserver 中的 onRemoteUserEnterRoom 回调通知房间内用户。
enterRoom:roomType:onSuccess:onError:
enterRoom:roomType:onSuccess:onError:
- (void)enterRoom: | (NSString *)roomId |
roomType: | |
onSuccess: | (TUIRoomInfoBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
进入房间。
功能描述:
进入指定的房间,支持会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
使用示例:
// Objective-C调用示例[[TUIRoomEngine sharedInstance] enterRoom:@"roomId123"roomType:TUIRoomTypeConferenceonSuccess:^(TUIRoomInfo * _Nullable roomInfo) {NSLog(@"进入房间成功");} onError:^(TUIError code, NSString * _Nonnull message) {NSLog(@"进入房间失败: %@", message);}];// Swift调用示例TUIRoomEngine.sharedInstance().enterRoom("roomId123", roomType: .conference) { roomInfo inprint("进入房间成功")} onError: { code, message inprint("进入房间失败: \(message)")}
参数说明:
参数 | 描述 |
callback | (Android/Win) 调用接口的回调,用于通知接口调用的成功或者失败,失败回调会包含错误码和错误信息。 |
onError | (iOS) 操作失败回调(包含错误码和错误信息)。 |
onSuccess | (iOS) 成功回调。 |
roomId | 房间ID,需要保证唯一性。 |
roomType | 房间类型(会议/直播)。 |
注意
单设备允许同时进入的房间数限制, 会议类型 TUIRoomTypeConference :1个,直播类型 TUIRoomTypeLive :live: 3个。超过限制后,会退出最早加入的房间。
同账号多设备登录,只允许一个设备进入相同 ID 的会议房间,其他设备进入时,会踢掉较早进入的设备。
进入房间之后,SDK 会通过 TUIRoomObserver 中的 onRemoteUserEnterRoom 回调通知房间内用户。
enterRoom:roomType:options:onSuccess:onError:
enterRoom:roomType:options:onSuccess:onError:
- (void)enterRoom: | (NSString *)roomId |
roomType: | |
options: | |
onSuccess: | (TUIRoomInfoBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
进入房间。
功能描述:
进入指定的房间,支持会议和直播两种房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
支持通过
options
传入更多进房参数,例如房间密码等。使用示例:
// Objective-C调用示例TUIEnterRoomOptions *options = [[TUIEnterRoomOptions alloc] init];options.password = @"***";[[TUIRoomEngine sharedInstance] enterRoom:@"roomId123"roomType:TUIRoomTypeConferenceoptions:optionsonSuccess:^(TUIRoomInfo * _Nullable roomInfo) {NSLog(@"进入房间成功");} onError:^(TUIError code, NSString * _Nonnull message) {NSLog(@"进入房间失败: %@", message);}];// Swift调用示例let options = TUIEnterRoomOptions()options.password = "***"TUIRoomEngine.sharedInstance().enterRoom("roomId123",roomType: .conference,options: options) { roomInfo inprint("进入房间成功")} onError: { code, message inprint("进入房间失败: \(message)")}
参数说明:
参数 | 描述 |
callback | (Android/Win) 调用接口的回调,用于通知接口调用的成功或者失败,失败回调会包含错误码和错误信息。 |
onError | (iOS) 失败回调(包含错误码和错误信息)。 |
onSuccess | (iOS) 成功回调。 |
options | |
roomId | 房间 ID。 |
roomType | 房间类型。 |
注意
单设备允许同时进入的房间数限制, 会议类型 TUIRoomTypeConference :1个,直播类型 TUIRoomTypeLive :live: 3个。超过限制后,会退出最早加入的房间。
同账号多设备登录,只允许一个设备进入相同 ID 的会议房间,其他设备进入时,会踢掉较早进入的设备。
进入房间之后,SDK 会通过 TUIRoomObserver 中的 onRemoteUserEnterRoom 回调通知房间内用户。
exitRoom:onSuccess:onError:
exitRoom:onSuccess:onError:
- (void)exitRoom: | (BOOL)syncWaiting |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
离开房间。
功能描述:
退出当前所在的房间。
此函数支持会议房间类型和直播房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
退出后会自动停止所有音视频流推送。
使用示例:
// Objective-C调用示例[[TUIRoomEngine sharedInstance] exitRoom:YES onSuccess:^{NSLog(@"退出房间成功");} onError:^(TUIError code, NSString * _Nonnull message) {NSLog(@"退出房间失败: %@", message);}];// Swift调用示例TUIRoomEngine.sharedInstance().exitRoom(syncWaiting: true) {print("退出房间成功")} onError: { code, message inprint("退出房间失败: \(message)")}
参数说明:
参数 | 描述 |
callback | (Android/Win) 调用接口的回调,用于通知接口调用的成功或者失败,失败回调会包含错误码和错误信息。 |
onError | (iOS) 失败回调(包含错误码和错误信息)。 |
onSuccess | (iOS) 成功回调。 |
syncWaiting | 是否同步等待接口返回。 |
注意
离开房间之后,SDK 会通过 TUIRoomObserver 中的 onRemoteUserLeaveRoom 回调通知房间内用户。
fetchRoomInfo:onError:
fetchRoomInfo:onError:
- (void)fetchRoomInfo: | (TUIRoomInfoBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
获取当前进入的房间信息。
功能描述:
获取当前所在房间的详细信息,包括房间 ID、房间名称、房间类型等。
此函数支持会议房间类型和直播房间类型(TUIRoomTypeConference & TUIRoomTypeLive)。
使用示例:
// Objective-C调用示例[[TUIRoomEngine sharedInstance] fetchRoomInfo:^(TUIRoomInfo * _Nullable roomInfo) {NSLog(@"获取房间信息成功: %@", roomInfo);} onError:^(TUIError code, NSString * _Nonnull message) {NSLog(@"获取房间信息失败: %@", message);}];// Swift调用示例TUIRoomEngine.sharedInstance().fetchRoomInfo { roomInfo inprint("获取房间信息成功: \(roomInfo)")} onError: { code, message inprint("获取房间信息失败: \(message)")}
参数说明:
参数 | 描述 |
callback | (Android/Win) 调用接口的回调,用于通知接口调用的成功或者失败,若成功则会返回包含 $TUIRoomInfo 房间信息,若失败则会包含错误码和错误信息。 |
onError | (iOS) 失败回调(包含错误码和错误信息)。 |
onSuccess | (iOS) 成功获取到房间信息回调,回调会包含 $TUIRoomInfo 房间信息。 |
注意
必须在进入房间后调用。
返回的房间信息包含房间的基本配置和当前状态。
如果当前未进入任何房间会返回错误。
fetchRoomInfo:roomType:onSuccess:onError:
fetchRoomInfo:roomType:onSuccess:onError:
- (void)fetchRoomInfo: | (NSString*)roomId |
roomType: | |
onSuccess: | (TUIRoomInfoBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
获取房间信息
参数 | 描述 |
roomId | 房间Id。 |
roomType |
注意
返回值说明:
成功获取到房间信息回调,回调会包含 $TUIRoomInfo 房间信息。
updateRoomNameByAdmin:onSuccess:onError:
updateRoomNameByAdmin:onSuccess:onError:
- (void)updateRoomNameByAdmin: | (NSString *)roomName |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
更新房间名称(只有管理员或房主能够调用)
参数 | 描述 |
roomName | 房间名称。 |
注意
updateRoomSeatModeByAdmin:onSuccess:onError:
updateRoomSeatModeByAdmin:onSuccess:onError:
- (void)updateRoomSeatModeByAdmin: | |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
更新房间麦位模式(只有管理员或房主能够调用)
参数 | 描述 |
seatMode |
注意
updateRoomPasswordByAdmin:onSuccess:onError:
updateRoomPasswordByAdmin:onSuccess:onError:
- (void)updateRoomPasswordByAdmin: | (NSString *)password |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
getRoomMetadata:onSuccess:onError:
getRoomMetadata:onSuccess:onError:
- (void)getRoomMetadata: | (NSArray<NSString *> *)keys |
onSuccess: | (TUIRoomMetadataResponseBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
setRoomMetadataByAdmin
setRoomMetadataByAdmin
setLocalVideoView:
setLocalVideoView:
- (void)setLocalVideoView: | (TUIVideoView *__nullable)view |
openLocalCamera:quality:onSuccess:onError:
openLocalCamera:quality:onSuccess:onError:
- (void)openLocalCamera: | (BOOL)isFront |
quality: | |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
打开本地摄像头
参数 | 描述 |
isFront | YES: 前置 NO: 后置。 |
onError | 失败回调。 |
onSuccess | 成功回调。 |
注意
closeLocalCamera
closeLocalCamera
关闭本地摄像头
注意
startPushLocalVideo
startPushLocalVideo
开始推送本地视频。默认开启
注意
stopPushLocalVideo
stopPushLocalVideo
停止推送本地视频
注意
updateVideoQuality:
updateVideoQuality:
- (void)updateVideoQuality: |
更新本地视频编码质量设置
注意
updateVideoQualityEx:params:
updateVideoQualityEx:params:
- (void)updateVideoQualityEx: | |
params: |
设置视频编码器的编码参数
参数 | 描述 |
params | |
streamType |
注意
setVideoResolutionMode:resolutionMode:
setVideoResolutionMode:resolutionMode:
- (void)setVideoResolutionMode: | |
resolutionMode: |
设置视频编码器分辨率模式(横屏分辨率 or 竖屏分辨率)
参数 | 描述 |
resolutionMode | |
streamType |
注意
setLocalVideoMuteImage:
setLocalVideoMuteImage:
- (void)setLocalVideoMuteImage: | (nullable TUIImage *)image |
设置本地画面被暂停期间的替代图片
参数 | 描述 |
image | 替代图片。 |
注意
仅在调用 stopPushLocalVideo 后支持设置垫片资源进行推流,调用 closeLocalCamera 后不支持设置垫片资源。
enableGravitySensor:
enableGravitySensor:
- (void)enableGravitySensor: | (BOOL)enable |
开启重力感应模式
参数 | 描述 |
enable | YES: 开启 NO: 关闭 |
注意
开启该模式后,当前用户发布出去的视频画面会跟随设备的重力感应方向进行相应的调整,同时本地预览画面保持方向不变。
startScreenCaptureByReplaykit:
startScreenCaptureByReplaykit:
- (void)startScreenCaptureByReplaykit: | (NSString *)appGroup |
开始屏幕分享(该接口仅支持移动端)
注意
startScreenCapture:onSuccess:onError:
startScreenCapture:onSuccess:onError:
- (void)startScreenCapture: | (TUIVideoView *)view |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
开始屏幕分享(该接口仅支持桌面端 Mac OS 系统)
参数 | 描述 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
view | 渲染控件所在的父控件,可以设置为空值,表示不显示屏幕分享的预览效果。 |
注意
该接口可以抓取整个 Mac OS 系统的屏幕内容,或抓取您指定的某个应用的窗口内容,并将其分享给同房间中的其他用户。
stopScreenCapture
stopScreenCapture
结束屏幕分享
注意
结束屏幕共享之后,SDK会通过 TUIRoomObserver 中的 onUserVideoStateChanged 回调通知房间内用户,同时也会通过 onUserScreenCaptureStopped 回调通知您。
getScreenCaptureSources
getScreenCaptureSources
枚举可分享的屏幕和窗口(该接口仅支持 Mac OS 系统)
注意
当您在对接桌面端系统的屏幕分享功能时,一般都需要展示一个选择分享目标的界面,这样用户能够使用这个界面选择是分享整个屏幕还是某个窗口通过本接口,您就可以查询到当前系统中可用于分享的窗口的 ID、名称以及缩略图。
返回值说明:
窗口列表包括屏幕。
selectScreenCaptureTarget:
selectScreenCaptureTarget:
- (void)selectScreenCaptureTarget: | (NSString *)targetId |
选取要分享的屏幕或窗口(该接口仅支持 Mac OS 系统)
参数 | 描述 |
targetId | 指定分享源 |
注意
当您通过 getScreenCaptureSources 获取到可以分享的屏幕和窗口之后,您可以调用该接口选定期望分享的目标屏幕或目标窗口。
在屏幕分享的过程中,您也可以随时调用该接口以切换分享目标。
openLocalMicrophone:onSuccess:onError:
openLocalMicrophone:onSuccess:onError:
- (void)openLocalMicrophone: | |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
打开本地麦克风
参数 | 描述 |
onError | 失败回调。 |
onSuccess | 成功回调。 |
quality | 音频质量。 |
注意
closeLocalMicrophone
closeLocalMicrophone
关闭本地麦克风
注意
updateAudioQuality:
updateAudioQuality:
- (void)updateAudioQuality: |
更新本地音频编码质量设置
注意
muteLocalAudio
muteLocalAudio
暂停发布本地的音频流
注意
unmuteLocalAudio:onError:
unmuteLocalAudio:onError:
- (void)unmuteLocalAudio: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
恢复发布本地的音频流
参数 | 描述 |
onError | 失败回调。 |
onSuccess | 成功回调。 |
注意
enableSystemAudioSharing:
enableSystemAudioSharing:
- (void)enableSystemAudioSharing: | (BOOL)enable |
开启系统声音分享
该接口会采集您设备的音频数据,并将其混入到 SDK 当前的音频数据流中,从而使房间中的其他用户也能听到主播的电脑所播放出的声音。
注意
Android 平台下:您需要先使用该接口来开启系统声音采集,当使用屏幕分享接口开启屏幕分享时才会真正生效。
setRemoteVideoView:streamType:view:
setRemoteVideoView:streamType:view:
- (void)setRemoteVideoView: | (NSString *)userId |
streamType: | |
view: | (TUIVideoView *__nullable)view |
设置远端用户视频渲染的视图控件
参数 | 描述 |
streamType | |
userId | 远端用户ID。 |
view | 视频渲染视图。 |
注意
startPlayRemoteVideo:streamType:onPlaying:onLoading:onError:
startPlayRemoteVideo:streamType:onPlaying:onLoading:onError:
- (void)startPlayRemoteVideo: | (NSString *)userId |
streamType: | |
onPlaying: | (TUIPlayOnPlayingBlock)onPlaying |
onLoading: | (TUIPlayOnLoadingBlock)onLoading |
onError: | (TUIPlayOnErrorBlock)onError |
开始播放远端用户视频
参数 | 描述 |
onError | 错误回调。 |
onLoading | 加载回调。 |
onPlaying | 播放回调。 |
streamType | |
userId | 用户ID。 |
注意
stopPlayRemoteVideo:streamType:
stopPlayRemoteVideo:streamType:
- (void)stopPlayRemoteVideo: | (NSString *)userId |
streamType: |
停止播放远端用户视频
参数 | 描述 |
streamType | |
userId | 用户ID。 |
注意
muteRemoteAudioStream:isMute:
muteRemoteAudioStream:isMute:
- (void)muteRemoteAudioStream: | (NSString *)userId |
isMute: | (BOOL)isMute |
getUserList:onSuccess:onError:
getUserList:onSuccess:onError:
- (void)getUserList: | (NSInteger)nextSequence |
onSuccess: | (TUIUserListResponseBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
获取房间内的成员列表
参数 | 描述 |
nextSequence | 分页拉取标志,第一次拉取填0,回调成功 如果callback返回的数据中 nextSequence 不为零,需要分页,传入再次拉取,直至为0。 |
onError | 错误回调。 |
onSuccess |
注意
getUserInfo:onSuccess:onError:
getUserInfo:onSuccess:onError:
- (void)getUserInfo: | (NSString *)userId |
onSuccess: | (TUIUserInfoBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
获取成员信息
参数 | 描述 |
onError | 错误回调。 |
onSuccess | |
userId | 用户ID。 |
注意
searchUsers:onSuccess:onError:
searchUsers:onSuccess:onError:
- (void)searchUsers: | |
onSuccess: | (TUIUserSearchResponseBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
changeUserRole:role:onSuccess:onError:
changeUserRole:role:onSuccess:onError:
- (void)changeUserRole: | (NSString *)userId |
role: | |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
修改用户角色(只有管理员或房主能够调用)
参数 | 描述 |
role | |
userId | 用户ID。 |
注意
changeUserNameCard:nameCard:onSuccess:onError:
changeUserNameCard:nameCard:onSuccess:onError:
- (void)changeUserNameCard: | (NSString *)userId |
nameCard: | (NSString *)nameCard |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
修改用户房间内昵称
参数 | 描述 |
nameCard | 房间内用户昵称,最大支持32个字节。。 |
userId | 要修改的用户ID。 |
注意
kickRemoteUserOutOfRoom:onSuccess:onError:
kickRemoteUserOutOfRoom:onSuccess:onError:
- (void)kickRemoteUserOutOfRoom: | (NSString *)userId |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
将远端用户踢出房间(只有管理员或房主能够调用)
参数 | 描述 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
userId | 用户ID。 |
注意
将远端用户踢出房间后,SDK会通过 TUIRoomObserver 中的 onKickedOutOfRoom 回调通知被踢出用户,同时会通过 onRemoteUserLeaveRoom 通知房间内用户。
addCategoryTagForUsers:userList:onSuccess:onError:
addCategoryTagForUsers:userList:onSuccess:onError:
- (void)addCategoryTagForUsers: | (NSInteger)tag |
userList: | (NSArray<NSString *> *)userList |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
为用户增加标记(只有房主能够调用)
参数 | 描述 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
tag | 标记类型。数字类型,大于等于 1000,您可以自定义。 |
userList | 用户列表。 |
注意
removeCategoryTagForUsers:userList:onSuccess:onError:
removeCategoryTagForUsers:userList:onSuccess:onError:
- (void)removeCategoryTagForUsers: | (NSInteger)tag |
userList: | (NSArray<NSString *> *)userList |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
为用户移除标记(只有房主能够调用)
参数 | 描述 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
tag | 标记类型。数字类型,大于等于 1000,您可以自定义。 |
userList | 用户列表。 |
注意
getUserListByTag:nextSequence:onSuccess:onError:
getUserListByTag:nextSequence:onSuccess:onError:
- (void)getUserListByTag: | (NSInteger)tag |
nextSequence: | (NSInteger)nextSequence |
onSuccess: | (TUIUserListResponseBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
根据标记获取房间内用户信息
参数 | 描述 |
nextSequence | 分页拉取标志,第一次拉取填0,回调成功 如果callback返回的数据中 nextSequence 不为零,需要分页,传入再次拉取,直至为0。 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
tag | 标记类型。数字类型,大于等于 1000,您可以自定义。 |
注意
setCustomInfoForUser:onSuccess:onError:
setCustomInfoForUser:onSuccess:onError:
- (void)setCustomInfoForUser: | (NSString *)userId |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
disableDeviceForAllUserByAdmin:isDisable:onSuccess:onError:
disableDeviceForAllUserByAdmin:isDisable:onSuccess:onError:
- (void)disableDeviceForAllUserByAdmin: | |
isDisable: | (BOOL)isDisable |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
控制当前房间内所有用户是否可打开音频流、视频流采集设备的权限状态,例如:全员禁止打开麦克风、全员禁止打开摄像头(目前仅会议场景下可用,并且只有管理员或房主能够调用)
参数 | 描述 |
device | |
isDisable | 是否禁用 。 |
onError | 操作失败回调。 |
onSuccess | 操作成功回调。 |
注意
接口调用成功后:
若device类型为 SCREEN_SHARING ,SDK会通过 TUIRoomObserver 中的 onScreenShareForAllUserDisableChanged 通知房间内用户。
openRemoteDeviceByAdmin:device:timeout:onAccepted:onRejected:onCancelled:onTimeout:onError:
openRemoteDeviceByAdmin:device:timeout:onAccepted:onRejected:onCancelled:onTimeout:onError:
- (TUIRequest *)openRemoteDeviceByAdmin: | (NSString *)userId |
device: | |
timeout: | (NSTimeInterval)timeout |
onAccepted: | (nullable TUIRequestAcceptedBlock)onAccepted |
onRejected: | (nullable TUIRequestRejectedBlock)onRejected |
onCancelled: | (nullable TUIRequestCancelledBlock)onCancelled |
onTimeout: | (nullable TUIRequestTimeoutBlock)onTimeout |
onError: | (nullable TUIRequestErrorBlock)onError |
请求远端用户打开媒体设备(只有管理员或房主能够调用,device类型不支持SCREEN_SHARING)
参数 | 描述 |
device | |
onAccepted | 邀请被接受的回调。 |
onCancelled | 邀请被取消的回调。 |
onError | 邀请发生错误的回调。 |
onRejected | 邀请被拒绝的回调。 |
onTimeout | 邀请超时未处理的回调。 |
timeout | 超时时间,单位秒,如果设置为 0,SDK 不会做超时检测,也不会触发超时回调。 |
userId | 用户ID。 |
注意
返回值说明:
TUIRequest 请求体。
closeRemoteDeviceByAdmin:device:onSuccess:onError:
closeRemoteDeviceByAdmin:device:onSuccess:onError:
- (void)closeRemoteDeviceByAdmin: | (NSString *)userId |
device: | |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
关闭远端用户媒体设备(只有管理员或房主能够调用)
参数 | 描述 |
device | |
onError | 调用失败回调。 |
onSuccess | 调用成功回调。 |
userId | 用户ID。 |
注意
接口调用成功后:
若device类型为 CAMERA 或 SCREEN_SHARING,SDK会通过 TUIRoomObserver 中的 onUserVideoStateChanged 通知房间内用户。
applyToAdminToOpenLocalDevice:timeout:onAccepted:onRejected:onCancelled:onTimeout:onError:
applyToAdminToOpenLocalDevice:timeout:onAccepted:onRejected:onCancelled:onTimeout:onError:
- (TUIRequest *)applyToAdminToOpenLocalDevice: | |
timeout: | (NSTimeInterval)timeout |
onAccepted: | (nullable TUIRequestAcceptedBlock)onAccepted |
onRejected: | (nullable TUIRequestRejectedBlock)onRejected |
onCancelled: | (nullable TUIRequestCancelledBlock)onCancelled |
onTimeout: | (nullable TUIRequestTimeoutBlock)onTimeout |
onError: | (nullable TUIRequestErrorBlock)onError |
请求打开本地媒体设备(普通用户可用,device类型不支持SCREEN_SHARING)
参数 | 描述 |
device | |
onAccepted | 邀请被接受的回调。 |
onCancelled | 邀请被取消的回调。 |
onError | 邀请发生错误的回调。 |
onRejected | 邀请被拒绝的回调。 |
onTimeout | 邀请超时未处理的回调。 |
timeout | 超时时间,单位秒,如果设置为 0,SDK 不会做超时检测,也不会触发超时回调。 |
注意
返回值说明:
TUIRequest 请求体。
getSeatList:onError:
getSeatList:onError:
- (void)getSeatList: | (TUISeatListResponseBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
获取麦位列表
注意
lockSeatByAdmin:lockMode:onSuccess:onError:
lockSeatByAdmin:lockMode:onSuccess:onError:
- (void)lockSeatByAdmin: | (NSInteger)seatIndex |
lockMode: | |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
锁定麦位(只有管理员或房主能够调用,包括位置锁定、音频状态锁定和视频状态锁定)
参数 | 描述 |
lockParams | 锁麦参数。详情参见:$TUISeatLockParam$。 |
seatIndex | 麦位编号。 |
注意
takeSeat:timeout:onAccepted:onRejected:onCancelled:onTimeout:onError:
takeSeat:timeout:onAccepted:onRejected:onCancelled:onTimeout:onError:
- (TUIRequest *)takeSeat: | (NSInteger)seatIndex |
timeout: | (NSTimeInterval)timeout |
onAccepted: | (TUIRequestAcceptedBlock)onAccepted |
onRejected: | (TUIRequestRejectedBlock)onRejected |
onCancelled: | (TUIRequestCancelledBlock)onCancelled |
onTimeout: | (TUIRequestTimeoutBlock)onTimeout |
onError: | (TUIRequestErrorBlock)onError |
上麦(上麦发言模式下,需要申请)
参数 | 描述 |
onAccepted | 邀请被接受的回调。 |
onCancelled | 邀请被取消的回调。 |
onError | 邀请发生错误的回调。 |
onRejected | 邀请被拒绝的回调。 |
onTimeout | 邀请超时未处理的回调。 |
seatIndex | 麦位编号。未开启麦位,不关心麦位序列的情况下,填-1即可。 |
timeout | 超时时间,单位秒,如果设置为 0,SDK 不会做超时检测,也不会触发超时回调。 |
注意
开启上麦发言模式时,需要向主持人或管理员发起申请才允许上麦。
开启自由发言模式,直播场景可以自由上麦,上麦后开麦发言,会议场景无需调用该接口,即可开麦发言。
返回值说明:
TUIRequest 请求体。
leaveSeat:onError:
leaveSeat:onError:
- (void)leaveSeat: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
下麦
注意
moveToSeat:onSuccess:onError:
moveToSeat:onSuccess:onError:
- (void)moveToSeat: | (NSInteger)targetSeatIndex |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
移麦
注意
takeUserOnSeatByAdmin:userId:timeout:onAccepted:onRejected:onCancelled:onTimeout:onError:
takeUserOnSeatByAdmin:userId:timeout:onAccepted:onRejected:onCancelled:onTimeout:onError:
- (TUIRequest *)takeUserOnSeatByAdmin: | (NSInteger)seatIndex |
userId: | (NSString *)userId |
timeout: | (NSTimeInterval)timeout |
onAccepted: | (TUIRequestAcceptedBlock)onAccepted |
onRejected: | (TUIRequestRejectedBlock)onRejected |
onCancelled: | (TUIRequestCancelledBlock)onCancelled |
onTimeout: | (TUIRequestTimeoutBlock)onTimeout |
onError: | (TUIRequestErrorBlock)onError |
主持人/管理员 邀请用户上麦
参数 | 描述 |
onAccepted | 邀请被接受的回调。 |
onCancelled | 邀请被取消的回调。 |
onError | 邀请发生错误的回调。 |
onRejected | 邀请被拒绝的回调。 |
onTimeout | 邀请超时未处理的回调。 |
seatIndex | 麦位编号。未开启麦位、无需麦位场景下无需关心,填-1即可。 |
timeout | 超时时间,单位秒,如果设置为 0,SDK 不会做超时检测,也不会触发超时回调。 |
userId | 用户ID。 |
注意
返回值说明:
TUIRequest 请求体。
kickUserOffSeatByAdmin:userId:onSuccess:onError:
kickUserOffSeatByAdmin:userId:onSuccess:onError:
- (void)kickUserOffSeatByAdmin: | (NSInteger)seatIndex |
userId: | (NSString *)userId |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
主持人/管理员 将用户踢下麦
参数 | 描述 |
seatIndex | 麦位编号。未开启麦位,不关心麦位序列的情况下,填-1即可。 |
userId | 用户ID。 |
注意
getSeatApplicationList:onError:
getSeatApplicationList:onError:
- (void)getSeatApplicationList: | (TUIRequestListResponseBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
主持人/管理员 获取房间内申请上麦用户的请求列表
注意
disableSendingMessageByAdmin:isDisable:onSuccess:onError:
disableSendingMessageByAdmin:isDisable:onSuccess:onError:
- (void)disableSendingMessageByAdmin: | (NSString *)userId |
isDisable: | (BOOL)isDisable |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
禁用远端用户的发送文本消息能力(只有管理员或房主能够调用)
参数 | 描述 |
isDisable | 是否禁用。 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
userId | 用户ID。 |
注意
disableSendingMessageForAllUser:onSuccess:onError:
disableSendingMessageForAllUser:onSuccess:onError:
- (void)disableSendingMessageForAllUser: | (BOOL)isDisable |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
禁用所有用户的发送文本消息能力(只有管理员或房主能够调用)
参数 | 描述 |
isDisable | 是否禁用。 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
注意
sendTextMessage:onSuccess:onError:
sendTextMessage:onSuccess:onError:
- (void)sendTextMessage: | |
onSuccess: | (TUISendTextMessageBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
发送文本消息
参数 | 描述 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
textMessage | 消息对象。 |
sendCustomMessage:onSuccess:onError:
sendCustomMessage:onSuccess:onError:
- (void)sendCustomMessage: | |
onSuccess: | (TUISendCustomMessageBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
发送自定义消息
参数 | 描述 |
customMessage | 消息对象。 |
onError | 错误回调。 |
onSuccess | 成功回调。 |
cancelRequest:onSuccess:onError:
cancelRequest:onSuccess:onError:
- (void)cancelRequest: | (NSString *)requestId |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
取消请求
参数 | 描述 |
onError | 失败回调。 |
onSuccess | 成功回调。 |
requestId | 请求ID(发送请求的接口返回或者OnRequestReceived事件通知)。 |
注意
可以使用此接口来取消已发出的请求。
responseRemoteRequest:agree:onSuccess:onError:
responseRemoteRequest:agree:onSuccess:onError:
- (void)responseRemoteRequest: | (NSString *)requestId |
agree: | (BOOL)agree |
onSuccess: | (TUISuccessBlock)onSuccess |
onError: | (TUIErrorBlock)onError |
回复请求
参数 | 描述 |
agree | 是否同意 YES: 同意请求, NO: 拒绝请求。 |
onError | 失败回调。 |
onSuccess | 成功回调。 |
requestId | 请求ID(发送请求的接口返回或者OnRequestReceived事件通知)。 |
getTRTCCloud
getTRTCCloud
获得TRTC实例对象
setBeautyLevel:beautyLevel:
setBeautyLevel:beautyLevel:
- (void)setBeautyLevel: | (NSInteger)beautyStyle |
beautyLevel: | (float)beautyLevel |
设置美颜级别
参数 | 描述 |
beautyLevel | 美颜级别,取值范围 0 - 9; 0 表示关闭,9 表示效果最明显。 |
beautyStyle | 美颜风格,取值如下: 0:光滑,磨皮效果比较明显; 1:自然,磨皮效果比较自然,更多地保留了面部细节; 2:优图,磨皮效果介于光滑和自然之间,比光滑保留更多皮肤细节,比自然磨皮程度更高。 |
注意
setWhitenessLevel:
setWhitenessLevel:
- (void)setWhitenessLevel: | (float)whitenessLevel |
设置美白级别
参数 | 描述 |
whitenessLevel | 美白级别,取值范围 0 - 9;0 表示关闭,9 表示效果最明显。 |
注意
getExtension:
getExtension:
- (id) getExtension: |
getMediaDeviceManager
getMediaDeviceManager
获取设备管理类
注意
getLiveConnectionManager
getLiveConnectionManager
获取连线管理类
注意
getLiveBattleManager
getLiveBattleManager
获取 Battle 管理类
注意
callExperimentalAPI:callback:
callExperimentalAPI:callback:
- (id)callExperimentalAPI: | (NSString *)jsonStr |
callback: | (TUIExperimentalAPIResponseBlock)callback |