@tencentcloud/sdk-mcp 1.6.4 → 1.6.5

package/resource/knowledge/trtc/ios/TRTCCloudDelegate.md

@@ -131,7 +131,7 @@ Function: 腾讯云实时音视频的事件回调接口
 
 **进入房间成功与否的事件回调。**
 
-调用 TRTCCloud 中的 enterRoom 接口执行进房操作后，会收到来自 TRTCCloudDelegate 的 ` onEnterRoom(result) ` 回调：
+调用 TRTCCloud 中的 enterRoom 接口执行进房操作后，会收到来自 TRTCCloudDelegate 的  `onEnterRoom(result)`  回调：
 -  如果加入成功，回调 result 会是一个正数（result > 0），代表进入房间所消耗的时间，单位是毫秒（ms）。
 
 -  如果加入失败，回调 result 会是一个负数（result < 0），代表失败原因的错误码。
@@ -144,11 +144,9 @@ Function: 腾讯云实时音视频的事件回调接口
 
 > **注意**
 >
-
-> 1. 在 Ver6.6 之前的版本，只有进房成功会抛出 ` onEnterRoom(result) ` 回调，进房失败由 onError 回调抛出。
+> 1. 在 Ver6.6 之前的版本，只有进房成功会抛出  `onEnterRoom(result)`  回调，进房失败由 onError 回调抛出。
 >
-
-> 2. 在 Ver6.6 之后的版本：无论进房成功或失败，均会抛出 ` onEnterRoom(result) ` 回调，同时进房失败也会有 onError 回调抛出。
+> 2. 在 Ver6.6 之后的版本：无论进房成功或失败，均会抛出  `onEnterRoom(result)`  回调，同时进房失败也会有 onError 回调抛出。
 >
 
 ## onExitRoom:
@@ -157,9 +155,9 @@ Function: 腾讯云实时音视频的事件回调接口
 
 调用 TRTCCloud 中的 exitRoom 接口会执行退出房间的相关逻辑，例如释放音视频设备资源和编解码器资源等。
 
-待 SDK 占用的所有资源释放完毕后，SDK 会抛出 ` onExitRoom() ` 回调通知到您。
+待 SDK 占用的所有资源释放完毕后，SDK 会抛出  `onExitRoom()`  回调通知到您。
 
-如果您要再次调用 enterRoom 或者切换到其他的音视频 SDK，请等待 ` onExitRoom ` 回调到来后再执行相关操作。否则可能会遇到例如摄像头、麦克风设备被强占等各种异常问题。
+如果您要再次调用 enterRoom 或者切换到其他的音视频 SDK，请等待  `onExitRoom`  回调到来后再执行相关操作。否则可能会遇到例如摄像头、麦克风设备被强占等各种异常问题。
 
 |参数|描述|
 |---------|---------|
@@ -169,7 +167,7 @@ Function: 腾讯云实时音视频的事件回调接口
 
 **切换角色的事件回调。**
 
-调用 TRTCCloud 中的 switchRole 接口会切换主播和观众的角色，该操作会伴随一个线路切换的过程，待 SDK 切换完成后，会抛出 ` onSwitchRole() ` 事件回调。
+调用 TRTCCloud 中的 switchRole 接口会切换主播和观众的角色，该操作会伴随一个线路切换的过程，待 SDK 切换完成后，会抛出  `onSwitchRole()`  事件回调。
 
 |参数|描述|
 |---------|---------|
@@ -180,7 +178,7 @@ Function: 腾讯云实时音视频的事件回调接口
 
 **切换房间的结果回调。**
 
-调用 TRTCCloud 中的 switchRoom 接口可以让用户快速地从一个房间切换到另一个房间，待 SDK 切换完成后，会抛出 ` onSwitchRoom() ` 事件回调。
+调用 TRTCCloud 中的 switchRoom 接口可以让用户快速地从一个房间切换到另一个房间，待 SDK 切换完成后，会抛出  `onSwitchRoom()`  事件回调。
 
 |参数|描述|
 |---------|---------|
@@ -193,7 +191,7 @@ Function: 腾讯云实时音视频的事件回调接口
 
 调用 TRTCCloud 中的 connectOtherRoom 接口会将两个不同房间中的主播拉通视频通话，也就是所谓的“主播PK”功能。
 
-调用者会收到 ` onConnectOtherRoom() ` 回调来获知跨房通话是否成功。
+调用者会收到  `onConnectOtherRoom()`  回调来获知跨房通话是否成功。
 
 |参数|描述|
 |---------|---------|
@@ -207,7 +205,7 @@ Function: 腾讯云实时音视频的事件回调接口
 
 调用 TRTCCloud 中的 disConnectOtherRoom 接口会结束两个不同房间中的主播视频通话，也就是所谓的“主播PK”功能。
 
-调用者会收到 ` onDisconnectOtherRoom() ` 回调来获知结束跨房通话是否成功。
+调用者会收到  `onDisconnectOtherRoom()`  回调来获知结束跨房通话是否成功。
 
 |参数|描述|
 |---------|---------|
@@ -220,7 +218,7 @@ Function: 腾讯云实时音视频的事件回调接口
 
 调用 TRTCCloud 中的 updateOtherRoomForwardMode 接口会限制跨房主播在本房间内的上行能力，禁止或允许跨房主播发布音频/主路视频/辅路视频，该行为会影响房间内的所有用户。
 
-调用者会收到 ` onUpdateOtherRoomForwardMode() ` 回调来获知更改跨房主播上行能力是否成功。
+调用者会收到  `onUpdateOtherRoomForwardMode()`  回调来获知更改跨房主播上行能力是否成功。
 
 |参数|描述|
 |---------|---------|
@@ -231,7 +229,7 @@ Function: 腾讯云实时音视频的事件回调接口
 
 **有用户加入当前房间。**
 
-出于性能方面的考虑，在 TRTC 两种不同的应用场景（即 ` AppScene `，在 enterRoom 时通过第二个参数指定）下，该通知的行为会有差别：
+出于性能方面的考虑，在 TRTC 两种不同的应用场景（即  `AppScene` ，在 enterRoom 时通过第二个参数指定）下，该通知的行为会有差别：
 -  直播类场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom）：该场景下的用户区分主播和观众两种角色，只有主播进入房间时才会触发该通知，观众进入房间时不会触发该通知。
 
 -  通话类场景（TRTCAppSceneVideoCall 和 TRTCAppSceneAudioCall）：该场景下的用户没有角色的区分（可认为都是主播），任何用户进入房间都会触发该通知。
@@ -242,10 +240,8 @@ Function: 腾讯云实时音视频的事件回调接口
 
 > **注意**
 >
-
-> 1. 事件回调 ` onRemoteUserEnterRoom ` 和 onRemoteUserLeaveRoom 只适用于维护当前房间里的“用户列表”，有此事件回调不代表一定有视频画面。
+> 1. 事件回调  `onRemoteUserEnterRoom`  和 onRemoteUserLeaveRoom 只适用于维护当前房间里的“用户列表”，有此事件回调不代表一定有视频画面。
 >
-
 > 2. 如果需要显示远程画面，请监听代表某个用户是否有视频画面的 onUserVideoAvailable 事件回调。
 >
 
@@ -267,11 +263,11 @@ Function: 腾讯云实时音视频的事件回调接口
 
 **某远端用户发布/取消了主路视频画面。**
 
-**主路画面** 一般被用于承载摄像头画面。当您收到 ` onUserVideoAvailable(userId, YES) ` 通知时，表示该路画面已经有可播放的视频帧到达。
+**主路画面** 一般被用于承载摄像头画面。当您收到  `onUserVideoAvailable(userId, YES)`  通知时，表示该路画面已经有可播放的视频帧到达。
 
-此时，您需要调用 startRemoteView 接口订阅该用户的远程画面，订阅成功后，您会继续收到该用户的首帧画面渲染回调 ` onFirstVideoFrame(userId) `。
+此时，您需要调用 startRemoteView 接口订阅该用户的远程画面，订阅成功后，您会继续收到该用户的首帧画面渲染回调  `onFirstVideoFrame(userId)` 。
 
-当您收到 ` onUserVideoAvailable(userId, NO) ` 通知时，表示该路远程画面已经被关闭，关闭的原因可能是该用户调用了 muteLocalVideo 或 stopLocalPreview。
+当您收到  `onUserVideoAvailable(userId, NO)`  通知时，表示该路远程画面已经被关闭，关闭的原因可能是该用户调用了 muteLocalVideo 或 stopLocalPreview。
 
 |参数|描述|
 |---------|---------|
@@ -282,9 +278,9 @@ Function: 腾讯云实时音视频的事件回调接口
 
 **某远端用户发布/取消了辅路视频画面。**
 
-“辅路画面”一般被用于承载屏幕分享的画面。当您收到 ` onUserSubStreamAvailable(userId, YES) ` 通知时，表示该路画面已经有可播放的视频帧到达。
+“辅路画面”一般被用于承载屏幕分享的画面。当您收到  `onUserSubStreamAvailable(userId, YES)`  通知时，表示该路画面已经有可播放的视频帧到达。
 
-此时，您需要调用 startRemoteView 接口订阅该用户的远程画面，订阅成功后，您会继续收到该用户的首帧画面渲染回调 ` onFirstVideoFrame(userId) `。
+此时，您需要调用 startRemoteView 接口订阅该用户的远程画面，订阅成功后，您会继续收到该用户的首帧画面渲染回调  `onFirstVideoFrame(userId)` 。
 
 |参数|描述|
 |---------|---------|
@@ -293,7 +289,6 @@ Function: 腾讯云实时音视频的事件回调接口
 
 > **注意**
 >
-
 > 显示辅路画面使用的函数是 startRemoteView 而非 startRemoteSubStreamView，startRemoteSubStreamView 已经被废弃。
 >
 
@@ -301,7 +296,7 @@ Function: 腾讯云实时音视频的事件回调接口
 
 **某远端用户发布/取消了自己的音频。**
 
-当您收到 ` onUserAudioAvailable(userId, YES) ` 通知时，表示该用户发布了自己的声音，此时 SDK 的表现为：
+当您收到  `onUserAudioAvailable(userId, YES)`  通知时，表示该用户发布了自己的声音，此时 SDK 的表现为：
 -  在自动订阅模式下，您无需做任何操作，SDK 会自动播放该用户的声音。
 
 -  在手动订阅模式下，您可以通过 muteRemoteAudio(userid, NO) 来播放该用户的声音。
@@ -313,7 +308,6 @@ Function: 腾讯云实时音视频的事件回调接口
 
 > **注意**
 >
-
 > SDK 默认使用自动订阅模式，您可以通过 setDefaultStreamRecvMode 设置为手动订阅，但需要在您进入房间之前调用才生效。
 >
 
@@ -335,10 +329,8 @@ SDK 会在渲染自己本地或远端用户的首帧画面时抛出该事件，
 
 > **注意**
 >
-
 > 1. 只有当您调用了 startLocalPreview 或 startScreenCapture 之后，才会触发自己本地的首帧画面事件回调。
 >
-
 > 2. 只有当您调用了 startRemoteView 或 startRemoteSubStreamView 之后，才会触发远端用户的首帧画面事件回调。
 >
 
@@ -356,7 +348,7 @@ SDK 会在播放远端用户的首帧音频时抛出该事件，本地音频的
 
 **自己本地的首个视频帧已被发布出去。**
 
-当您成功进入房间并通过 startLocalPreview 或 startScreenCapture 开启本地视频采集之后（开启采集和进入房间的先后顺序无影响），SDK 就会开始进行视频编码，并通过自身的网络模块向云端发布自己本地的视频数据。当 SDK 成功地向云端送出自己的第一帧视频数据帧以后，就会抛出 ` onSendFirstLocalVideoFrame ` 事件回调。
+当您成功进入房间并通过 startLocalPreview 或 startScreenCapture 开启本地视频采集之后（开启采集和进入房间的先后顺序无影响），SDK 就会开始进行视频编码，并通过自身的网络模块向云端发布自己本地的视频数据。当 SDK 成功地向云端送出自己的第一帧视频数据帧以后，就会抛出  `onSendFirstLocalVideoFrame`  事件回调。
 
 |参数|描述|
 |---------|---------|
@@ -366,7 +358,7 @@ SDK 会在播放远端用户的首帧音频时抛出该事件，本地音频的
 
 **自己本地的首个音频帧已被发布出去。**
 
-当您成功进入房间并通过 startLocalAudio 开启本地音频采集之后（开启采集和进入房间的先后顺序无影响），SDK 就会开始进行音频编码，并通过自身的网络模块向云端发布自己本地的音频数据。当 SDK 成功地向云端送出自己的第一帧音频数据帧以后，就会抛出 ` onSendFirstLocalAudioFrame ` 事件回调。
+当您成功进入房间并通过 startLocalAudio 开启本地音频采集之后（开启采集和进入房间的先后顺序无影响），SDK 就会开始进行音频编码，并通过自身的网络模块向云端发布自己本地的音频数据。当 SDK 成功地向云端送出自己的第一帧音频数据帧以后，就会抛出  `onSendFirstLocalAudioFrame`  事件回调。
 
 ## onRemoteVideoStatusUpdated:streamType:streamStatus:reason:extrainfo:
 
@@ -399,7 +391,7 @@ SDK 会在播放远端用户的首帧音频时抛出该事件，本地音频的
 
 **用户视频大小发生改变回调。**
 
-当您收到 ` onUserVideoSizeChanged(userId, streamType, newWidth, newHeight) ` 通知时，表示该路画面大小发生了调整，调整的原因可能是该用户调用了 setVideoEncoderParam 或者 setSubStreamEncoderParam 重新设置了画面尺寸。
+当您收到  `onUserVideoSizeChanged(userId, streamType, newWidth, newHeight)`  通知时，表示该路画面大小发生了调整，调整的原因可能是该用户调用了 setVideoEncoderParam 或者 setSubStreamEncoderParam 重新设置了画面尺寸。
 
 |参数|描述|
 |---------|---------|
@@ -412,20 +404,14 @@ SDK 会在播放远端用户的首帧音频时抛出该事件，本地音频的
 
 **网络质量的实时统计回调。**
 
-该统计回调每间隔2秒抛出一次，用于通知 SDK 感知到的当前网络的上行和下行质量。
+该统计回调每间隔2秒抛出一次，用于通知 SDK 感知到的本端用户与远端用户的上行质量。
 
 SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽大小以及稳定情况进行评估，并计算出一个评估结果：如果评估结果为 1（Excellent） 代表当前的网络情况非常好，如果评估结果为 6（Down）代表当前网络无法支撑 TRTC 的正常通话。
 
 |参数|描述|
 |---------|---------|
-|localQuality|上行网络质量。|
-|remoteQuality|下行网络质量，代表数据流历经“远端->云端->本端”这样一条完整的传输链路后，最终在本端统计到的数据质量。因此，这里的下行网络质量代表的是远端上行链路与本端下行链路共同影响的结果。|
-
-> **注意**
->
-
-> 暂时无法通过该接口单独判定远端用户的上行质量。
->
+|localQuality|本端用户的上行网络质量。|
+|remoteQuality|远端用户的上行网络质量。|
 
 ## onStatistics:
 
@@ -444,7 +430,6 @@ SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽
 
 > **注意**
 >
-
 > 如果您只需要获知当前网络质量的好坏，并不需要花太多时间研究本统计回调，更推荐您使用 onNetworkQuality 来解决问题。
 >
 
@@ -524,7 +509,7 @@ SDK 会在跟云端的连接断开时抛出 onConnectionLost，之后会努力
 
 **音量大小的反馈回调。**
 
-SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该事件回调，您可以根据音量大小在 UI 上做出相应的提示，例如` 波形图 `或` 音量槽 `。
+SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该事件回调，您可以根据音量大小在 UI 上做出相应的提示，例如 `波形图` 或 `音量槽` 。
 
 要完成这个功能， 您需要先调用 enableAudioVolumeEvaluation 开启这个能力并设定事件抛出的时间间隔。
 
@@ -537,7 +522,6 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 > **注意**
 >
-
 > userVolumes 为一个数组，对于数组中的每一个元素，当 userId 为空时表示本地麦克风采集的音量大小，当 userId 不为空时代表远端用户的音量大小。
 >
 
@@ -561,7 +545,7 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 用户将麦克风的采集音量设置得越大，麦克风采集到的声音的原始音量也就会越大，反之就会越小。
 
-在有些型号的键盘以及笔记本电脑上，用户还可以通过按下` 禁用麦克风 `按钮（图标是一个` 话筒 `叠加了一道代表禁用的斜线）来将麦克风静音。
+在有些型号的键盘以及笔记本电脑上，用户还可以通过按下 `禁用麦克风` 按钮（图标是一个 `话筒` 叠加了一道代表禁用的斜线）来将麦克风静音。
 
 当用户通过系统设置界面或者通过键盘上的快捷键设定操作系统的麦克风采集音量时，SDK 便会抛出此事件。
 
@@ -572,7 +556,6 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 > **注意**
 >
-
 > 您需要调用 enableAudioVolumeEvaluation 接口并设定 interval 大于 0 开启次事件回调，设定 interval 等于 0 关闭此事件回调。
 >
 
@@ -593,7 +576,6 @@ SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该
 
 > **注意**
 >
-
 > 您需要调用 enableAudioVolumeEvaluation 接口并设定 interval 大于 0 开启次事件回调，设定 interval 等于 0 关闭此事件回调。
 >
 
@@ -617,7 +599,7 @@ SDK 会将系统声音采集是否被成功开启的结果，通过本事件回
 
 **收到自定义消息的事件回调。**
 
-当房间中的某个用户使用 sendCustomCmdMsg 发送自定义 UDP 消息时，房间中的其他用户可以通过 ` onRecvCustomCmdMsg ` 事件回调接收到该条消息。
+当房间中的某个用户使用 sendCustomCmdMsg 发送自定义 UDP 消息时，房间中的其他用户可以通过  `onRecvCustomCmdMsg`  事件回调接收到该条消息。
 
 |参数|描述|
 |---------|---------|
@@ -643,7 +625,6 @@ SDK 会将系统声音采集是否被成功开启的结果，通过本事件回
 
 > **注意**
 >
-
 > 只有在发送端设置了可靠传输（reliable），接收方才能收到消息的丢失回调。
 >
 
@@ -651,7 +632,7 @@ SDK 会将系统声音采集是否被成功开启的结果，通过本事件回
 
 **收到 SEI 消息的回调。**
 
-当房间中的某个用户使用 sendSEIMsg 借助视频数据帧发送 SEI 消息时，房间中的其他用户可以通过 ` onRecvSEIMsg ` 事件回调接收到该条消息。
+当房间中的某个用户使用 sendSEIMsg 借助视频数据帧发送 SEI 消息时，房间中的其他用户可以通过  `onRecvSEIMsg`  事件回调接收到该条消息。
 
 |参数|描述|
 |---------|---------|
@@ -697,7 +678,6 @@ SDK 会将系统声音采集是否被成功开启的结果，通过本事件回
 
 > **注意**
 >
-
 > 当您收到成功的事件回调时，只是说明您的发布指令已经同步到腾讯云后台服务器，但如果目标 CDN 厂商的服务器不接收该条视频流，依然可能导致发布失败。
 >
 
@@ -932,7 +912,6 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 
 > **注意**
 >
-
 > 目前仅支持 OpenGL 纹理方案（ PC 仅支持 TRTCVideoBufferType_Buffer 格式）。
 >
 
@@ -947,9 +926,9 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 当您设置完音频数据自定义回调之后，SDK 内部会把刚采集到并经过前处理(ANS、AEC、AGC）之后的数据，以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
 
--  由时间帧长转化为字节帧长的公式为 ` 采样率 × 时间帧长 × 声道数 × 采样点位宽 `。
+-  由时间帧长转化为字节帧长的公式为  `采样率 × 时间帧长 × 声道数 × 采样点位宽` 。
 
--  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为 ` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
+-  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为  `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
 |参数|描述|
 |---------|---------|
@@ -957,13 +936,10 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 
 > **注意**
 >
-
 > 1. 请不要在此回调函数中做任何耗时操作，由于 SDK 每隔 20ms 就要处理一帧音频数据，如果您的处理时间超过 20ms，就会导致声音异常。
 >
-
 > 2. 此接口回调出的音频数据是可读写的，也就是说您可以在回调函数中同步修改音频数据，但请保证处理耗时。
 >
-
 > 3. 此接口回调出的音频数据已经经过了前处理(ANS、AEC、AGC），但**不包含**背景音、音效、混响等前处理效果，延迟较低。
 >
 
@@ -974,15 +950,15 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 当您设置完音频数据自定义回调之后，SDK 内部会把刚采集到并经过前处理、音效处理和混 BGM 之后的数据，在最终进行网络编码之前，以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
 
--  由时间帧长转化为字节帧长的公式为` 采样率 × 时间帧长 × 声道数 × 采样点位宽 `。
+-  由时间帧长转化为字节帧长的公式为 `采样率 × 时间帧长 × 声道数 × 采样点位宽` 。
 
--  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
+-  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为 `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
 特殊说明：
 
-您可以通过设置接口中的 ` TRTCAudioFrame.extraData ` 字段，达到传输信令的目的。由于音频帧头部的数据块不能太大，建议您写入 ` extraData ` 时，尽量将信令控制在几个字节的大小，如果超过 100 个字节，写入的数据不会被发送。
+您可以通过设置接口中的  `TRTCAudioFrame.extraData`  字段，达到传输信令的目的。由于音频帧头部的数据块不能太大，建议您写入  `extraData`  时，尽量将信令控制在几个字节的大小，如果超过 100 个字节，写入的数据不会被发送。
 
-房间内其他用户可以通过 TRTCAudioFrameDelegate 中的 ` onRemoteUserAudioFrame ` 中的 ` TRTCAudioFrame.extraData ` 字段回调接收数据。
+房间内其他用户可以通过 TRTCAudioFrameDelegate 中的  `onRemoteUserAudioFrame`  中的  `TRTCAudioFrame.extraData`  字段回调接收数据。
 
 |参数|描述|
 |---------|---------|
@@ -990,13 +966,10 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 
 > **注意**
 >
-
 > 1. 请不要在此回调函数中做任何耗时操作，由于 SDK 每隔 20ms 就要处理一帧音频数据，如果您的处理时间超过 20ms，就会导致声音异常。
 >
-
 > 2. 此接口回调出的音频数据是可读写的，也就是说您可以在回调函数中同步修改音频数据，但请保证处理耗时。
 >
-
 > 3. 此接口回调出的数据已经经过了前处理(ANS、AEC、AGC）、音效和混 BGM 处理，声音的延迟相比于 onCapturedAudioFrame 要高一些。
 >
 
@@ -1007,9 +980,9 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 当您设置完音频数据自定义回调之后，SDK 内部会把远端的每一路原始数据，在最终混音之前，以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
 
--  由时间帧长转化为字节帧长的公式为` 采样率 × 时间帧长 × 声道数 × 采样点位宽 `。
+-  由时间帧长转化为字节帧长的公式为 `采样率 × 时间帧长 × 声道数 × 采样点位宽` 。
 
--  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
+-  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为 `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
 |参数|描述|
 |---------|---------|
@@ -1018,7 +991,6 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 
 > **注意**
 >
-
 > 此接口回调出的音频数据是只读的，不支持修改。
 >
 
@@ -1029,9 +1001,9 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 当您设置完音频数据自定义回调之后，SDK 内部会把各路待播放的音频混合之后的音频数据，在提交系统播放之前，以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
 
--  由时间帧长转化为字节帧长的公式为 ` 采样率 × 时间帧长 × 声道数 × 采样点位宽 `。
+-  由时间帧长转化为字节帧长的公式为  `采样率 × 时间帧长 × 声道数 × 采样点位宽` 。
 
--  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为 ` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
+-  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为  `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
 |参数|描述|
 |---------|---------|
@@ -1039,13 +1011,10 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 
 > **注意**
 >
-
 > 1. 请不要在此回调函数中做任何耗时操作，由于 SDK 每隔 20ms 就要处理一帧音频数据，如果您的处理时间超过 20ms，就会导致声音异常。
 >
-
 > 2. 此接口回调出的音频数据是可读写的，也就是说您可以在回调函数中同步修改音频数据，但请保证处理耗时。
 >
-
 > 3. 此接口回调出的是对各路待播放音频数据的混合，但其中并不包含耳返的音频数据。
 >
 
@@ -1056,9 +1025,9 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 当您设置完音频数据自定义回调之后，SDK 内部会把所有采集到的和待播放的音频数据混合起来，以 PCM 格式的形式通过本接口回调给您，便于您进行自定义录制。
 -  此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
 
--  由时间帧长转化为字节帧长的公式为 ` 采样率 × 时间帧长 × 声道数 × 采样点位宽 `。
+-  由时间帧长转化为字节帧长的公式为  `采样率 × 时间帧长 × 声道数 × 采样点位宽` 。
 
--  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为 ` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
+-  以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为  `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
 |参数|描述|
 |---------|---------|
@@ -1066,10 +1035,8 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 
 > **注意**
 >
-
 > 1. 此接口回调出的是SDK所有音频数据的混合数据，包括：经过 3A 前处理、特效叠加以及背景音乐混音后的本地音频，所有远端音频，但不包括耳返音频。
 >
-
 > 2. 此接口回调出的音频数据不支持修改。
 >
 
@@ -1080,9 +1047,9 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 当您设置完音频数据自定义回调之后，SDK 内部会把耳返的音频数据在播放之前以 PCM 格式的形式通过本接口回调给您。
 -  此接口回调出的音频时间帧长不固定，格式为 PCM 格式。
 
--  由时间帧长转化为字节帧长的公式为 ` 采样率 × 时间帧长 × 声道数 × 采样点位宽 `。
+-  由时间帧长转化为字节帧长的公式为  `采样率 × 时间帧长 × 声道数 × 采样点位宽` 。
 
--  以 TRTC 默认的音频录制格式 48000 采样率、单声道、16采样点位宽为例，0.02s 的音频数据字节帧长为 ` 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节 `。
+-  以 TRTC 默认的音频录制格式 48000 采样率、单声道、16采样点位宽为例，0.02s 的音频数据字节帧长为  `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
 |参数|描述|
 |---------|---------|
@@ -1090,10 +1057,8 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 
 > **注意**
 >
-
 > 1. 请不要在此回调函数中做任何耗时操作，否则会导致声音异常。
 >
-
 > 2. 此接口回调出的音频数据是可读写的，也就是说您可以在回调函数中同步修改音频数据，但请保证处理耗时。
 >
 
@@ -1107,4 +1072,4 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 |---------|---------|
 |level|日志等级请参见 TRTC_LOG_LEVEL。|
 |log|日志内容。|
-|module|保留字段，暂无具体意义，目前为固定值 ` TXLiteAVSDK `。|
+|module|保留字段，暂无具体意义，目前为固定值  `TXLiteAVSDK` 。|

package/resource/knowledge/trtc/ios/TRTCStatistics.md

@@ -33,7 +33,7 @@ Function: TRTC SDK 会以两秒钟一次的频率向您汇报当前实时的音
 | --- | --- |
 | audioBitrate | 【字段含义】远端音频的码率，单位 Kbps |
 | audioBlockRate | 【字段含义】音频播放卡顿率，单位 (%)<br>音频播放卡顿率（audioBlockRate） = 音频播放的累计卡顿时长（audioTotalBlockTime） / 音频播放的总时长 |
-| audioPacketLoss | 【字段含义】音频流的总丢包率（％）。<br>audioPacketLoss 代表音频流历经“主播>云端>观众”这样一条完整的传输链路后，最终在观众端统计到的丢包率。<br>audioPacketLoss 越小越好，丢包率为0即表示该路音频流的所有数据均已经完整地到达了观众端。<br>如果出现了 downLoss == 0 但 audioPacketLoss != 0 的情况，说明该路音频流在“云端=>观众”这一段链路上没有出现丢包，但是在<code> 主播>云端 </code>这一段链路上出现了不可恢复的丢包。 |
+| audioPacketLoss | 【字段含义】音频流的总丢包率（％）。<br>audioPacketLoss 代表音频流历经“主播>云端>观众”这样一条完整的传输链路后，最终在观众端统计到的丢包率。<br>audioPacketLoss 越小越好，丢包率为0即表示该路音频流的所有数据均已经完整地到达了观众端。<br>如果出现了 downLoss == 0 但 audioPacketLoss != 0 的情况，说明该路音频流在“云端=>观众”这一段链路上没有出现丢包，但是在 <code>主播>云端</code> 这一段链路上出现了不可恢复的丢包。 |
 | audioSampleRate | 【字段含义】远端音频的采样率，单位 Hz。 |
 | audioTotalBlockTime | 【字段含义】音频播放的累计卡顿时长，单位 ms |
 | finalLoss | 【字段含义】该路音视频流的总丢包率（％）。已废弃，不推荐使用；建议使用 audioPacketLoss、videoPacketLoss 替代。 |

package/resource/knowledge/trtc/ios/TXAudioEffectManager.md

@@ -60,7 +60,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 仅在主播佩戴耳机时才能开启此特效，同时请您提示主播佩戴有线耳机。
 >
 
@@ -76,7 +75,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 耳返的音量大小是影响用户耳返体验的重要因素之一，考虑到不同用户对音量的敏感度不同，强烈建议您在 UI 界面上开放耳返音量的调节滑杆，调节范围建议在 0~150 之间，其中 100~150 的增益效果对于部分采集音量较小的 Android 手机很有帮助。
 >
 
@@ -88,7 +86,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。
 >
 
@@ -100,7 +97,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。
 >
 
@@ -116,7 +112,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
 >
 
@@ -145,13 +140,10 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 1. 如果要多次播放同一首背景音乐，请不要每次播放都分配一个新的 ID，我们推荐使用相同的 ID。
 >
-
 > 2. 若您希望同时播放多首不同的音乐，请为不同的音乐分配不同的 ID 进行播放。
 >
-
 > 3. 如果使用同一个 ID 播放不同音乐，SDK 会先停止播放旧的音乐，再播放新的音乐。
 >
 
@@ -194,7 +186,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
 >
 
@@ -211,7 +202,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
 >
 
@@ -228,7 +218,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
 >
 
@@ -283,13 +272,10 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 请尽量避免过度频繁地调用该接口，因为该接口可能会再次读写音乐文件，耗时稍高。
 >
-
 > 因此，当用户拖拽音乐的播放进度条时，请在用户完成拖拽操作后再调用本接口。
 >
-
 > 因为 UI 上的进度条控件往往会以很高的频率反馈用户的拖拽进度，如不做频率限制，会导致较差的用户体验。
 >
 
@@ -304,7 +290,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 前置条件 preloadMusic 成功。
 >
 
@@ -320,14 +305,11 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 1. 预先加载最多同时支持2个不同 ID 的预加载，且预加载时长不超过10分钟，使用完需调用 stopPlayMusic，否则内存不释放。
 >
-
 > 2. 若该ID对应的音乐正在播放中，预加载会失败，需先调用 stopPlayMusic。
 >
-
-> 3. 当 ` musicParam ` 和传入 startPlayMusic 的 ` musicParam ` 完全相同时，预加载有效。
+> 3. 当  `musicParam`  和传入 startPlayMusic 的  `musicParam`  完全相同时，预加载有效。
 >
 
 ## getMusicTrackCount:
@@ -349,7 +331,6 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 > **注意**
 >
-
 > 音轨总数量可通过 getMusicTrackCount 接口获取。
 >
 

package/resource/knowledge/trtc/ios/TXDeviceManager.md

@@ -126,9 +126,9 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 
 > **注意**
 >
-
 > 使用该接口的前提是先通过 enableCameraAutoFocus 关闭自动对焦功能。
 >
+
 **返回值说明：**
 
 0：操作成功；负数：操作失败。
@@ -166,8 +166,8 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 > **注意**
 >
 > -  使用完毕后请调用 release 方法释放资源，这样可以让 SDK 维护 ITXDeviceCollection 对象的生命周期。
-> -  不要使用 delete 释放返回的 Collection 对象，` delete ITXDeviceCollection* ` 指针会导致异常崩溃。
-> -  type 只支持 ` TXMediaDeviceTypeMic `、` TXMediaDeviceTypeSpeaker `、` TXMediaDeviceTypeCamera `。
+> -  不要使用 delete 释放返回的 Collection 对象， `delete ITXDeviceCollection*`  指针会导致异常崩溃。
+> -  type 只支持  `TXMediaDeviceTypeMic` 、 `TXMediaDeviceTypeSpeaker` 、 `TXMediaDeviceTypeCamera` 。
 > -  此接口只支持 Mac 和 Windows 平台。
 
 ## setCurrentDevice:deviceId:
@@ -230,7 +230,6 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 
 > **注意**
 >
-
 > 在测试过程中可以使用 setCurrentDevice 接口切换摄像头。
 >
 
@@ -250,7 +249,6 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 
 > **注意**
 >
-
 > 该接口调用后默认会回播麦克风录制到的声音到扬声器中。
 >
 
@@ -295,7 +293,7 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 
 **设置系统音量类型（仅适用于移动端）。**
 
-@deprecated v9.5 版本开始不推荐使用，建议使用 ` TRTCCloud ` 中的 ` startLocalAudio(quality) ` 接口替代之，通过 quality 参数来决策音质。
+@deprecated v9.5 版本开始不推荐使用，建议使用  `TRTCCloud`  中的  `startLocalAudio(quality)`  接口替代之，通过 quality 参数来决策音质。
 
 ## TXSystemVolumeType(Deprecated)
 

package/resource/knowledge/trtc/ios/TXLiteAVCode.md

@@ -77,7 +77,7 @@ Function: 用于通知客户 TRTC 在使用过程中出现的警告和错误
 | ERR_TRTC_CONNECT_OTHER_ROOM_TIMEOUT | -3326 | 请求连麦超时 |
 | ERR_TRTC_DISCONNECT_OTHER_ROOM_TIMEOUT | -3327 | 请求退出连麦超时 |
 | ERR_TRTC_CONNECT_OTHER_ROOM_INVALID_PARAMETER | -3328 | 无效参数 |
-| ERR_TRTC_CONNECT_OTHER_ROOM_AS_AUDIENCE | -3330 | 当前是观众角色，不能请求或断开跨房连麦，需要先 <code> switchRole </code> 到主播 |
+| ERR_TRTC_CONNECT_OTHER_ROOM_AS_AUDIENCE | -3330 | 当前是观众角色，不能请求或断开跨房连麦，需要先  <code>switchRole</code>  到主播 |
 | ERR_BGM_OPEN_FAILED | -4001 | 打开文件失败，如音频数据无效，FFMPEG 协议未找到等 |
 | ERR_BGM_DECODE_FAILED | -4002 | 音频文件解码失败 |
 | ERR_BGM_OVER_LIMIT | -4003 | 数量超过限定值，如同时预加载两首背景音乐 |