Class default

• 调用实验性 API 接口
• 注意：该接口用于调用一些实验性功能

• 请求跨房通话（主播 PK）
• TRTC 中两个不同音视频房间中的主播，可以通过“跨房通话”功能拉通连麦通话功能。使用此功能时， 两个主播无需退出各自原来的直播间即可进行“连麦 PK”。
• 例如：当房间“001”中的主播 A 通过 connectOtherRoom() 跟房间“002”中的主播 B 拉通跨房通话后， 房间“001”中的用户都会收到主播 B 的 onRemoteUserEnterRoom(B) 回调和 onUserVideoAvailable(B,true) 回调。 房间“002”中的用户都会收到主播 A 的 onRemoteUserEnterRoom(A) 回调和 onUserVideoAvailable(A,true) 回调。
• 简言之，跨房通话的本质，就是把两个不同房间中的主播相互分享，让每个房间里的观众都能看到两个主播。
• 跨房通话的参数考虑到后续扩展字段的兼容性问题，暂时采用了 JSON 格式的参数，要求至少包含两个字段：
• roomId：房间“001”中的主播 A 要跟房间“002”中的主播 B 连麦，主播 A 调用 ConnectOtherRoom() 时 roomId 应指定为“002”。
• userId：房间“001”中的主播 A 要跟房间“002”中的主播 B 连麦，主播 A 调用 ConnectOtherRoom() 时 userId 应指定为 B 的 userId。
• 跨房通话的请求结果会通过 onConnectOtherRoom() 回调通知给您。
• 调用示例：
• var object = new Map();
• object['roomId'] = 155;
• object['userId'] = '57890';
• trtcCloud.connectOtherRoom(jsonEncode(object));

• 退出跨房通话
• 跨房通话的退出结果会通过onDisconnectOtherRoom 回调通知给您。

• 启用音量大小提示。
• 开启后会在 onUserVoiceVolume 中获取到 SDK 对音量大小值的评估。如需打开此功能，请在 startLocalAudio() 之前调用。

• 进入房间
• 调用接口后，您会收到来自 TRTCCloudListener 中的 onEnterRoom(result) 回调：
• 如果加入成功，result 会是一个正数（result > 0），表示加入房间所消耗的时间，单位是毫秒（ms）。
• 如果加入失败，result 会是一个负数（result < 0），表示进房失败的错误码。

• 离开房间。
• 调用 exitRoom() 接口会执行退出房间的相关逻辑，例如释放音视频设备资源和编解码器资源等。 待资源释放完毕，SDK 会通过 onExitRoom() 回调通知到您。
• 如果您要再次调用 enterRoom() 或者切换到其他的音视频 SDK，请等待 onExitRoom() 回调到来之后再执行相关操作。 否则可能会遇到摄像头或麦克风被占用等各种异常问题，例如常见的 Android 媒体音量和通话音量切换问题等等。

获取 SDK 采集音量。

• 获取音效管理类 TXAudioEffectManager。

获取 SDK 播放音量

• 获取美颜管理类 TXBeautyManager

• 获取设备管理模块。

• 获取 SDK 版本信息

• 静音/取消静音所有用户的声音。

• 暂停/恢复接收所有远端视频流。
• 该接口仅暂停/恢复接收所有远端用户的视频流，但并不释放显示资源，视频画面会冻屏在 mute 前的最后一帧。
• 您在 enterRoom 之前或之后调用此 API 均能生效，在您调用 exitRoom 之后会被重置为 False。

• 静音/取消静音本地的音频。
• 当静音本地音频后，房间里的其它成员会收到 onUserAudioAvailable(userId, false) 回调通知。 当取消静音本地音频后，房间里的其它成员会收到 onUserAudioAvailable(userId, true) 回调通知。
• 与 stopLocalAudio 不同之处在于，muteLocalAudio(true) 并不会停止发送音视频数据，而是继续发送码率极低的静音包。 由于 MP4 等视频文件格式，对于音频的连续性是要求很高的，使用 stopLocalAudio 会导致录制出的 MP4 不易播放。 因此在对录制质量要求很高的场景中，建议选择 muteLocalAudio，从而录制出兼容性更好的 MP4 文件。

• 暂停/恢复推送本地的视频数据。
• 当暂停推送本地视频后，房间里的其它成员将会收到 onUserVideoAvailable(userId, false) 回调通知 当恢复推送本地视频后，房间里的其它成员将会收到 onUserVideoAvailable(userId, true) 回调通知。

• 静音/取消静音指定的远端用户的声音。

• 暂停/恢复接收指定的远端视频流。
• 该接口仅暂停/恢复接收指定的远端用户的视频流，但并不释放显示资源，视频画面会冻屏在 mute 前的最后一帧。
• 您在 enterRoom 之前或之后调用此 API 均能生效，在您调用 exitRoom 之后会被重置为 False。

添加事件

• 设置 SDK 采集音量。

• 设置 SDK 播放音量。
• 该函数会控制最终交给系统播放的声音音量，会影响录制本地音频文件的音量大小，但不会影响耳返的音量。

• 启用或禁用控制台日志打印

• 设置音视频数据接收模式（需要在进房前设置才能生效）。
• 为实现进房秒开的绝佳体验，SDK 默认进房后自动接收音视频。即在您进房成功的同时，您将立刻收到远端所有用户的音视频数据。 若您没有调用 startRemoteView，视频数据将自动超时取消。 若您主要用于语音聊天等没有自动接收视频数据需求的场景，您可以根据实际需求选择接收模式。

• 设置重力感应的适应模式

• 启用或禁用 Log 的本地压缩。
• 开启压缩后，log　存储体积明显减小，但需要腾讯云提供的 Python 脚本解压后才能阅读。 禁用压缩后，log　采用明文存储，可以直接用记事本打开阅读，但占用空间较大。

• 修改日志保存路径
• 日志文件默认保存在 /app私有目录/files/log/tencent/liteav/ 下，如需修改, 必须在所有方法前调用，并且保证目录存在及应用有目录的读写权限。

• 设置 Log 输出级别

• 设置云端的混流转码参数
• 如果您在实时音视频 控制台 中的功能配置页开启了“启用旁路推流”功能， 房间里的每一路画面都会有一个默认的直播 CDN 地址。
• 一个直播间中可能有不止一位主播，而且每个主播都有自己的画面和声音，但对于 CDN 观众来说，他们只需要一路直播流， 所以您需要将多路音视频流混成一路标准的直播流，这就需要混流转码。
• 当您调用 setMixTranscodingConfig() 接口时，SDK 会向腾讯云的转码服务器发送一条指令，目的是将房间里的多路音视频流混合为一路, 您可以通过 mixUsers 参数来调整每一路画面的位置，以及是否只混合声音，也可以通过 videoWidth、videoHeight、videoBitrate 等参数控制混合音视频流的编码参数。
• 参考文档：云端混流转码。
• @param config 转推参数，请参考 TRTCPublishCDNParam
• 注意：
• 使用 startPublishing() 请参考 TRTCCloudDef.tsx 中关于 TRTCTranscodingConfig 的介绍。如果传入 null 则取消云端混流转码。

• 设置网络流控相关参数
• 该设置决定 SDK 在各种网络环境下的调控策略（例如弱网下选择“保清晰”或“保流畅”）

• 设置某个远程用户的播放音量

• 设置编码器输出的画面镜像模式
• 该接口不改变本地摄像头的预览画面，但会改变另一端用户看到的（以及服务器录制下来的）画面效果。

• 设置视频编码器相关参数
• 该设置决定了远端用户看到的画面质量（同时也是云端录制出的视频文件的画面质量）

• 设置视频编码输出的画面方向，即设置远端用户观看到的和服务器录制的画面方向
• 当用户的手机或者 Android Pad 做了一个180度旋转时，由于摄像头的采集方向没有变，所以另一边的用户看到的画面是上下颠倒的， 在这种情况下，您可以通过该接口将 SDK 输出到对方的画面旋转180度，这样可以可以确保对方看到的画面依然正常。
• TRTCCloudDef.TRTC_VIDEO_ROTATION_0，不旋转（默认值）
• TRTCCloudDef.TRTC_VIDEO_ROTATION_180，顺时针旋转180度

• 设置暂停推送本地视频时要推送的图片
• 当暂停推送本地视频后，会继续推送该接口设置的图片
• 暂时只支持传递网络图片
• @param image 设置要推送的图片。 "" 表示不推送
• @param fps 设置推送图片帧率，最小值为5，最大值为20，默认10

• 添加水印
• 水印的位置是通过 rect 参数来指定的，rect 是一个四元组参数，其格式为 (x，y，width，height)
• x：水印的坐标，取值范围为0 - 1的浮点数。
• y：水印的坐标，取值范围为0 - 1的浮点数。
• width：水印的宽度，取值范围为0 - 1的浮点数。
• height：是不用设置的，SDK 内部会根据水印图片的宽高比自动计算一个合适的高度。
• 参数设置举例： 如果当前视频的编码分辨率是 540 × 960，且 rect 参数被您设置为（0.1，0.1，0.2，0.0）， 那么水印的左上坐标点就是（540 × 0.1，960 × 0.1）即（54，96），水印的宽度是 540 × 0.2 = 108px，水印的高度会根据水印图片的宽高比由 SDK 自动算出。
• @param image 水印图片，必须使用透明底色的 png 格式
• @param streamType 指定给哪一路画面设置水印
• @param rect 水印相对于编码分辨率的归一化坐标，x，y，width，height 取值范围0 - 1。
• 注意：如果您要给主画面（一般为摄像头）和辅路画面（一般用作屏幕分享）同时设置水印，需要调用该接口两次，并设定不同的 streamType。

• 开始录音。
• 该方法调用后， SDK 会将通话过程中的所有音频（包括本地音频，远端音频，BGM 等）录制到一个文件里。 无论是否进房，调用该接口都生效。 如果调用 exitRoom 时还在录音，录音会自动停止。

• 开启本地音频的采集和上行,并设置音频质量。
• 该函数会启动麦克风采集，并将音频数据传输给房间里的其他用户。 SDK 不会默认开启本地音频采集和上行，您需要调用该函数开启，否则房间里的其他用户将无法听到您的声音。
• 主播端的音质越高，观众端的听感越好，但传输所依赖的带宽也就越高，在带宽有限的场景下也更容易出现卡顿。

• 开始向友商云的直播 CDN 转推
• 该接口跟 startPublishing() 类似，但 startPublishCDNStream() 支持向非腾讯云的直播 CDN 转推。
• @param CDN 转推参数，请参考 TRTCPublishCDNParam
• 注意：
• 使用 startPublishing() 绑定腾讯云直播 CDN 不收取额外的费用，但使用 startPublishCDNStream() 绑定非腾讯云直播 CDN 需要收取转推费用。

• 开始向腾讯云的直播 CDN 推流
• 该接口会指定当前用户的音视频流在腾讯云 CDN 所对应的 StreamId，进而可以指定当前用户的 CDN 播放地址。
• 例如：如果我们采用如下代码设置当前用户的主画面 StreamId 为 user_stream_001，那么该用户主画面对应的 CDN 播放地址为： “http://yourdomain/live/user_stream_001.flv”，其中 yourdomain 为您自己备案的播放域名， 您可以在直播控制台 配置您的播放域名，腾讯云不提供默认的播放域名。
• 您也可以在设置 enterRoom 的参数 TRTCParams 时指定 streamId, 而且我们更推荐您采用这种方案。

• 开始进行网络测速（视频通话期间请勿测试，以免影响通话质量）
• 测速结果将会用于优化 SDK 接下来的服务器选择策略，因此推荐您在用户首次通话前先进行一次测速，这将有助于我们选择最佳的服务器。 同时，如果测试结果非常不理想，您可以通过醒目的 UI 提示用户选择更好的网络。 测试结果通过 TRTCCloudListener.onSpeedTest 回调出来。
• 注意：测速本身会消耗一定的流量，所以也会产生少量额外的流量费用。

• 停止录音。
• 如果调用 exitRoom 时还在录音，录音会自动停止。

• 关闭本地音频的采集和上行。
• 当关闭本地音频的采集和上行，房间里的其它成员会收到 onUserAudioAvailable(false) 回调通知。

停止向非腾讯云地址转推

停止向腾讯云的直播 CDN 推流

停止服务器测速。

• 切换角色，仅适用于直播场景（TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM）。
• 在直播场景下，一个用户可能需要在“观众”和“主播”之间来回切换。 您可以在进房前通过 TRTCParams 中的 role 字段确定角色，也可以通过 switchRole 在进房后切换角色。

• 切换房间
• 调用接口后，会退出原来的房间，并且停止原来房间的音视频数据发送和所有远端用户的音视频播放，但不会停止本地视频的预览。 进入新房间成功后，会自动恢复原来的音视频数据发送状态。
• 接口调用结果会通过onSwitchRoom(errCode, errMsg) 回调。

移除所有事件

移除事件