@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.1

package/resource/{doc → knowledge}/trtc/android/TRTCCloudListener.md

@@ -1,113 +1,121 @@
-# 腾讯云实时音视频(TRTC SDK )文档
+Copyright (c) 2021 Tencent. All rights reserved.
 
-## 概述
-`TRTCCloudListener.java` 是腾讯云实时音视频(TRTC SDK ) Android 平台的事件回调接口文档。
+Module:   TRTCCloudListener @ TXLiteAVSDK
+
+Function: 腾讯云实时音视频的事件回调接口
 
 ## TRTCVideoRenderListener
-| 函数列表 | 描述 |
-| --- | --- |
-| onRenderVideoFrame | 自定义视频渲染回调。 |
+
+|函数列表|描述|
+|---------|---------|
+|onRenderVideoFrame|自定义视频渲染回调。|
 
 ## TRTCVideoFrameListener
-| 函数列表 | 描述 |
-| --- | --- |
-| onGLContextCreated | SDK 内部 OpenGL 环境已经创建的通知。 |
-| onProcessVideoFrame | 用于对接第三方美颜组件的视频处理回调。 |
-| onGLContextDestory | SDK 内部 OpenGL 环境被销毁的通知。 |
+
+|函数列表|描述|
+|---------|---------|
+|onGLContextCreated|SDK 内部 OpenGL 环境已经创建的通知。|
+|onProcessVideoFrame|用于对接第三方美颜组件的视频处理回调。|
+|onGLContextDestory|SDK 内部 OpenGL 环境被销毁的通知。|
 
 ## TRTCAudioFrameListener
-| 函数列表 | 描述 |
-| --- | --- |
-| onCapturedAudioFrame | 本地采集并经过音频模块前处理后的音频数据回调。 |
-| onLocalProcessedAudioFrame | 本地采集并经过音频模块前处理、音效处理和混 BGM 后的音频数据回调。 |
-| onRemoteUserAudioFrame | 混音前的每一路远程用户的音频数据。 |
-| onMixedPlayAudioFrame | 将各路待播放音频混合之后并在最终提交系统播放之前的数据回调。 |
-| onMixedAllAudioFrame | SDK 所有音频混合后的音频数据（包括采集到的和待播放的）。 |
-| onVoiceEarMonitorAudioFrame | 耳返的音频数据。 |
+
+|函数列表|描述|
+|---------|---------|
+|onCapturedAudioFrame|本地采集并经过音频模块前处理后的音频数据回调。|
+|onLocalProcessedAudioFrame|本地采集并经过音频模块前处理、音效处理和混 BGM 后的音频数据回调。|
+|onRemoteUserAudioFrame|混音前的每一路远程用户的音频数据。|
+|onMixedPlayAudioFrame|将各路待播放音频混合之后并在最终提交系统播放之前的数据回调。|
+|onMixedAllAudioFrame|SDK 所有音频混合后的音频数据（包括采集到的和待播放的）。|
+|onVoiceEarMonitorAudioFrame|耳返的音频数据。|
 
 ## TRTCLogListener
-| 函数列表 | 描述 |
-| --- | --- |
-| onLog | 本地 LOG 的打印回调。 |
+
+|函数列表|描述|
+|---------|---------|
+|onLog|本地 LOG 的打印回调。|
 
 ## TRTCCloudListener
-| 函数列表 | 描述 |
-| --- | --- |
-| onError | 错误事件回调。 |
-| onWarning | 警告事件回调。 |
-| onEnterRoom | 进入房间成功与否的事件回调。 |
-| onExitRoom | 离开房间的事件回调。 |
-| onSwitchRole | 切换角色的事件回调。 |
-| onSwitchRoom | 切换房间的结果回调。 |
-| onConnectOtherRoom | 请求跨房通话的结果回调。 |
-| onDisConnectOtherRoom | 结束跨房通话的结果回调。 |
-| onUpdateOtherRoomForwardMode | 更改跨房主播上行能力的结果回调。 |
-| onRemoteUserEnterRoom | 有用户加入当前房间。 |
-| onRemoteUserLeaveRoom | 有用户离开当前房间。 |
-| onUserVideoAvailable | 某远端用户发布/取消了主路视频画面。 |
-| onUserSubStreamAvailable | 某远端用户发布/取消了辅路视频画面。 |
-| onUserAudioAvailable | 某远端用户发布/取消了自己的音频。 |
-| onFirstVideoFrame | SDK 开始渲染自己本地或远端用户的首帧画面。 |
-| onFirstAudioFrame | SDK 开始播放远端用户的首帧音频。 |
-| onSendFirstLocalVideoFrame | 自己本地的首个视频帧已被发布出去。 |
-| onSendFirstLocalAudioFrame | 自己本地的首个音频帧已被发布出去。 |
-| onRemoteVideoStatusUpdated | 远端视频状态变化的事件回调。 |
-| onRemoteAudioStatusUpdated | 远端音频状态变化的事件回调。 |
-| onUserVideoSizeChanged | 用户视频大小发生改变回调。 |
-| onNetworkQuality | 网络质量的实时统计回调。 |
-| onStatistics | 音视频技术指标的实时统计回调。 |
-| onSpeedTestResult | 网速测试的结果回调。 |
-| onConnectionLost | SDK 与云端的连接已经断开。 |
-| onTryToReconnect | SDK 正在尝试重新连接到云端。 |
-| onConnectionRecovery | SDK 与云端的连接已经恢复。 |
-| onCameraDidReady | 摄像头准备就绪。 |
-| onMicDidReady | 麦克风准备就绪。 |
-| onAudioRouteChanged | 当前音频路由发生变化（仅适用于移动设备）。 |
-| onUserVoiceVolume | 音量大小的反馈回调。 |
-| onRecvCustomCmdMsg | 收到自定义消息的事件回调。 |
-| onMissCustomCmdMsg | 自定义消息丢失的事件回调。 |
-| onRecvSEIMsg | 收到 SEI 消息的回调。 |
-| onStartPublishing | 开始向腾讯云直播 CDN 上发布音视频流的事件回调。 |
-| onStopPublishing | 停止向腾讯云直播 CDN 上发布音视频流的事件回调。 |
-| onStartPublishCDNStream | 开始向非腾讯云 CDN 上发布音视频流的事件回调。 |
-| onStopPublishCDNStream | 停止向非腾讯云 CDN 上发布音视频流的事件回调。 |
-| onSetMixTranscodingConfig | 设置云端混流的排版布局和转码参数的事件回调。 |
-| onStartPublishMediaStream | 开始发布媒体流的事件回调。 |
-| onUpdatePublishMediaStream | 更新媒体流的事件回调。 |
-| onStopPublishMediaStream | 停止媒体流的事件回调。 |
-| onCdnStreamStateChanged | RTMP/RTMPS 推流状态发生改变回调。 |
-| onScreenCaptureStarted | 屏幕分享开启的事件回调。 |
-| onScreenCapturePaused | 屏幕分享暂停的事件回调。 |
-| onScreenCaptureResumed | 屏幕分享恢复的事件回调。 |
-| onScreenCaptureStopped | 屏幕分享停止的事件回调。 |
-| onLocalRecordBegin | 本地录制任务已经开始的事件回调。 |
-| onLocalRecording | 本地录制任务正在进行中的进展事件回调。 |
-| onLocalRecordFragment | 本地录制分片的事件回调。 |
-| onLocalRecordComplete | 本地录制任务已经结束的事件回调。 |
-| onSnapshotComplete | 本地截图完成的事件回调。 |
-| onUserEnter | 有主播加入当前房间（已废弃）。 |
-| onUserExit | 有主播离开当前房间（已废弃）。 |
-| onAudioEffectFinished | 音效播放已结束（已废弃）。 |
-| onSpeedTest | 服务器测速的结果回调（已废弃）。 |
+
+|函数列表|描述|
+|---------|---------|
+|onError|错误事件回调。|
+|onWarning|警告事件回调。|
+|onEnterRoom|进入房间成功与否的事件回调。|
+|onExitRoom|离开房间的事件回调。|
+|onSwitchRole|切换角色的事件回调。|
+|onSwitchRoom|切换房间的结果回调。|
+|onConnectOtherRoom|请求跨房通话的结果回调。|
+|onDisConnectOtherRoom|结束跨房通话的结果回调。|
+|onUpdateOtherRoomForwardMode|更改跨房主播上行能力的结果回调。|
+|onRemoteUserEnterRoom|有用户加入当前房间。|
+|onRemoteUserLeaveRoom|有用户离开当前房间。|
+|onUserVideoAvailable|某远端用户发布/取消了主路视频画面。|
+|onUserSubStreamAvailable|某远端用户发布/取消了辅路视频画面。|
+|onUserAudioAvailable|某远端用户发布/取消了自己的音频。|
+|onFirstVideoFrame|SDK 开始渲染自己本地或远端用户的首帧画面。|
+|onFirstAudioFrame|SDK 开始播放远端用户的首帧音频。|
+|onSendFirstLocalVideoFrame|自己本地的首个视频帧已被发布出去。|
+|onSendFirstLocalAudioFrame|自己本地的首个音频帧已被发布出去。|
+|onRemoteVideoStatusUpdated|远端视频状态变化的事件回调。|
+|onRemoteAudioStatusUpdated|远端音频状态变化的事件回调。|
+|onUserVideoSizeChanged|用户视频大小发生改变回调。|
+|onNetworkQuality|网络质量的实时统计回调。|
+|onStatistics|音视频技术指标的实时统计回调。|
+|onSpeedTestResult|网速测试的结果回调。|
+|onConnectionLost|SDK 与云端的连接已经断开。|
+|onTryToReconnect|SDK 正在尝试重新连接到云端。|
+|onConnectionRecovery|SDK 与云端的连接已经恢复。|
+|onCameraDidReady|摄像头准备就绪。|
+|onMicDidReady|麦克风准备就绪。|
+|onAudioRouteChanged|当前音频路由发生变化（仅适用于移动设备）。|
+|onUserVoiceVolume|音量大小的反馈回调。|
+|onRecvCustomCmdMsg|收到自定义消息的事件回调。|
+|onMissCustomCmdMsg|自定义消息丢失的事件回调。|
+|onRecvSEIMsg|收到 SEI 消息的回调。|
+|onStartPublishing|开始向腾讯云直播 CDN 上发布音视频流的事件回调。|
+|onStopPublishing|停止向腾讯云直播 CDN 上发布音视频流的事件回调。|
+|onStartPublishCDNStream|开始向非腾讯云 CDN 上发布音视频流的事件回调。|
+|onStopPublishCDNStream|停止向非腾讯云 CDN 上发布音视频流的事件回调。|
+|onSetMixTranscodingConfig|设置云端混流的排版布局和转码参数的事件回调。|
+|onStartPublishMediaStream|开始发布媒体流的事件回调。|
+|onUpdatePublishMediaStream|更新媒体流的事件回调。|
+|onStopPublishMediaStream|停止媒体流的事件回调。|
+|onCdnStreamStateChanged|RTMP/RTMPS 推流状态发生改变回调。|
+|onScreenCaptureStarted|屏幕分享开启的事件回调。|
+|onScreenCapturePaused|屏幕分享暂停的事件回调。|
+|onScreenCaptureResumed|屏幕分享恢复的事件回调。|
+|onScreenCaptureStopped|屏幕分享停止的事件回调。|
+|onLocalRecordBegin|本地录制任务已经开始的事件回调。|
+|onLocalRecording|本地录制任务正在进行中的进展事件回调。|
+|onLocalRecordFragment|本地录制分片的事件回调。|
+|onLocalRecordComplete|本地录制任务已经结束的事件回调。|
+|onSnapshotComplete|本地截图完成的事件回调。|
+|onExperimentalEvent|实验性接口的事件回调。|
+|onUserEnter|有主播加入当前房间（已废弃）。|
+|onUserExit|有主播离开当前房间（已废弃）。|
+|onAudioEffectFinished|音效播放已结束（已废弃）。|
+|onSpeedTest|服务器测速的结果回调（已废弃）。|
 
 ## onRenderVideoFrame
 
-#### 自定义视频渲染回调。
+**自定义视频渲染回调。**
 
 当您设置了本地或者远端的视频自定义渲染回调之后，SDK 就会将原本要交给渲染控件进行渲染的视频帧通过此回调接口抛送给您，以便于您进行自定义渲染。
-| 参数 | 描述 |
-| --- | --- |
-| frame | 待渲染的视频帧信息。 |
-| streamType | 频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。 |
-| userId | 视频源的 userId，如果是本地视频回调（setLocalVideoRenderDelegate），该参数可以忽略。 |
+
+|参数|描述|
+|---------|---------|
+|frame|待渲染的视频帧信息。|
+|streamType|频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。|
+|userId|视频源的 userId，如果是本地视频回调（setLocalVideoRenderDelegate），该参数可以忽略。|
 
 ## onGLContextCreated
 
-#### SDK 内部 OpenGL 环境已经创建的通知。
+**SDK 内部 OpenGL 环境已经创建的通知。**
 
 ## onProcessVideoFrame
 
-#### 用于对接第三方美颜组件的视频处理回调。
+**用于对接第三方美颜组件的视频处理回调。**
 
 如果您选购了第三方美颜组件，就需要在 TRTCCloud 中设置第三方美颜回调，之后 TRTC 就会将原本要进行预处理的视频帧通过此回调接口抛送给您。
 
@@ -144,10 +152,11 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
     return 0;
 }
 ```
-| 参数 | 描述 |
-| --- | --- |
-| dstFrame | 用于接收第三方美颜处理过的视频画面。 |
-| srcFrame | 用于承载 TRTC 采集到的摄像头画面。 |
+
+|参数|描述|
+|---------|---------|
+|dstFrame|用于接收第三方美颜处理过的视频画面。|
+|srcFrame|用于承载 TRTC 采集到的摄像头画面。|
 
 > **注意**
 >
@@ -157,11 +166,11 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onGLContextDestory
 
-#### SDK 内部 OpenGL 环境被销毁的通知。
+**SDK 内部 OpenGL 环境被销毁的通知。**
 
 ## onCapturedAudioFrame
 
-#### 本地采集并经过音频模块前处理后的音频数据回调。
+**本地采集并经过音频模块前处理后的音频数据回调。**
 
 当您设置完音频数据自定义回调之后，SDK 内部会把刚采集到并经过前处理(ANS、AEC、AGC）之后的数据，以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
@@ -170,9 +179,9 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 -  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为 ` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
 
-| 参数 | 描述 |
-| --- | --- |
-| frame | PCM 格式的音频数据帧。 |
+|参数|描述|
+|---------|---------|
+|frame|PCM 格式的音频数据帧。|
 
 > **注意**
 >
@@ -188,7 +197,7 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onLocalProcessedAudioFrame
 
-#### 本地采集并经过音频模块前处理、音效处理和混 BGM 后的音频数据回调。
+**本地采集并经过音频模块前处理、音效处理和混 BGM 后的音频数据回调。**
 
 当您设置完音频数据自定义回调之后，SDK 内部会把刚采集到并经过前处理、音效处理和混 BGM 之后的数据，在最终进行网络编码之前，以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
@@ -202,9 +211,10 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 您可以通过设置接口中的 ` TRTCAudioFrame.extraData ` 字段，达到传输信令的目的。由于音频帧头部的数据块不能太大，建议您写入 ` extraData ` 时，尽量将信令控制在几个字节的大小，如果超过 100 个字节，写入的数据不会被发送。
 
 房间内其他用户可以通过 TRTCAudioFrameListener 中的 ` onRemoteUserAudioFrame ` 中的 ` TRTCAudioFrame.extraData ` 字段回调接收数据。
-| 参数 | 描述 |
-| --- | --- |
-| frame | PCM 格式的音频数据帧。 |
+
+|参数|描述|
+|---------|---------|
+|frame|PCM 格式的音频数据帧。|
 
 > **注意**
 >
@@ -220,7 +230,7 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onRemoteUserAudioFrame
 
-#### 混音前的每一路远程用户的音频数据。
+**混音前的每一路远程用户的音频数据。**
 
 当您设置完音频数据自定义回调之后，SDK 内部会把远端的每一路原始数据，在最终混音之前，以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
@@ -229,10 +239,10 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 -  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
 
-| 参数 | 描述 |
-| --- | --- |
-| frame | PCM 格式的音频数据帧。 |
-| userId | 用户标识。 |
+|参数|描述|
+|---------|---------|
+|frame|PCM 格式的音频数据帧。|
+|userId|用户标识。|
 
 > **注意**
 >
@@ -242,7 +252,7 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onMixedPlayAudioFrame
 
-#### 将各路待播放音频混合之后并在最终提交系统播放之前的数据回调。
+**将各路待播放音频混合之后并在最终提交系统播放之前的数据回调。**
 
 当您设置完音频数据自定义回调之后，SDK 内部会把各路待播放的音频混合之后的音频数据，在提交系统播放之前，以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
@@ -251,9 +261,9 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 -  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为 ` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
 
-| 参数 | 描述 |
-| --- | --- |
-| frame | PCM 格式的音频数据帧。 |
+|参数|描述|
+|---------|---------|
+|frame|PCM 格式的音频数据帧。|
 
 > **注意**
 >
@@ -269,7 +279,7 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onMixedAllAudioFrame
 
-#### SDK 所有音频混合后的音频数据（包括采集到的和待播放的）。
+**SDK 所有音频混合后的音频数据（包括采集到的和待播放的）。**
 
 当您设置完音频数据自定义回调之后，SDK 内部会把所有采集到的和待播放的音频数据混合起来，以 PCM 格式的形式通过本接口回调给您，便于您进行自定义录制。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
@@ -278,9 +288,9 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 -  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为 ` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
 
-| 参数 | 描述 |
-| --- | --- |
-| frame | PCM 格式的音频数据帧。 |
+|参数|描述|
+|---------|---------|
+|frame|PCM 格式的音频数据帧。|
 
 > **注意**
 >
@@ -293,7 +303,7 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onVoiceEarMonitorAudioFrame
 
-#### 耳返的音频数据。
+**耳返的音频数据。**
 
 当您设置完音频数据自定义回调之后，SDK 内部会把耳返的音频数据在播放之前以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长不固定，格式为 PCM 格式。
@@ -302,9 +312,9 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 -  以 TRTC 默认的音频录制格式 48000 采样率、单声道、16采样点位宽为例，0.02s 的音频数据字节帧长为 ` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
 
-| 参数 | 描述 |
-| --- | --- |
-| frame | PCM 格式的音频数据帧。 |
+|参数|描述|
+|---------|---------|
+|frame|PCM 格式的音频数据帧。|
 
 > **注意**
 >
@@ -317,44 +327,47 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onLog
 
-#### 本地 LOG 的打印回调。
+**本地 LOG 的打印回调。**
 
 如果您希望捕获 SDK 的本地日志打印行为，可以通过设置日志回调，让 SDK 将要打印的日志都通过本回调接口抛送给您。
-| 参数 | 描述 |
-| --- | --- |
-| level | 日志等级请参见 TRTC_LOG_LEVEL。 |
-| log | 日志内容。 |
-| module | 保留字段，暂无具体意义，目前为固定值 ` TXLiteAVSDK `。 |
+
+|参数|描述|
+|---------|---------|
+|level|日志等级请参见 TRTC_LOG_LEVEL。|
+|log|日志内容。|
+|module|保留字段，暂无具体意义，目前为固定值 ` TXLiteAVSDK `。|
 
 ## onError
 
-#### 错误事件回调。
+**错误事件回调。**
 
 错误事件，表示 SDK 抛出的不可恢复的错误，例如进入房间失败或设备开启失败等。
 
 参考文档：[错误码表](https://cloud.tencent.com/document/product/647/38308)
-| 参数 | 描述 |
-| --- | --- |
-| errCode | 错误码 |
-| errMsg | 错误信息 |
-| extInfo | 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题 |
+
+|参数|描述|
+|---------|---------|
+|errCode|错误码|
+|errMsg|错误信息|
+|extInfo|扩展信息字段，个别错误码可能会带额外的信息帮助定位问题|
 
 ## onWarning
 
-#### 警告事件回调。
+**警告事件回调。**
 
 警告事件，表示 SDK 抛出的提示性问题，例如视频出现卡顿或 CPU 使用率太高等。
 
 参考文档：[错误码表](https://cloud.tencent.com/document/product/647/38308)
-| 参数 | 描述 |
-| --- | --- |
-| extInfo | 扩展信息字段，个别警告码可能会带额外的信息帮助定位问题 |
-| warningCode | 警告码 |
-| warningMsg | 警告信息 |
+
+|参数|描述|
+|---------|---------|
+|extInfo|扩展信息字段，个别警告码可能会带额外的信息帮助定位问题|
+|warningCode|警告码|
+|warningMsg|警告信息|
 
 ## onEnterRoom
 
-#### 进入房间成功与否的事件回调。
+**进入房间成功与否的事件回调。**
 
 调用 TRTCCloud 中的 enterRoom 接口执行进房操作后，会收到来自 TRTCCloudListener 的 ` onEnterRoom(result) ` 回调：
 -  如果加入成功，回调 result 会是一个正数（result > 0），代表进入房间所消耗的时间，单位是毫秒（ms）。
@@ -362,9 +375,10 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 -  如果加入失败，回调 result 会是一个负数（result < 0），代表失败原因的错误码。
 
 进房失败的错误码含义请参见[错误码表](https://cloud.tencent.com/document/product/647/38308)。
-| 参数 | 描述 |
-| --- | --- |
-| result | result > 0 时为进房耗时（ms），result < 0 时为进房错误码。 |
+
+|参数|描述|
+|---------|---------|
+|result|result > 0 时为进房耗时（ms），result < 0 时为进房错误码。|
 
 > **注意**
 >
@@ -377,86 +391,92 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onExitRoom
 
-#### 离开房间的事件回调。
+**离开房间的事件回调。**
 
 调用 TRTCCloud 中的 exitRoom 接口会执行退出房间的相关逻辑，例如释放音视频设备资源和编解码器资源等。
 
 待 SDK 占用的所有资源释放完毕后，SDK 会抛出 ` onExitRoom() ` 回调通知到您。
 
 如果您要再次调用 enterRoom 或者切换到其他的音视频 SDK，请等待 ` onExitRoom ` 回调到来后再执行相关操作。否则可能会遇到例如摄像头、麦克风设备被强占等各种异常问题。
-| 参数 | 描述 |
-| --- | --- |
-| reason | 离开房间原因，0：主动调用 exitRoom 退出房间；1：被服务器移出当前房间；2：当前房间整个被解散 3: 服务器状态异常。 |
+
+|参数|描述|
+|---------|---------|
+|reason|离开房间原因，0：主动调用 exitRoom 退出房间；1：被服务器移出当前房间；2：当前房间整个被解散 3: 服务器状态异常。|
 
 ## onSwitchRole
 
-#### 切换角色的事件回调。
+**切换角色的事件回调。**
 
 调用 TRTCCloud 中的 switchRole 接口会切换主播和观众的角色，该操作会伴随一个线路切换的过程，待 SDK 切换完成后，会抛出 ` onSwitchRole() ` 事件回调。
-| 参数 | 描述 |
-| --- | --- |
-| errCode | 错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 错误信息。 |
+
+|参数|描述|
+|---------|---------|
+|errCode|错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|错误信息。|
 
 ## onSwitchRoom
 
-#### 切换房间的结果回调。
+**切换房间的结果回调。**
 
 调用 TRTCCloud 中的 switchRoom 接口可以让用户快速地从一个房间切换到另一个房间，待 SDK 切换完成后，会抛出 ` onSwitchRoom() ` 事件回调。
-| 参数 | 描述 |
-| --- | --- |
-| errCode | 错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 错误信息。 |
+
+|参数|描述|
+|---------|---------|
+|errCode|错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|错误信息。|
 
 ## onConnectOtherRoom
 
-#### 请求跨房通话的结果回调。
+**请求跨房通话的结果回调。**
 
 调用 TRTCCloud 中的 connectOtherRoom 接口会将两个不同房间中的主播拉通视频通话，也就是所谓的“主播PK”功能。
 
 调用者会收到 ` onConnectOtherRoom() ` 回调来获知跨房通话是否成功。
-| 参数 | 描述 |
-| --- | --- |
-| errCode | 错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 错误信息。 |
-| userId | 要跨房通话的另一个房间中的主播的用户 ID。 |
+
+|参数|描述|
+|---------|---------|
+|errCode|错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|错误信息。|
+|userId|要跨房通话的另一个房间中的主播的用户 ID。|
 
 ## onDisConnectOtherRoom
 
-#### 结束跨房通话的结果回调。
+**结束跨房通话的结果回调。**
 
 调用 TRTCCloud 中的 disConnectOtherRoom 接口会结束两个不同房间中的主播视频通话，也就是所谓的“主播PK”功能。
 
 调用者会收到 ` onDisconnectOtherRoom() ` 回调来获知结束跨房通话是否成功。
-| 参数 | 描述 |
-| --- | --- |
-| errCode | 错误码，ERR_NULL 代表成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 错误信息。 |
+
+|参数|描述|
+|---------|---------|
+|errCode|错误码，ERR_NULL 代表成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|错误信息。|
 
 ## onUpdateOtherRoomForwardMode
 
-#### 更改跨房主播上行能力的结果回调。
+**更改跨房主播上行能力的结果回调。**
 
 调用 TRTCCloud 中的 updateOtherRoomForwardMode 接口会限制跨房主播在本房间内的上行能力，禁止或允许跨房主播发布音频/主路视频/辅路视频，该行为会影响房间内的所有用户。
 
 调用者会收到 ` onUpdateOtherRoomForwardMode() ` 回调来获知更改跨房主播上行能力是否成功。
-| 参数 | 描述 |
-| --- | --- |
-| errCode | 错误码，ERR_NULL 代表成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 错误信息。 |
+
+|参数|描述|
+|---------|---------|
+|errCode|错误码，ERR_NULL 代表成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|错误信息。|
 
 ## onRemoteUserEnterRoom
 
-#### 有用户加入当前房间。
+**有用户加入当前房间。**
 
 出于性能方面的考虑，在 TRTC 两种不同的应用场景（即 ` AppScene `，在 enterRoom 时通过第二个参数指定）下，该通知的行为会有差别：
 -  直播类场景（TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM）：该场景下的用户区分主播和观众两种角色，只有主播进入房间时才会触发该通知，观众进入房间时不会触发该通知。
 
 -  通话类场景（TRTC_APP_SCENE_VIDEOCALL 和 TRTC_APP_SCENE_AUDIOCALL）：该场景下的用户没有角色的区分（可认为都是主播），任何用户进入房间都会触发该通知。
 
-| 参数 | 描述 |
-| --- | --- |
-| userId | 远端用户的用户标识。 |
+|参数|描述|
+|---------|---------|
+|userId|远端用户的用户标识。|
 
 > **注意**
 >
@@ -469,43 +489,45 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onRemoteUserLeaveRoom
 
-#### 有用户离开当前房间。
+**有用户离开当前房间。**
 
 与 onRemoteUserEnterRoom 相对应，在两种不同的应用场景（即 AppScene，在 enterRoom 时通过第二个参数指定）下，该通知的行为会有差别：
 -  直播类场景（TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM）：该场景下的用户区分主播和观众两种角色，只有主播离开房间时才会触发该通知，观众离开房间时不会触发该通知。
 
 -  通话类场景（TRTC_APP_SCENE_VIDEOCALL 和 TRTC_APP_SCENE_AUDIOCALL）：该场景下的用户没有角色的区分（可认为都是主播），任何用户离开房间都会触发该通知。
 
-| 参数 | 描述 |
-| --- | --- |
-| reason | 离开原因，0表示用户主动退出房间，1表示用户超时退出，2表示被移出房间，3表示主播因切换到观众退出房间。 |
-| userId | 远端用户的用户标识。 |
+|参数|描述|
+|---------|---------|
+|reason|离开原因，0表示用户主动退出房间，1表示用户超时退出，2表示被移出房间，3表示主播因切换到观众退出房间。|
+|userId|远端用户的用户标识。|
 
 ## onUserVideoAvailable
 
-#### 某远端用户发布/取消了主路视频画面。
+**某远端用户发布/取消了主路视频画面。**
 
 **主路画面** 一般被用于承载摄像头画面。当您收到 ` onUserVideoAvailable(userId, true) ` 通知时，表示该路画面已经有可播放的视频帧到达。
 
 此时，您需要调用 startRemoteView 接口订阅该用户的远程画面，订阅成功后，您会继续收到该用户的首帧画面渲染回调 ` onFirstVideoFrame(userId) `。
 
 当您收到 ` onUserVideoAvailable(userId, false) ` 通知时，表示该路远程画面已经被关闭，关闭的原因可能是该用户调用了 muteLocalVideo 或 stopLocalPreview。
-| 参数 | 描述 |
-| --- | --- |
-| available | 该用户是否发布（或取消发布）了主路视频画面，true：发布；false：取消发布。 |
-| userId | 远端用户的用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|available|该用户是否发布（或取消发布）了主路视频画面，true：发布；false：取消发布。|
+|userId|远端用户的用户标识。|
 
 ## onUserSubStreamAvailable
 
-#### 某远端用户发布/取消了辅路视频画面。
+**某远端用户发布/取消了辅路视频画面。**
 
 “辅路画面”一般被用于承载屏幕分享的画面。当您收到 ` onUserSubStreamAvailable(userId, true) ` 通知时，表示该路画面已经有可播放的视频帧到达。
 
 此时，您需要调用 startRemoteView 接口订阅该用户的远程画面，订阅成功后，您会继续收到该用户的首帧画面渲染回调 ` onFirstVideoFrame(userId) `。
-| 参数 | 描述 |
-| --- | --- |
-| available | 该用户是否发布（或取消发布）了辅路视频画面，true: 发布；false：取消发布。 |
-| userId | 远端用户的用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|available|该用户是否发布（或取消发布）了辅路视频画面，true: 发布；false：取消发布。|
+|userId|远端用户的用户标识。|
 
 > **注意**
 >
@@ -515,17 +537,17 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onUserAudioAvailable
 
-#### 某远端用户发布/取消了自己的音频。
+**某远端用户发布/取消了自己的音频。**
 
 当您收到 ` onUserAudioAvailable(userId, true) ` 通知时，表示该用户发布了自己的声音，此时 SDK 的表现为：
 -  在自动订阅模式下，您无需做任何操作，SDK 会自动播放该用户的声音。
 
 -  在手动订阅模式下，您可以通过 muteRemoteAudio(userid, false) 来播放该用户的声音。
 
-| 参数 | 描述 |
-| --- | --- |
-| available | 该用户是否发布（或取消发布）了自己的音频，true: 发布；false：取消发布。 |
-| userId | 远端用户的用户标识。 |
+|参数|描述|
+|---------|---------|
+|available|该用户是否发布（或取消发布）了自己的音频，true: 发布；false：取消发布。|
+|userId|远端用户的用户标识。|
 
 > **注意**
 >
@@ -535,19 +557,19 @@ int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCV
 
 ## onFirstVideoFrame
 
-#### SDK 开始渲染自己本地或远端用户的首帧画面。
+**SDK 开始渲染自己本地或远端用户的首帧画面。**
 
 SDK 会在渲染自己本地或远端用户的首帧画面时抛出该事件，您可以通过回调事件中的 userId 参数来判断事件来自于“本地”还是来自于“远端”。
 -  如果 userId 为空值，代表 SDK 已经开始渲染自己本地的视频画面，不过前提是您已经调用了 startLocalPreview 或 startScreenCapture。
 
 -  如果 userId 不为空，代表 SDK 已经开始渲染远端用户的视频画面，不过前提是您已经调用了 startRemoteView 订阅了该用户的视频画面。
 
-| 参数 | 描述 |
-| --- | --- |
-| height | 画面的高度。 |
-| streamType | 视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。 |
-| userId | 本地或远端的用户标识，如果 userId 为空值代表自己本地的首帧画面已到来，userId 不为空则代表远端用户的首帧画面已到来。 |
-| width | 画面的宽度。 |
+|参数|描述|
+|---------|---------|
+|height|画面的高度。|
+|streamType|视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。|
+|userId|本地或远端的用户标识，如果 userId 为空值代表自己本地的首帧画面已到来，userId 不为空则代表远端用户的首帧画面已到来。|
+|width|画面的宽度。|
 
 > **注意**
 >
@@ -560,76 +582,82 @@ SDK 会在渲染自己本地或远端用户的首帧画面时抛出该事件，
 
 ## onFirstAudioFrame
 
-#### SDK 开始播放远端用户的首帧音频。
+**SDK 开始播放远端用户的首帧音频。**
 
 SDK 会在播放远端用户的首帧音频时抛出该事件，本地音频的首帧事件暂不抛出。
-| 参数 | 描述 |
-| --- | --- |
-| userId | 远端用户的用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|userId|远端用户的用户标识。|
 
 ## onSendFirstLocalVideoFrame
 
-#### 自己本地的首个视频帧已被发布出去。
+**自己本地的首个视频帧已被发布出去。**
 
 当您成功进入房间并通过 startLocalPreview 或 startScreenCapture 开启本地视频采集之后（开启采集和进入房间的先后顺序无影响），SDK 就会开始进行视频编码，并通过自身的网络模块向云端发布自己本地的视频数据。当 SDK 成功地向云端送出自己的第一帧视频数据帧以后，就会抛出 ` onSendFirstLocalVideoFrame ` 事件回调。
-| 参数 | 描述 |
-| --- | --- |
-| streamType | 视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。 |
+
+|参数|描述|
+|---------|---------|
+|streamType|视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。|
 
 ## onSendFirstLocalAudioFrame
 
-#### 自己本地的首个音频帧已被发布出去。
+**自己本地的首个音频帧已被发布出去。**
 
 当您成功进入房间并通过 startLocalAudio 开启本地音频采集之后（开启采集和进入房间的先后顺序无影响），SDK 就会开始进行音频编码，并通过自身的网络模块向云端发布自己本地的音频数据。当 SDK 成功地向云端送出自己的第一帧音频数据帧以后，就会抛出 ` onSendFirstLocalAudioFrame ` 事件回调。
 
 ## onRemoteVideoStatusUpdated
 
-#### 远端视频状态变化的事件回调。
+**远端视频状态变化的事件回调。**
 
 您可以通过此事件回调获取远端每一路画面的播放状态（包括 Playing、Loading 和 Stopped 三种状态），从而进行相应的 UI 展示。
-| 参数 | 描述 |
-| --- | --- |
-| extrainfo | 额外信息。 |
-| reason | 视频状态改变的原因。 |
-| status | 视频状态：包括 Playing、Loading 和 Stopped 三种状态。 |
-| streamType | 视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。 |
-| userId | 用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|extrainfo|额外信息。|
+|reason|视频状态改变的原因。|
+|status|视频状态：包括 Playing、Loading 和 Stopped 三种状态。|
+|streamType|视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。|
+|userId|用户标识。|
 
 ## onRemoteAudioStatusUpdated
 
-#### 远端音频状态变化的事件回调。
+**远端音频状态变化的事件回调。**
 
 您可以通过此事件回调获取远端每一路音频的播放状态（包括 Playing、Loading 和 Stopped 三种状态），从而进行相应的 UI 展示。
-| 参数 | 描述 |
-| --- | --- |
-| extrainfo | 额外信息。 |
-| reason | 音频状态改变的原因。 |
-| status | 音频状态：包括 Playing、Loading 和 Stopped 三种状态。 |
-| userId | 用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|extrainfo|额外信息。|
+|reason|音频状态改变的原因。|
+|status|音频状态：包括 Playing、Loading 和 Stopped 三种状态。|
+|userId|用户标识。|
 
 ## onUserVideoSizeChanged
 
-#### 用户视频大小发生改变回调。
+**用户视频大小发生改变回调。**
 
 当您收到 ` onUserVideoSizeChanged(userId, streamType, newWidth, newHeight) ` 通知时，表示该路画面大小发生了调整，调整的原因可能是该用户调用了 setVideoEncoderParam 或者 setSubStreamEncoderParam 重新设置了画面尺寸。
-| 参数 | 描述 |
-| --- | --- |
-| newHeight | 视频流的高度（像素）。 |
-| newWidth | 视频流的宽度（像素）。 |
-| streamType | 视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。 |
-| userId | 用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|newHeight|视频流的高度（像素）。|
+|newWidth|视频流的宽度（像素）。|
+|streamType|视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。|
+|userId|用户标识。|
 
 ## onNetworkQuality
 
-#### 网络质量的实时统计回调。
+**网络质量的实时统计回调。**
 
 该统计回调每间隔2秒抛出一次，用于通知 SDK 感知到的当前网络的上行和下行质量。
 
 SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽大小以及稳定情况进行评估，并计算出一个评估结果：如果评估结果为 1（Excellent） 代表当前的网络情况非常好，如果评估结果为 6（Down）代表当前网络无法支撑 TRTC 的正常通话。
-| 参数 | 描述 |
-| --- | --- |
-| localQuality | 上行网络质量。 |
-| remoteQuality | 下行网络质量，代表数据流历经“远端->云端->本端”这样一条完整的传输链路后，最终在本端统计到的数据质量。因此，这里的下行网络质量代表的是远端上行链路与本端下行链路共同影响的结果。 |
+
+|参数|描述|
+|---------|---------|
+|localQuality|上行网络质量。|
+|remoteQuality|下行网络质量，代表数据流历经“远端->云端->本端”这样一条完整的传输链路后，最终在本端统计到的数据质量。因此，这里的下行网络质量代表的是远端上行链路与本端下行链路共同影响的结果。|
 
 > **注意**
 >
@@ -639,7 +667,7 @@ SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽
 
 ## onStatistics
 
-#### 音视频技术指标的实时统计回调。
+**音视频技术指标的实时统计回调。**
 
 该统计回调每间隔2秒抛出一次，用于通知 SDK 内部音频、视频以及网络相关的专业技术指标，这些信息在 TRTCStatistics 均有罗列：
 -  视频统计信息：视频的分辨率（resolution）、帧率（FPS）和比特率（bitrate）等信息。
@@ -648,9 +676,9 @@ SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽
 
 -  网络统计信息：SDK 和云端一次往返（SDK > Cloud > SDK）的网络耗时（rtt）、丢包率（loss）、上行流量（sentBytes）和下行流量（receivedBytes）等信息。
 
-| 参数 | 描述 |
-| --- | --- |
-| statistics | 统计数据，包括自己本地的统计信息和远端用户的统计信息，详情请参考 TRTCStatistics。 |
+|参数|描述|
+|---------|---------|
+|statistics|统计数据，包括自己本地的统计信息和远端用户的统计信息，详情请参考 TRTCStatistics。|
 
 > **注意**
 >
@@ -660,16 +688,17 @@ SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽
 
 ## onSpeedTestResult
 
-#### 网速测试的结果回调。
+**网速测试的结果回调。**
 
 该统计回调由 startSpeedTest 触发。
-| 参数 | 描述 |
-| --- | --- |
-| result | 网速测试结果，包括丢包、往返延迟、上下行的带宽速率，详情请参见 TRTCSpeedTestResult。 |
+
+|参数|描述|
+|---------|---------|
+|result|网速测试结果，包括丢包、往返延迟、上下行的带宽速率，详情请参见 TRTCSpeedTestResult。|
 
 ## onConnectionLost
 
-#### SDK 与云端的连接已经断开。
+**SDK 与云端的连接已经断开。**
 
 SDK 会在跟云端的连接断开时抛出此事件回调，导致断开的原因大多是网络不可用或者网络切换所致，例如用户在通话中走进电梯时就可能会遇到此事件。
 
@@ -679,19 +708,19 @@ SDK 会在跟云端的连接断开时抛出此事件回调，导致断开的原
 
 ## onTryToReconnect
 
-#### SDK 正在尝试重新连接到云端。
+**SDK 正在尝试重新连接到云端。**
 
 SDK 会在跟云端的连接断开时抛出 onConnectionLost，之后会努力跟云端重新建立连接并抛出本事件，连接恢复后会抛出 onConnectionRecovery。
 
 ## onConnectionRecovery
 
-#### SDK 与云端的连接已经恢复。
+**SDK 与云端的连接已经恢复。**
 
 SDK 会在跟云端的连接断开时抛出 onConnectionLost，之后会努力跟云端重新建立连接并抛出 onTryToReconnect，连接恢复后会抛出本事件回调。
 
 ## onCameraDidReady
 
-#### 摄像头准备就绪。
+**摄像头准备就绪。**
 
 当您调用 startLocalPreview 之后，SDK 会尝试启动摄像头，如果摄像头能够启动成功就会抛出本事件。
 
@@ -701,7 +730,7 @@ SDK 会在跟云端的连接断开时抛出 onConnectionLost，之后会努力
 
 ## onMicDidReady
 
-#### 麦克风准备就绪。
+**麦克风准备就绪。**
 
 当您调用 startLocalAudio 之后，SDK 会尝试启动麦克风，如果麦克风能够启动成功就会抛出本事件。
 
@@ -711,7 +740,7 @@ SDK 会在跟云端的连接断开时抛出 onConnectionLost，之后会努力
 
 ## onAudioRouteChanged
 
-#### 当前音频路由发生变化（仅适用于移动设备）。
+**当前音频路由发生变化（仅适用于移动设备）。**
 
 所谓“音频路由”，是指声音是从手机的扬声器还是从听筒中播放出来，音频路由变化也就是声音的播放位置发生了变化。
 -  当音频路由为听筒时，声音比较小，只有将耳朵凑近才能听清楚，隐私性较好，适合用于接听电话。
@@ -724,24 +753,25 @@ SDK 会在跟云端的连接断开时抛出 onConnectionLost，之后会努力
 
 -  当音频路由为USB专业声卡设备。
 
-| 参数 | 描述 |
-| --- | --- |
-| fromRoute | 变更前的音频路由。 |
-| route | 音频路由，即声音由哪里输出（扬声器、听筒）。 |
+|参数|描述|
+|---------|---------|
+|fromRoute|变更前的音频路由。|
+|route|音频路由，即声音由哪里输出（扬声器、听筒）。|
 
 ## onUserVoiceVolume
 
-#### 音量大小的反馈回调。
+**音量大小的反馈回调。**
 
 SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该事件回调，您可以根据音量大小在 UI 上做出相应的提示，例如` 波形图 `或` 音量槽 `。
 
 要完成这个功能， 您需要先调用 enableAudioVolumeEvaluation 开启这个能力并设定事件抛出的时间间隔。
 
 需要补充说明的是，无论当前房间中是否有人说话，SDK 都会按照您设定的时间间隔定时抛出此事件回调。
-| 参数 | 描述 |
-| --- | --- |
-| totalVolume | 所有远端用户的总音量大小，取值范围 [0, 100]。 |
-| userVolumes | 是一个数组，用于承载所有正在说话的用户的音量大小，取值范围 [0, 100]。 |
+
+|参数|描述|
+|---------|---------|
+|totalVolume|所有远端用户的总音量大小，取值范围 [0, 100]。|
+|userVolumes|是一个数组，用于承载所有正在说话的用户的音量大小，取值范围 [0, 100]。|
 
 > **注意**
 >
@@ -751,29 +781,31 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 ## onRecvCustomCmdMsg
 
-#### 收到自定义消息的事件回调。
+**收到自定义消息的事件回调。**
 
 当房间中的某个用户使用 sendCustomCmdMsg 发送自定义 UDP 消息时，房间中的其他用户可以通过 ` onRecvCustomCmdMsg ` 事件回调接收到该条消息。
-| 参数 | 描述 |
-| --- | --- |
-| cmdID | 命令 ID。 |
-| message | 消息数据。 |
-| seq | 消息序号。 |
-| userId | 用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|cmdID|命令 ID。|
+|message|消息数据。|
+|seq|消息序号。|
+|userId|用户标识。|
 
 ## onMissCustomCmdMsg
 
-#### 自定义消息丢失的事件回调。
+**自定义消息丢失的事件回调。**
 
 当您使用 sendCustomCmdMsg 发送自定义 UDP 消息时，即使设置了可靠传输（reliable），也无法确 100% 不丢失，只是丢消息概率极低，能满足常规可靠性要求。
 
 在发送端设置了可靠运输（reliable）后，SDK 都会通过此回调通知过去时间段内（通常为5s）传输途中丢失的自定义消息数量统计信息。
-| 参数 | 描述 |
-| --- | --- |
-| cmdID | 命令 ID。 |
-| errCode | 错误码。 |
-| missed | 丢失的消息数量。 |
-| userId | 用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|cmdID|命令 ID。|
+|errCode|错误码。|
+|missed|丢失的消息数量。|
+|userId|用户标识。|
 
 > **注意**
 >
@@ -783,47 +815,51 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 ## onRecvSEIMsg
 
-#### 收到 SEI 消息的回调。
+**收到 SEI 消息的回调。**
 
 当房间中的某个用户使用 sendSEIMsg 借助视频数据帧发送 SEI 消息时，房间中的其他用户可以通过 ` onRecvSEIMsg ` 事件回调接收到该条消息。
-| 参数 | 描述 |
-| --- | --- |
-| message | 数据。 |
-| userId | 用户标识。 |
+
+|参数|描述|
+|---------|---------|
+|message|数据。|
+|userId|用户标识。|
 
 ## onStartPublishing
 
-#### 开始向腾讯云直播 CDN 上发布音视频流的事件回调。
+**开始向腾讯云直播 CDN 上发布音视频流的事件回调。**
 
 当您调用 startPublishing 开始向腾讯云直播 CDN 上发布音视频流时，SDK 会立刻将这一指令同步给云端服务器。
 
 随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
-| 参数 | 描述 |
-| --- | --- |
-| err | 0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 具体错误原因。 |
+
+|参数|描述|
+|---------|---------|
+|err|0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|具体错误原因。|
 
 ## onStopPublishing
 
-#### 停止向腾讯云直播 CDN 上发布音视频流的事件回调。
+**停止向腾讯云直播 CDN 上发布音视频流的事件回调。**
 
 当您调用 stopPublishing 停止向腾讯云直播 CDN 上发布音视频流时，SDK 会立刻将这一指令同步给云端服务器。
 
 随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
-| 参数 | 描述 |
-| --- | --- |
-| err | 0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 具体错误原因。 |
+
+|参数|描述|
+|---------|---------|
+|err|0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|具体错误原因。|
 
 ## onStartPublishCDNStream
 
-#### 开始向非腾讯云 CDN 上发布音视频流的事件回调。
+**开始向非腾讯云 CDN 上发布音视频流的事件回调。**
 
 当您调用 startPublishCDNStream 开始向非腾讯云直播 CDN 上发布音视频流时，SDK 会立刻将这一指令同步给云端服务器。随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
-| 参数 | 描述 |
-| --- | --- |
-| err | 0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 具体错误原因。 |
+
+|参数|描述|
+|---------|---------|
+|err|0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|具体错误原因。|
 
 > **注意**
 >
@@ -833,63 +869,65 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 ## onStopPublishCDNStream
 
-#### 停止向非腾讯云 CDN 上发布音视频流的事件回调。
+**停止向非腾讯云 CDN 上发布音视频流的事件回调。**
 
 当您调用 stopPublishCDNStream 开始向非腾讯云直播 CDN 上发布音视频流时，SDK 会立刻将这一指令同步给云端服务器。随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
-| 参数 | 描述 |
-| --- | --- |
-| err | 0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 具体错误原因。 |
+
+|参数|描述|
+|---------|---------|
+|err|0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|具体错误原因。|
 
 ## onSetMixTranscodingConfig
 
-#### 设置云端混流的排版布局和转码参数的事件回调。
+**设置云端混流的排版布局和转码参数的事件回调。**
 
 当您调用 setMixTranscodingConfig 调整云端混流的排版布局和转码参数时，SDK 会立刻将这一调整指令同步给云端服务器。随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
-| 参数 | 描述 |
-| --- | --- |
-| err | 错误码：0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| errMsg | 具体的错误原因。 |
+
+|参数|描述|
+|---------|---------|
+|err|错误码：0表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。|
+|errMsg|具体的错误原因。|
 
 ## onStartPublishMediaStream
 
-#### 开始发布媒体流的事件回调。
+**开始发布媒体流的事件回调。**
 
 当您调用 startPublishMediaStream 开始向 TRTC 后台服务发布媒体流时，SDK 会立刻将这一指令同步给云端服务器，随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
 | 参数 | 描述 |
 | --- | --- |
-| code | 回调结果，0 表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| extraInfo | 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题。<br>当 code 返回值为 ERR_SERVER_PROCESS_FAILED 时，意味着服务器无法处理您的请求，此时可使用"error_code"做为 key 获取到服务器返回的错误码，具体的错误码以及建议处理措施说明如下：<br>-  2000: 参数错误，建议检查请求参数<br>-  2001: 未开通直播服务，建议去直播控制台开通直播服务<br>-  2021: 未开通转推第三方服务，建议联系产品开通转推第三方服务<br>-  3000: 服务器内部错误，建议重试<br>-  4006: 同一个任务并发冲突，上一个 startPublishMediaStream 任务服务器还在处理中，建议延迟重试<br>-  4007: 同一个任务已经通过 startPublishMediaStream 启动成功，建议使用返回的 taskId 调用 updatePublishMediaStream 接口更新任务<br>-  5001: 资源受限，建议延迟重试 |
+| code | 回调结果，0 表示成功，其余值表示失败，详见<a href="https://cloud.tencent.com/document/product/647/32257">错误码</a>。 |
+| extraInfo | 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题。<br>当 code 返回值为 ERR_SERVER_PROCESS_FAILED 时，意味着服务器无法处理您的请求，此时可使用“error_code” 作为 key 获取到服务器返回的错误码，具体的错误码以及建议处理措施说明如下：<br>-  2000: 参数错误，建议检查请求参数<br>-  2001: 未开通直播服务，建议去直播控制台开通直播服务<br>-  2021: 未开通转推第三方服务，建议联系产品开通转推第三方服务<br>-  3000: 服务器内部错误，建议重试<br>-  4006: 同一个任务并发冲突，上一个 startPublishMediaStream 任务服务器还在处理中，建议延迟重试<br>-  4007: 同一个任务已经通过 startPublishMediaStream 启动成功，建议使用返回的 taskId 调用 updatePublishMediaStream 接口更新任务<br>-  5001: 资源受限，建议延迟重试 |
 | message | 具体回调信息。 |
 | taskId | 当请求成功时，TRTC 后台会在回调中提供给您这项任务的 taskId，后续您可以通过该 taskId 结合 updatePublishMediaStream 和 stopPublishMediaStream 进行更新和停止。 |
 
 ## onUpdatePublishMediaStream
 
-#### 更新媒体流的事件回调。
+**更新媒体流的事件回调。**
 
 当您调用媒体流发布接口 (updatePublishMediaStream) 开始向 TRTC 后台服务更新媒体流时，SDK 会立刻将这一指令同步给云端服务器，随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
 | 参数 | 描述 |
 | --- | --- |
-| code | 回调结果，0 表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| extraInfo | 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题。<br>当 code 返回值为 ERR_SERVER_PROCESS_FAILED 时，意味着服务器无法处理您的请求，此时可使用"error_code"做为 key 获取到服务器返回的错误码，具体的错误码以及建议处理措施说明如下：<br>-  2000: 参数错误，建议检查请求参数<br>-  2001: 未开通直播服务，建议去直播控制台开通直播服务<br>-  2002: 找不到任务，建议调用 startPublishMediaStream 接口重新启动任务<br>-  2018: 并发请求乱序，建议使用最新混流参数重试<br>-  2021: 未开通转推第三方服务，建议联系产品开通转推第三方服务<br>-  3000: 服务器内部错误，建议重试<br>-  4003: 任务正在退出中，建议先调用 stopPublishMediaStream 接口停止任务，再调用 startPublishMediaStream 接口启动任务 |
+| code | 回调结果，0 表示成功，其余值表示失败，详见<a href="https://cloud.tencent.com/document/product/647/32257">错误码</a>。 |
+| extraInfo | 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题。<br>当 code 返回值为 ERR_SERVER_PROCESS_FAILED 时，意味着服务器无法处理您的请求，此时可使用“error_code” 作为 key 获取到服务器返回的错误码，具体的错误码以及建议处理措施说明如下：<br>-  2000: 参数错误，建议检查请求参数<br>-  2001: 未开通直播服务，建议去直播控制台开通直播服务<br>-  2002: 找不到任务，建议调用 startPublishMediaStream 接口重新启动任务<br>-  2018: 并发请求乱序，建议使用最新混流参数重试<br>-  2021: 未开通转推第三方服务，建议联系产品开通转推第三方服务<br>-  3000: 服务器内部错误，建议重试<br>-  4003: 任务正在退出中，建议先调用 stopPublishMediaStream 接口停止任务，再调用 startPublishMediaStream 接口启动任务 |
 | message | 具体回调信息。 |
 | taskId | 您调用媒体流发布接口 (updatePublishMediaStream) 时传入的 taskId，会通过此回调再带回给您，用于标识该回调属于哪一次更新请求。 |
 
 ## onStopPublishMediaStream
 
-#### 停止媒体流的事件回调。
+**停止媒体流的事件回调。**
 
 当您调用停止发布媒体流 (stopPublishMediaStream) 开始向 TRTC 后台服务停止媒体流时，SDK 会立刻将这一指令同步给云端服务器，随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
 | 参数 | 描述 |
 | --- | --- |
-| code | 回调结果，0 表示成功，其余值表示失败，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
-| extraInfo | 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题。<br>当 code 返回值为 ERR_SERVER_PROCESS_FAILED 时，意味着服务器无法处理您的请求，此时可使用"error_code"做为 key 获取到服务器返回的错误码，具体的错误码以及建议处理措施说明如下：<br>-  2000: 参数错误，建议检查请求参数<br>-  2002: 找不到任务，无需处理<br>-  3000: 服务器内部错误，建议重试<br>-  4003: 任务正在退出中，无需处理 |
+| code | 回调结果，0 表示成功，其余值表示失败，详见<a href="https://cloud.tencent.com/document/product/647/32257">错误码</a>。 |
+| extraInfo | 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题。<br>当 code 返回值为 ERR_SERVER_PROCESS_FAILED 时，意味着服务器无法处理您的请求，此时可使用“error_code” 作为 key 获取到服务器返回的错误码，具体的错误码以及建议处理措施说明如下：<br>-  2000: 参数错误，建议检查请求参数<br>-  2002: 找不到任务，无需处理<br>-  3000: 服务器内部错误，建议重试<br>-  4003: 任务正在退出中，无需处理 |
 | message | 具体回调信息。 |
 | taskId | 您调用停止发布媒体流 (stopPublishMediaStream) 时传入的 taskId，会通过此回调再带回给您，用于标识该回调属于哪一次停止请求。 |
 
 ## onCdnStreamStateChanged
 
-#### RTMP/RTMPS 推流状态发生改变回调。
+**RTMP/RTMPS 推流状态发生改变回调。**
 
 当您调用 startPublishMediaStream 开始向 TRTC 后台服务发布媒体流时，SDK 会立刻将这一指令同步给云端服务。
 
@@ -897,41 +935,42 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 | 参数 | 描述 |
 | --- | --- |
 | cdnUrl | 您调用 startPublishMediaStream 时通过目标推流配置 (TRTCPublishTarget) 传入的 url，在推流状态变更时，会通过此回调同步给您。 |
-| code | 推流结果，0 表示成功，其余值表示出错，详见[错误码](https://cloud.tencent.com/document/product/647/32257)。 |
+| code | 推流结果，0 表示成功，其余值表示出错，详见<a href="https://cloud.tencent.com/document/product/647/32257">错误码</a>。 |
 | extraInfo | 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题。 |
 | message | 具体推流信息。 |
 | status | 推流状态。<br>-  0：推流未开始或者已结束。在您调用 stopPublishMediaStream 时会返回该状态。<br>-  1：正在连接 TRTC 服务器和 CDN 服务器。若无法立刻成功，TRTC 后台服务会多次重试尝试推流，并返回该状态（5s回调一次）。如成功进行推流，则进入状态 2；如服务器出错或 60 秒内未成功推流，则进入状态 4。<br>-  2：CDN 推流正在进行。在成功推流后，会返回该状态。<br>-  3：TRTC 服务器和 CDN 服务器推流中断，正在恢复。当 CDN 出现异常，或推流短暂中断时，TRTC 后台服务会自动尝试恢复推流，并返回该状态（5s回调一次）。如成功恢复推流，则进入状态 2；如服务器出错或 60 秒内未成功恢复，则进入状态 4。<br>-  4：TRTC 服务器和 CDN 服务器推流中断，且恢复或连接超时。即此时推流失败，您可以再次调用 updatePublishMediaStream 尝试推流。<br>-  5：正在断开 TRTC 服务器和 CDN 服务器。在您调用 stopPublishMediaStream 时，TRTC 后台服务会依次同步状态 5 和状态 0。 |
 
 ## onScreenCaptureStarted
 
-#### 屏幕分享开启的事件回调。
+**屏幕分享开启的事件回调。**
 
 当您通过 startScreenCapture 等相关接口启动屏幕分享时，SDK 便会抛出此事件回调。
 
 ## onScreenCapturePaused
 
-#### 屏幕分享暂停的事件回调。
+**屏幕分享暂停的事件回调。**
 
 当您通过 pauseScreenCapture 暂停屏幕分享时，SDK 便会抛出此事件回调。
 
 ## onScreenCaptureResumed
 
-#### 屏幕分享恢复的事件回调。
+**屏幕分享恢复的事件回调。**
 
 当您通过 resumeScreenCapture 恢复屏幕分享时，SDK 便会抛出此事件回调。
 
 ## onScreenCaptureStopped
 
-#### 屏幕分享停止的事件回调。
+**屏幕分享停止的事件回调。**
 
 当您通过 stopScreenCapture 停止屏幕分享时，SDK 便会抛出此事件回调。
-| 参数 | 描述 |
-| --- | --- |
-| reason | 停止原因，0：用户主动停止；1：屏幕窗口关闭导致停止；2：表示屏幕分享的显示屏状态变更（如接口被拔出、投影模式变更等）。 |
+
+|参数|描述|
+|---------|---------|
+|reason|停止原因，0：用户主动停止；1：屏幕窗口关闭导致停止；2：表示屏幕分享的显示屏状态变更（如接口被拔出、投影模式变更等）。|
 
 ## onLocalRecordBegin
 
-#### 本地录制任务已经开始的事件回调。
+**本地录制任务已经开始的事件回调。**
 
 当您调用 startLocalRecording 启动本地媒体录制任务时，SDK 会抛出该事件回调，用于通知您录制任务是否已经顺利启动。
 | 参数 | 描述 |
@@ -941,30 +980,32 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 ## onLocalRecording
 
-#### 本地录制任务正在进行中的进展事件回调。
+**本地录制任务正在进行中的进展事件回调。**
 
 当您调用 startLocalRecording 成功启动本地媒体录制任务后，SDK 会定时地抛出本事件回调。
 
 您可通过捕获该事件回调来获知录制任务的健康状况。
 
 您可以在 startLocalRecording 时设定本事件回调的抛出间隔。
-| 参数 | 描述 |
-| --- | --- |
-| duration | 已经录制的累计时长，单位毫秒。 |
-| storagePath | 录制文件存储路径。 |
+
+|参数|描述|
+|---------|---------|
+|duration|已经录制的累计时长，单位毫秒。|
+|storagePath|录制文件存储路径。|
 
 ## onLocalRecordFragment
 
-#### 本地录制分片的事件回调。
+**本地录制分片的事件回调。**
 
 当您开启分片录制时，每完成一个分片，都会通过此接口回调。
-| 参数 | 描述 |
-| --- | --- |
-| storagePath | 分片文件存储路径。 |
+
+|参数|描述|
+|---------|---------|
+|storagePath|分片文件存储路径。|
 
 ## onLocalRecordComplete
 
-#### 本地录制任务已经结束的事件回调。
+**本地录制任务已经结束的事件回调。**
 
 当您调用 stopLocalRecording 停止本地媒体录制任务时，SDK 会抛出该事件回调，用于通知您录制任务的最终结果。
 | 参数 | 描述 |
@@ -974,17 +1015,18 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 ## onSnapshotComplete
 
-#### 本地截图完成的事件回调。
-| 参数 | 描述 |
-| --- | --- |
-| bmp | 截图结果，如果 bmp 为 null 代表本次截图操作失败。 |
-| data | 截图数据，为 nullptr 表示截图失败。 |
-| format | 截图数据格式，目前只支持 TRTCVideoPixelFormat_BGRA32。 |
-| height | 截图画面的高度。 |
-| length | 截图数据长度，对于BGRA32而言，` length = width * height * 4 `。 |
-| type | 视频流类型。 |
-| userId | 用户标识，如果 userId 为空字符串，则代表截取的是本地画面。 |
-| width | 截图画面的宽度。 |
+**本地截图完成的事件回调。**
+
+|参数|描述|
+|---------|---------|
+|bmp|截图结果，如果 bmp 为 null 代表本次截图操作失败。|
+|data|截图数据，为 nullptr 表示截图失败。|
+|format|截图数据格式，目前只支持 TRTCVideoPixelFormat_BGRA32。|
+|height|截图画面的高度。|
+|length|截图数据长度，对于BGRA32而言，` length = width * height * 4 `。|
+|type|视频流类型。|
+|userId|用户标识，如果 userId 为空字符串，则代表截取的是本地画面。|
+|width|截图画面的宽度。|
 
 > **注意**
 >
@@ -992,21 +1034,25 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 > 全平台 C++ 接口和 Java 接口在参数上是不一样的，C++ 接口用 7 个参数描述一个截图画面，Java 接口只用一个 Bitmap 描述一个截图画面。
 >
 
+## onExperimentalEvent
+
+**实验性接口的事件回调。**
+
 ## onUserEnter
 
-#### 有主播加入当前房间（已废弃）。
+**有主播加入当前房间（已废弃）。**
 
 @deprecated 新版本开始不推荐使用，建议使用 onRemoteUserEnterRoom 替代之。
 
 ## onUserExit
 
-#### 有主播离开当前房间（已废弃）。
+**有主播离开当前房间（已废弃）。**
 
 @deprecated 新版本开始不推荐使用，建议使用 onRemoteUserLeaveRoom 替代之。
 
 ## onAudioEffectFinished
 
-#### 音效播放已结束（已废弃）。
+**音效播放已结束（已废弃）。**
 
 @deprecated 新版本开始不推荐使用，建议使用 TXAudioEffectManager 接口替代之。
 
@@ -1014,6 +1060,6 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 ## onSpeedTest
 
-#### 服务器测速的结果回调（已废弃）。
+**服务器测速的结果回调（已废弃）。**
 
 @deprecated 新版本开始不推荐使用，建议使用 onSpeedTestResult 接口替代之。