@tencentcloud/sdk-mcp 1.7.7 → 1.7.9-beta.1

package/resource/knowledge/rtcengine/web/plugin/23-advanced-support-detection.md

@@ -1,3 +1,4 @@
+
 ## 浏览器环境检测
 
 在开始音视频通话之前，建议您先使用 {@link TRTC.isSupported TRTC.isSupported} 接口检测 SDK 是否支持当前网页。如果 SDK 不支持当前浏览器，建议用户使用最新版的 Chrome 浏览器、Edge 浏览器、Safari 浏览器、Firefox 浏览器。
@@ -21,6 +22,15 @@ TRTC.isSupported().then(checkResult => {
 
 ## 通话前设备检测
 
+用户的设备环境各不相同：有的电脑没有摄像头，有的使用了虚拟摄像头，有的没有授权，也有的网络质量差难以支撑完成一次高质量的通话。如果不提前检测，就只能等用户进了房才暴露成通话异常。
+
+因此我们建议您在通话前进行设备检测，以避免用户进入房间后遇到问题。把这些问题提前到用户还能自己处理的时间点：
+
+- 用户没有摄像头或麦克风。进房前就告知用户，而不是进了房才发现别人看不到、听不到自己。
+- 摄像头或麦克风异常。摄像头画面预览和实时音量条可以让用户确认设备是否正常，不正常时可以切换到其他设备。
+- 没有摄像头或麦克风权限。引导用户完成权限授予，而不是进房后碰到采集失败。
+- 网络质量差。用户在进房前就能了解自己的网络质量，通话体验不好时也能理解是网络的原因。参见[通话前的网络质量检测](tutorial-24-advanced-network-quality.md)。
+
 ### 方案一：使用设备检测插件（包括默认 UI）
 
 检测用户的媒体设备（摄像头、麦克风、扬声器）以及网络，建议在用户进房之前使用，支持移动端适配。
@@ -44,6 +54,26 @@ const options = {
 const resultWithNetwork = await trtc.startPlugin('DeviceDetector', options);
 ```
 
+#### 进房时使用检测通过的摄像头和麦克风
+
+设备检测的过程也是用户挑选摄像头和麦克风的过程，进房时要沿用这个选择。采集时不传 `deviceId`，SDK 会使用系统默认设备，而默认设备不一定就是用户刚刚确认过的那一台，用户可能会用一个自己没验证过的设备发布音视频。
+
+`trtc.startPlugin('DeviceDetector')` 的返回值就是检测结果，其中 `result.camera.device` 和 `result.microphone.device` 是用户在检测过程中看到并确认的设备，进房采集时把它们的 `deviceId` 传进去：
+
+```javascript
+const result = await trtc.startPlugin('DeviceDetector');
+const cameraId = result.camera?.device?.deviceId;
+const microphoneId = result.microphone?.device?.deviceId;
+
+await trtc.enterRoom({ roomId, sdkAppId, userId, userSig });
+
+// 使用用户在设备检测中确认过的摄像头和麦克风采集
+await trtc.startLocalVideo({ option: { cameraId } });
+await trtc.startLocalAudio({ option: { microphoneId } });
+```
+
+用户在检测中跳过或检测失败的步骤，返回结果里 `isSuccess` 为 false，`deviceId` 可能为空串。先判断 `isSuccess`，为空时不传该参数，让 SDK 使用默认设备。方案二自定义 UI 同理：从 `TRTC.getCameraList()` / `TRTC.getMicrophoneList()` 拿到 `deviceId`，或者记录用户在检测中选择的设备，用同样的方式传入。
+
 #### API
 
 ##### trtc.startPlugin('DeviceDetector', options)

package/resource/knowledge/rtcengine/web/plugin/24-advanced-network-quality.md

@@ -30,8 +30,6 @@ trtc.on(TRTC.EVENT.NETWORK_QUALITY, event => {
 > !
 > - 检测过程将产生少量的[音视频时长费用](https://cloud.tencent.com/document/product/647/44248)。如果未指定推流分辨率，则默认以 640*480 的分辨率推流。
 
-### API 调用时序
-
 ### 代码示例
 
 ```js

package/resource/knowledge/rtcengine/web/plugin/31-advanced-plugins-overview.md

@@ -399,4 +399,4 @@ const trtc = TRTC.create({
 
 - [TRTC Web SDK API 文档](https://web.sdk.qcloud.com/trtc/webrtc/v5/doc/zh-cn/index.html)
 - [包月套餐计费说明](https://cloud.tencent.com/document/product/647/85386)
-- [在线 Demo 体验](https://web.sdk.qcloud.com/trtc/webrtc/demo/api-sample/index.html)
+- [在线 Demo 体验](https://web.sdk.qcloud.com/trtc/webrtc/v5/demo/samples/basic-features/quick-start/index.html)

package/resource/knowledge/rtcengine/web/plugin/35-advanced-ai-denoiser.md

@@ -2,7 +2,7 @@
 
 AI 降噪插件能够降低通话中的噪声，减少环境噪声对通话的影响。可以更好地抑制通话过程中的键盘声、碰撞声、敲击声等噪声，特别适用于对瞬时噪声敏感的场景，例如会议场景中的短时噪声。
 
-本文将介绍在如何在开发 TRTC 应用中给本地音频流应用 AI 降噪的方法。[点击在线体验](https://web.sdk.qcloud.com/trtc/webrtc/demo/api-sample/improve-ai-denoiser.html) 降噪 demo 。
+本文将介绍如何在开发 TRTC 应用中给本地音频流应用 AI 降噪的方法。
 
 ## 前提条件
 

package/resource/knowledge/rtcengine/web/plugin/36-advanced-virtual-background.md

@@ -13,6 +13,10 @@
 | Web | Windows | Chrome 90+<br>Firefox 90+<br>Edge 97+ | 30 | 内存：16GB<br>CPU：i5-10500<br>GPU：独显 2GB | 建议使用最新版 Chrome 浏览器<br><b> （开启浏览器硬件加速）</b> |
 | 15 | 内存：8GB<br>CPU：i3-8300<br>GPU：intel 核显 1GB |  |  |  |  |
 | Mac | Chrome 98+<br>Firefox 96+<br>Safari 15+ | 30 | 2019年 MacBook<br>内存：16GB(2667MHz)<br>CPU：i7(6核 2.60GHz)<br>GPU：AMD Radeon 5300M |  |  |
+| Android | Chrome 90+ | 30 | 高端机型（如高通骁龙 8 Gen1） | 建议使用最新版 Chrome 浏览器<br>（开启浏览器硬件加速）<br>建议提前使用 <code>VirtualBackground.isSupported()</code> 检测是否支持，以检测结果为准 |  |
+| 15 | 中低端机型（如联发科天玑 8000-MAX、高通骁龙 660） |  |  |  |  |
+| iOS | Safari | 30 | iPhone 13 | 要求 iOS 16 及以上版本（含 iOS 16）<br>建议使用 Safari 浏览器<br>建议提前使用 <code>VirtualBackground.isSupported()</code> 检测是否支持，以检测结果为准 |  |
+| 15 | iPhone XR |  |  |  |  |
 
 ## 实现流程
 

package/resource/knowledge/trtc/android/TRTCCloud.md

@@ -4,7 +4,7 @@ Module:   TRTCCloud @ TXLiteAVSDK
 
 Function: 腾讯云 TRTC 主功能接口
 
-Version: 13.4
+Version: 13.5
 
 ## TRTCCloud
 
@@ -76,6 +76,7 @@ Version: 13.4
 |getAudioEffectManager|获取音效管理类（TXAudioEffectManager）。|
 |startSystemAudioLoopback|开启系统声音采集。|
 |stopSystemAudioLoopback|停止系统声音采集（iOS 端暂未支持）。|
+|setSystemAudioLoopbackVolume|设置系统声音的采集音量。|
 |getAITranscriberManager|获取 AI 转录管理类（AITranscriberManager）。|
 |startScreenCapture|启动屏幕分享。|
 |stopScreenCapture|停止屏幕分享。|
@@ -174,9 +175,9 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 包括 TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM 两个可选项，分别是视频直播和语音直播，该模式适合十万人以内的在线直播场景，但需要您在接下来介绍的 TRTCParams 参数中指定 **角色(role)** 这个字段，也就是将房间中的用户区分为 **主播** (TRTCRoleAnchor) 和 **观众** (TRTCRoleAudience) 两种不同的角色。
 
 调用该接口后，您会收到来自 TRTCCloudListener 中的 onEnterRoom 回调：
--  如果进房成功，参数  `result`  会是一个正数（result > 0），表示从函数调用到进入房间所花费的时间，单位是毫秒（ms）。
+- 如果进房成功，参数  `result`  会是一个正数（result > 0），表示从函数调用到进入房间所花费的时间，单位是毫秒（ms）。
 
--  如果进房失败，参数  `result`  会是一个负数（result < 0），表示进房失败的[错误码](https://cloud.tencent.com/document/product/647/32257)。
+- 如果进房失败，参数  `result`  会是一个负数（result < 0），表示进房失败的[错误码](https://cloud.tencent.com/document/product/647/32257)。
 
 |参数|描述|
 |---------|---------|
@@ -213,7 +214,7 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 您可以在进入房间时通过 TRTCParams 中的  `role`  字段事先确定用户的角色，也可以在进入房间后通过该接口动态切换角色。
 | 参数 | 描述 |
 | --- | --- |
-| role | 角色，默认为 <strong>主播</strong>。<br>-  TRTCRoleAnchor ：主播，可以发布自己的音视频，同一个房间里最多支持50个主播同时发布音视频。<br>-  TRTCRoleAudience ：观众，不能发布自己的音视频流，只能观看房间中其他主播的音视频。如果要发布自己的音视频，需要先通过 switchRole 切换成 <strong>主播</strong>，同一个房间内同时最多可以容纳 10 万名观众。 |
+| role | 角色，默认为 <strong>主播</strong>。<br>- TRTCRoleAnchor ：主播，可以发布自己的音视频，同一个房间里最多支持50个主播同时发布音视频。<br>- TRTCRoleAudience ：观众，不能发布自己的音视频流，只能观看房间中其他主播的音视频。如果要发布自己的音视频，需要先通过 switchRole 切换成 <strong>主播</strong>，同一个房间内同时最多可以容纳 10 万名观众。 |
 
 > **注意**
 >
@@ -233,8 +234,8 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 您可以在进入房间时通过 TRTCParams 中的  `role`  字段事先确定用户的角色，也可以在进入房间后通过该接口动态切换角色。
 | 参数 | 描述 |
 | --- | --- |
-| privateMapKey | 用于权限控制的权限票据，当您希望某个房间只能让特定的 userId 进入或者上行视频时，需要使用  <code>privateMapKey</code>  进行权限保护。<br>-  仅建议有高级别安全需求的客户使用，更多详情请参见 <a href="https://cloud.tencent.com/document/product/647/32240">开启高级权限控制</a>。 |
-| role | 角色，默认为 <strong>主播</strong>。<br>-  TRTCRoleAnchor ：主播，可以发布自己的音视频，同一个房间里最多支持50个主播同时发布音视频。<br>-  TRTCRoleAudience ：观众，不能发布自己的音视频流，只能观看房间中其他主播的音视频。如果要发布自己的音视频，需要先通过 switchRole 切换成 <strong>主播</strong>，同一个房间内同时最多可以容纳 10 万名观众。 |
+| privateMapKey | 用于权限控制的权限票据，当您希望某个房间只能让特定的 userId 进入或者上行视频时，需要使用  <code>privateMapKey</code>  进行权限保护。<br>- 仅建议有高级别安全需求的客户使用，更多详情请参见 <a href="https://cloud.tencent.com/document/product/647/32240">开启高级权限控制</a>。 |
+| role | 角色，默认为 <strong>主播</strong>。<br>- TRTCRoleAnchor ：主播，可以发布自己的音视频，同一个房间里最多支持50个主播同时发布音视频。<br>- TRTCRoleAudience ：观众，不能发布自己的音视频流，只能观看房间中其他主播的音视频。如果要发布自己的音视频，需要先通过 switchRole 切换成 <strong>主播</strong>，同一个房间内同时最多可以容纳 10 万名观众。 |
 
 > **注意**
 >
@@ -248,9 +249,9 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 **切换房间。**
 
 使用该接口可以让用户快速从一个房间切换到另一个房间。
--  如果用户的身份是“观众”，该接口的调用效果等同于  `exitRoom(当前房间) + enterRoom（新的房间）` 。
+- 如果用户的身份是“观众”，该接口的调用效果等同于  `exitRoom(当前房间) + enterRoom（新的房间）` 。
 
--  如果用户的身份是“主播”，该接口在切换房间的同时还会保持自己的音视频发布状态，因此在房间切换过程中，摄像头的预览和声音的采集都不会中断。
+- 如果用户的身份是“主播”，该接口在切换房间的同时还会保持自己的音视频发布状态，因此在房间切换过程中，摄像头的预览和声音的采集都不会中断。
 
 该接口适用于在线教育场景中，监课老师在多个房间中进行快速切换的场景。在该场景下使用  `switchRoom`  可以获得比  `exitRoom + enterRoom`  更好的流畅性和更少的代码量。
 
@@ -282,9 +283,9 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 跨房通话的请求结果会通过 TRTCCloudListener 中的 onConnectOtherRoom 回调通知给您。
 
 例如：当房间“101”中的主播 A 通过  `connectOtherRoom()`  跟房间“102”中的主播 B 建立跨房通话后，
--  房间“101”中的用户都会收到主播 B 的  `onRemoteUserEnterRoom(B)`  和  `onUserVideoAvailable(B,true)`  这两个事件回调，即房间“101”中的用户都可以订阅主播 B 的音视频。
+- 房间“101”中的用户都会收到主播 B 的  `onRemoteUserEnterRoom(B)`  和  `onUserVideoAvailable(B,true)`  这两个事件回调，即房间“101”中的用户都可以订阅主播 B 的音视频。
 
--  房间“102”中的用户都会收到主播 A 的  `onRemoteUserEnterRoom(A)`  和  `onUserVideoAvailable(A,true)`  这两个事件回调，即房间“102”中的用户都可以订阅主播 A 的音视频。
+- 房间“102”中的用户都会收到主播 A 的  `onRemoteUserEnterRoom(A)`  和  `onUserVideoAvailable(A,true)`  这两个事件回调，即房间“102”中的用户都可以订阅主播 A 的音视频。
 
 跨房通话的参数考虑到后续扩展字段的兼容性问题，暂时采用了 JSON 格式的参数：
 
@@ -327,9 +328,9 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 **设置订阅模式（需要在进入房前设置才能生效）。**
 
 您可以通过该接口在“自动订阅”和“手动订阅”两种模式下进行切换：
--  自动订阅：默认模式，用户在进入房间后会立刻接收到该房间中的音视频流，音频会自动播放，视频会自动开始解码（依然需要您通过 startRemoteView 接口绑定渲染控件）。
+- 自动订阅：默认模式，用户在进入房间后会立刻接收到该房间中的音视频流，音频会自动播放，视频会自动开始解码（依然需要您通过 startRemoteView 接口绑定渲染控件）。
 
--  手动订阅：在用户进入房间后，需要手动调用 startRemoteView 接口才能启动视频流的订阅和解码，需要手动调用 muteRemoteAudio (false) 接口才能启动声音的播放。
+- 手动订阅：在用户进入房间后，需要手动调用 startRemoteView 接口才能启动视频流的订阅和解码，需要手动调用 muteRemoteAudio (false) 接口才能启动声音的播放。
 
 在绝大多数场景下，用户进入房间后都会订阅房间中所有主播的音视频流，因此 TRTC 默认采用了自动订阅模式，以求得最佳的“秒开体验”。
 
@@ -395,8 +396,8 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 >
 > 4. 同一个用户可以在多个 TRTCCloud 实例中推流，也可以调用子实例中与本地音视频相关的接口。但需要注意：
 >
-> -  多实例的音频需要同时为麦克风采集或自定义采集，而且与音频设备相关的接口调用会以最后一次为准；
-> -  与摄像头相关的调用会以最后一次为准：startLocalPreview。
+> - 多实例的音频需要同时为麦克风采集或自定义采集，而且与音频设备相关的接口调用会以最后一次为准；
+> - 与摄像头相关的调用会以最后一次为准：startLocalPreview。
 
 **返回值说明：**
 
@@ -427,12 +428,12 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 例如：
 
 房间“101”中有主播 A 与观众 B，房间“102”中有主播 C，主播 C 正常发布音视频流。主播 A 通过 connectOtherRoom 跟主播 C 建立跨房通话。
--  此时，主播 A 与观众 B 都会收到主播 C 的  `onRemoteUserEnterRoom(C)` ,  `onUserVideoAvailable(C,true)`  和  `onUserAudioAvailable(C,true)`  这三个事件回调，可以订阅主播 C 的音视频。
+- 此时，主播 A 与观众 B 都会收到主播 C 的  `onRemoteUserEnterRoom(C)` ,  `onUserVideoAvailable(C,true)`  和  `onUserAudioAvailable(C,true)`  这三个事件回调，可以订阅主播 C 的音视频。
 
 之后，主播 A 调用该接口禁用主播 C 在本房间发布音频的能力。
--  此后，主播 C 的音频流将无法发布至房间“101”，主播 A 与观众 B 都将收到  `onUserAudioAvailable(C,false)`  事件回调，且无法再通过  `muteRemoteAudio(C,false)`  订阅主播 C 的音频。
+- 此后，主播 C 的音频流将无法发布至房间“101”，主播 A 与观众 B 都将收到  `onUserAudioAvailable(C,false)`  事件回调，且无法再通过  `muteRemoteAudio(C,false)`  订阅主播 C 的音频。
 
--  主播 C 的视频流将不受影响。房间“102”中的其他观众也不受影响，可以正常订阅主播 C 的音频。
+- 主播 C 的视频流将不受影响。房间“102”中的其他观众也不受影响，可以正常订阅主播 C 的音频。
 
 该接口的参数考虑到后续扩展字段的兼容性问题，暂时采用了 JSON 格式的参数，示例如下：
 
@@ -543,8 +544,8 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 >
 > 如果希望开播前预览摄像头画面并通过 BeautyManager 调节美颜参数，您可以：
 >
-> -  方案一：在调用 enterRoom 之前调用  `startLocalPreview` 。
-> -  方案二：在调用 enterRoom 之后调用  `startLocalPreview + muteLocalVideo(true)` 。
+> - 方案一：在调用 enterRoom 之前调用  `startLocalPreview` 。
+> - 方案二：在调用 enterRoom 之后调用  `startLocalPreview + muteLocalVideo(true)` 。
 
 ## updateLocalView
 
@@ -591,14 +592,14 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 **订阅远端用户的视频流，并绑定视频渲染控件。**
 
 调用该接口可以让 SDK 拉取指定 userId 的视频流，并渲染到参数  `view`  指定的渲染控件上。您可以通过 setRemoteRenderParams 设置画面的显示模式。
--  如果您已经知道房间中有视频流的用户的 userId，可以直接调用  `startRemoteView`  订阅该用户的画面。
+- 如果您已经知道房间中有视频流的用户的 userId，可以直接调用  `startRemoteView`  订阅该用户的画面。
 
--  如果您不知道房间中有哪些用户在发布视频，您可以在 enterRoom 之后等待来自 onUserVideoAvailable 的通知。
+- 如果您不知道房间中有哪些用户在发布视频，您可以在 enterRoom 之后等待来自 onUserVideoAvailable 的通知。
 
 调用本接口只是启动视频流的拉取，此时画面还需要加载和缓冲，当缓冲完毕后您会收到来自 onFirstVideoFrame 的通知。
 | 参数 | 描述 |
 | --- | --- |
-| streamType | 指定要观看 userId 的视频流类型。<br>-  高清大画面：TRTC_VIDEO_STREAM_TYPE_BIG。<br>-  低清小画面：TRTC_VIDEO_STREAM_TYPE_SMALL（需要远端用户通过 enableEncSmallVideoStream 开启双路编码后才有效果）。<br>-  辅流画面（常用于屏幕分享）：TRTC_VIDEO_STREAM_TYPE_SUB。 |
+| streamType | 指定要观看 userId 的视频流类型。<br>- 高清大画面：TRTC_VIDEO_STREAM_TYPE_BIG。<br>- 低清小画面：TRTC_VIDEO_STREAM_TYPE_SMALL（需要远端用户通过 enableEncSmallVideoStream 开启双路编码后才有效果）。<br>- 辅流画面（常用于屏幕分享）：TRTC_VIDEO_STREAM_TYPE_SUB。 |
 | userId | 指定远端用户的 ID。 |
 | view | 用于承载视频画面的渲染控件。 |
 
@@ -632,7 +633,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 调用此接口会让 SDK 停止接收该用户的视频流，并释放该路视频流的解码和渲染资源。
 | 参数 | 描述 |
 | --- | --- |
-| streamType | 指定要观看 userId 的视频流类型。<br>-  高清大画面：TRTC_VIDEO_STREAM_TYPE_BIG。<br>-  低清小画面：TRTC_VIDEO_STREAM_TYPE_SMALL。<br>-  辅流画面（常用于屏幕分享）：TRTC_VIDEO_STREAM_TYPE_SUB。 |
+| streamType | 指定要观看 userId 的视频流类型。<br>- 高清大画面：TRTC_VIDEO_STREAM_TYPE_BIG。<br>- 低清小画面：TRTC_VIDEO_STREAM_TYPE_SMALL。<br>- 辅流画面（常用于屏幕分享）：TRTC_VIDEO_STREAM_TYPE_SUB。 |
 | userId | 指定远端用户的 ID。 |
 
 ## stopAllRemoteView
@@ -654,7 +655,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 | 参数 | 描述 |
 | --- | --- |
 | mute | 是否暂停接收。 |
-| streamType | 要暂停/恢复的视频流类型。<br>-  高清大画面：TRTC_VIDEO_STREAM_TYPE_BIG。<br>-  低清小画面：TRTC_VIDEO_STREAM_TYPE_SMALL。<br>-  辅流画面（常用于屏幕分享）：TRTC_VIDEO_STREAM_TYPE_SUB。 |
+| streamType | 要暂停/恢复的视频流类型。<br>- 高清大画面：TRTC_VIDEO_STREAM_TYPE_BIG。<br>- 低清小画面：TRTC_VIDEO_STREAM_TYPE_SMALL。<br>- 辅流画面（常用于屏幕分享）：TRTC_VIDEO_STREAM_TYPE_SUB。 |
 | userId | 指定远端用户的 ID。 |
 
 > **注意**
@@ -820,7 +821,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 开启本地音频的采集和发布后，房间中的其他用户会收到 onUserAudioAvailable(userId, true) 的通知。
 | 参数 | 描述 |
 | --- | --- |
-| quality | 声音音质<br>-  TRTC_AUDIO_QUALITY_SPEECH，流畅：单声道；音频裸码率：18kbps；适合语音通话为主的场景，例如在线会议，语音通话。<br>-  TRTC_AUDIO_QUALITY_DEFAULT，默认：单声道；音频裸码率：50kbps；SDK 默认的音频质量，如无特殊需求推荐选择之。<br>-  TRTC_AUDIO_QUALITY_MUSIC，高音质：双声道 + 全频带；音频裸码率：128kbps；适合需要高保真传输音乐的场景，例如在线K歌、音乐直播等。 |
+| quality | 声音音质<br>- TRTC_AUDIO_QUALITY_SPEECH，流畅：单声道；音频裸码率：18kbps；适合语音通话为主的场景，例如在线会议，语音通话。<br>- TRTC_AUDIO_QUALITY_DEFAULT，默认：单声道；音频裸码率：50kbps；SDK 默认的音频质量，如无特殊需求推荐选择之。<br>- TRTC_AUDIO_QUALITY_MUSIC，高音质：双声道 + 全频带；音频裸码率：128kbps；适合需要高保真传输音乐的场景，例如在线K歌、音乐直播等。 |
 
 > **注意**
 >
@@ -1095,17 +1096,17 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 **获取美颜管理类（TXBeautyManager）。**
 
 通过美颜管理，您可以使用以下功能：
--  设置“磨皮”、“美白”、“红润”等美颜特效。
+- 设置“磨皮”、“美白”、“红润”等美颜特效。
 
--  以下功能仅iOS/Android支持：
+- 以下功能仅iOS/Android支持：
 
--  设置“大眼”、“瘦脸”、“V脸”、“下巴”、“短脸”、“小鼻”、“亮眼”、“白牙”、“祛眼袋”、“祛皱纹”、“祛法令纹”等修脸特效。
+- 设置“大眼”、“瘦脸”、“V脸”、“下巴”、“短脸”、“小鼻”、“亮眼”、“白牙”、“祛眼袋”、“祛皱纹”、“祛法令纹”等修脸特效。
 
--  设置“发际线”、“眼间距”、“眼角”、“嘴形”、“鼻翼”、“鼻子位置”、“嘴唇厚度”、“脸型”等修脸特效。
+- 设置“发际线”、“眼间距”、“眼角”、“嘴形”、“鼻翼”、“鼻子位置”、“嘴唇厚度”、“脸型”等修脸特效。
 
--  设置“眼影”、“腮红”等美妆特效。
+- 设置“眼影”、“腮红”等美妆特效。
 
--  设置动态贴纸和人脸挂件等动画特效。
+- 设置动态贴纸和人脸挂件等动画特效。
 **返回值说明：**
 
 美颜管理类 TXBeautyManager。
@@ -1115,13 +1116,13 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 **添加水印。**
 
 水印的位置是通过 rect 参数来指定的，rect 是一个四元组参数，其格式为 (x，y，width，height)
--  x：水印的坐标，取值范围为 [0, 1] 的浮点数。
+- x：水印的坐标，取值范围为 [0, 1] 的浮点数。
 
--  y：水印的坐标，取值范围为 [0, 1] 的浮点数。
+- y：水印的坐标，取值范围为 [0, 1] 的浮点数。
 
--  width：水印的宽度，取值范围为 [0, 1] 的浮点数。
+- width：水印的宽度，取值范围为 [0, 1] 的浮点数。
 
--  height：是不用设置的，SDK 内部会根据水印图片的宽高比自动计算一个合适的高度。
+- height：是不用设置的，SDK 内部会根据水印图片的宽高比自动计算一个合适的高度。
 
 参数设置举例：
 
@@ -1145,15 +1146,15 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 **获取音效管理类（TXAudioEffectManager）。**
 
 TXAudioEffectManager 是音效管理接口，您可以通过该接口实现如下功能：
--  背景音乐：支持在线音乐和本地音乐，支持变速、变调等特效、支持原生和伴奏并播放和循环播放。
+- 背景音乐：支持在线音乐和本地音乐，支持变速、变调等特效、支持原生和伴奏并播放和循环播放。
 
--  耳机耳返：麦克风捕捉的声音实时通过耳机播放，常用于音乐直播。
+- 耳机耳返：麦克风捕捉的声音实时通过耳机播放，常用于音乐直播。
 
--  混响效果：KTV、小房间、大会堂、低沉、洪亮等。
+- 混响效果：KTV、小房间、大会堂、低沉、洪亮等。
 
--  变声特效：萝莉、大叔、重金属等。
+- 变声特效：萝莉、大叔、重金属等。
 
--  短音效：鼓掌声、欢笑声等简短的音效文件（对于小于10秒的文件，请将 isShortFile 参数设置为 true）。
+- 短音效：鼓掌声、欢笑声等简短的音效文件（对于小于10秒的文件，请将 isShortFile 参数设置为 true）。
 **返回值说明：**
 
 音效管理类 TXAudioEffectManager。
@@ -1183,6 +1184,14 @@ TXAudioEffectManager 是音效管理接口，您可以通过该接口实现如
 
 **停止系统声音采集（iOS 端暂未支持）。**
 
+## setSystemAudioLoopbackVolume
+
+**设置系统声音的采集音量。**
+
+|参数|描述|
+|---------|---------|
+|volume|设置的音量大小，范围是：[0, 150]，默认值为 100。|
+
 ## getAITranscriberManager
 
 **获取 AI 转录管理类（AITranscriberManager）。**
@@ -1200,13 +1209,13 @@ AI 转录管理类 AITranscriberManager。
 参考文档：[实时屏幕分享(Android)](https://cloud.tencent.com/document/product/647/45751)
 
 Android 推荐的屏幕分享视频编码参数（TRTCVideoEncParam）：
--  分辨率(videoResolution)：1280×720。
+- 分辨率(videoResolution)：1280×720。
 
--  帧率(videoFps)：10 FPS。
+- 帧率(videoFps)：10 FPS。
 
--  码率(videoBitrate)：1200 kbps。
+- 码率(videoBitrate)：1200 kbps。
 
--  分辨率自适应(enableAdjustRes)：false。
+- 分辨率自适应(enableAdjustRes)：false。
 
 #### [REMARK]
 
@@ -1251,9 +1260,9 @@ Android 推荐的屏幕分享视频编码参数（TRTCVideoEncParam）：
 该接口可以设定远端用户所看到的屏幕分享（即辅路）的画面质量，同时也能决定云端录制出的视频文件中屏幕分享的画面质量。
 
 请注意如下两个接口的差异：
--  setVideoEncoderParam 用于设置主路画面（TRTC_VIDEO_STREAM_TYPE_BIG，一般用于摄像头）的视频编码参数。
+- setVideoEncoderParam 用于设置主路画面（TRTC_VIDEO_STREAM_TYPE_BIG，一般用于摄像头）的视频编码参数。
 
--  setSubStreamEncoderParam 用于设置辅路画面（TRTC_VIDEO_STREAM_TYPE_SUB，一般用于屏幕分享）的视频编码参数。
+- setSubStreamEncoderParam 用于设置辅路画面（TRTC_VIDEO_STREAM_TYPE_SUB，一般用于屏幕分享）的视频编码参数。
 
 |参数|描述|
 |---------|---------|
@@ -1279,9 +1288,9 @@ Android 推荐的屏幕分享视频编码参数（TRTCVideoEncParam）：
 使用此接口可以向 SDK 投送自己采集的视频帧，SDK 会将视频帧进行编码并通过自身的网络模块传输出去。
 
 Android 平台有两种投送方案：
--  内存传递方案：对接起来比较简单，但是性能较差，不适合分辨率较高的场景。
+- 内存传递方案：对接起来比较简单，但是性能较差，不适合分辨率较高的场景。
 
--  显存传递方案：对接需要一定的 OpenGL 基础，但是性能较好，640 × 360 以上的分辨率请采用该方案。
+- 显存传递方案：对接需要一定的 OpenGL 基础，但是性能较好，640 × 360 以上的分辨率请采用该方案。
 
 参考文档：[自定义采集和渲染](https://cloud.tencent.com/document/product/647/34066)。
 
@@ -1321,15 +1330,15 @@ Android 平台有两种投送方案：
 **向 SDK 投送自己采集的音频数据。**
 
 参数 TRTCAudioFrame 推荐下列填写方式（其他字段不需要填写）：
--  audioFormat：音频数据格式，仅支持 TRTCAudioFrameFormatPCM。
+- audioFormat：音频数据格式，仅支持 TRTCAudioFrameFormatPCM。
 
--  data：音频帧 buffer。音频帧数据只支持 PCM 格式，支持 5-100 ms 帧长，推荐使用 20ms 帧长，长度计算方法：48000采样率，单声道的帧长度： `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
+- data：音频帧 buffer。音频帧数据只支持 PCM 格式，支持 5-100 ms 帧长，推荐使用 20ms 帧长，长度计算方法：48000采样率，单声道的帧长度： `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
--  sampleRate：采样率，支持：16000、24000、32000、44100、48000。
+- sampleRate：采样率，支持：16000、24000、32000、44100、48000。
 
--  channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+- channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
 
--  timestamp：时间戳，单位为毫秒（ms），请使用音频帧在采集时被记录下来的时间戳（可以在采集到一帧音频帧之后，通过调用 generateCustomPTS 获取时间戳）。
+- timestamp：时间戳，单位为毫秒（ms），请使用音频帧在采集时被记录下来的时间戳（可以在采集到一帧音频帧之后，通过调用 generateCustomPTS 获取时间戳）。
 
 参考文档：[自定义采集和渲染](https://cloud.tencent.com/document/product/647/74692)。
 
@@ -1373,13 +1382,13 @@ Android 平台有两种投送方案：
 当您调用该接口后，如果发现返回值大于 100ms，则可以等待一帧音频帧的播放时间之后再次调用；如果返回值小于 100ms，则代表缓冲区比较小，您可以再次混入一些音轨数据以确保音轨缓冲区的大小维持在“安全水位”以上。
 
 参数 TRTCAudioFrame 推荐下列填写方式（其他字段不需要填写）：
--  data：音频帧 buffer。音频帧数据只支持 PCM 格式，支持 5ms - 100ms 帧长，推荐使用 20ms 帧长，长度计算方法：48000采样率, 单声道的帧长度： `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
+- data：音频帧 buffer。音频帧数据只支持 PCM 格式，支持 5ms - 100ms 帧长，推荐使用 20ms 帧长，长度计算方法：48000采样率, 单声道的帧长度： `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
--  sampleRate：采样率，支持：16000、24000、32000、44100、48000。
+- sampleRate：采样率，支持：16000、24000、32000、44100、48000。
 
--  channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+- channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
 
--  timestamp：时间戳，单位为毫秒（ms），请使用音频帧在采集时被记录下来的时间戳（可以在获得一帧音频帧之后，通过调用 generateCustomPTS 获得时间戳）。
+- timestamp：时间戳，单位为毫秒（ms），请使用音频帧在采集时被记录下来的时间戳（可以在获得一帧音频帧之后，通过调用 generateCustomPTS 获得时间戳）。
 
 |参数|描述|
 |---------|---------|
@@ -1426,9 +1435,9 @@ Android 平台有两种投送方案：
 设置该回调之后，SDK 会把采集到的视频帧通过您设置的 listener 回调出来，用于第三方美颜组件进行二次处理，之后 SDK 会将处理后的视频帧进行编码和发送。
 | 参数 | 描述 |
 | --- | --- |
-| bufferType | 指定回调的数据格式，目前支持：<br>-  TRTC_VIDEO_BUFFER_TYPE_TEXTURE：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_Texture_2D 时。<br>-  TRTC_VIDEO_BUFFER_TYPE_BYTE_BUFFER：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_I420 时。<br>-  TRTC_VIDEO_BUFFER_TYPE_BYTE_ARRAY：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_I420 时。 |
+| bufferType | 指定回调的数据格式，目前支持：<br>- TRTC_VIDEO_BUFFER_TYPE_TEXTURE：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_Texture_2D 时。<br>- TRTC_VIDEO_BUFFER_TYPE_BYTE_BUFFER：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_I420 时。<br>- TRTC_VIDEO_BUFFER_TYPE_BYTE_ARRAY：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_I420 时。 |
 | listener | 自定义预处理回调。 |
-| pixelFormat | 指定回调的像素格式，目前支持：<br>-  TRTC_VIDEO_PIXEL_FORMAT_Texture_2D: 显存纹理方案。<br>-  TRTC_VIDEO_PIXEL_FORMAT_I420：内存数据方案。 |
+| pixelFormat | 指定回调的像素格式，目前支持：<br>- TRTC_VIDEO_PIXEL_FORMAT_Texture_2D: 显存纹理方案。<br>- TRTC_VIDEO_PIXEL_FORMAT_I420：内存数据方案。 |
 **返回值说明：**
 
 0：成功；< 0：错误（详见 [错误码](https://cloud.tencent.com/document/product/647/38307)）。
@@ -1438,16 +1447,16 @@ Android 平台有两种投送方案：
 **设置本地视频自定义渲染回调。**
 
 设置该回调之后，SDK 内部会跳过原来的渲染流程，并把采集到的数据回调出来，您需要自己完成画面渲染。
--  pixelFormat 指定回调的数据格式，目前支持 Texture2D、I420 和 RGBA 三种格式。
+- pixelFormat 指定回调的数据格式，目前支持 Texture2D、I420 和 RGBA 三种格式。
 
--  bufferType  指定 buffer 的类型，BYTE_BUFFER 适合在 jni 层使用，BYTE_ARRAY 则可用于 Java 层的直接操作。
+- bufferType  指定 buffer 的类型，BYTE_BUFFER 适合在 jni 层使用，BYTE_ARRAY 则可用于 Java 层的直接操作。
 
 参考文档：[自定义采集和渲染](https://cloud.tencent.com/document/product/647/34066)。
 | 参数 | 描述 |
 | --- | --- |
-| bufferType | 指定视频帧的数据结构：<br>-  TRTC_VIDEO_BUFFER_TYPE_TEXTURE：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_Texture_2D 时。<br>-  TRTC_VIDEO_BUFFER_TYPE_BYTE_BUFFER：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_I420 和 TRTC_VIDEO_PIXEL_FORMAT_RGBA 时。<br>-  TRTC_VIDEO_BUFFER_TYPE_BYTE_ARRAY：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_I420 和 TRTC_VIDEO_PIXEL_FORMAT_RGBA 时。 |
+| bufferType | 指定视频帧的数据结构：<br>- TRTC_VIDEO_BUFFER_TYPE_TEXTURE：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_Texture_2D 时。<br>- TRTC_VIDEO_BUFFER_TYPE_BYTE_BUFFER：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_I420 和 TRTC_VIDEO_PIXEL_FORMAT_RGBA 时。<br>- TRTC_VIDEO_BUFFER_TYPE_BYTE_ARRAY：适用于 pixelFormat 被设置为 TRTC_VIDEO_PIXEL_FORMAT_I420 和 TRTC_VIDEO_PIXEL_FORMAT_RGBA 时。 |
 | listener | 自定义视频渲染回调，每一帧视频数据回调一次。 |
-| pixelFormat | 指定视频帧的像素格式，如：<br>-  TRTC_VIDEO_PIXEL_FORMAT_Texture_2D：OpenGL 纹理格式，比较适合 GPU 进行处理，处理效率高。<br>-  TRTC_VIDEO_PIXEL_FORMAT_I420：标准 i420 格式，比较适合 CPU 进行处理，处理效率较差。<br>-  TRTC_VIDEO_PIXEL_FORMAT_RGBA：RGBA 格式，比较适合 CPU 进行处理，处理效率较差。 |
+| pixelFormat | 指定视频帧的像素格式，如：<br>- TRTC_VIDEO_PIXEL_FORMAT_Texture_2D：OpenGL 纹理格式，比较适合 GPU 进行处理，处理效率高。<br>- TRTC_VIDEO_PIXEL_FORMAT_I420：标准 i420 格式，比较适合 CPU 进行处理，处理效率较差。<br>- TRTC_VIDEO_PIXEL_FORMAT_RGBA：RGBA 格式，比较适合 CPU 进行处理，处理效率较差。 |
 **返回值说明：**
 
 0：成功；< 0：错误。
@@ -1457,9 +1466,9 @@ Android 平台有两种投送方案：
 **设置远端视频自定义渲染回调。**
 
 设置该回调之后，SDK 内部会跳过原来的渲染流程，并把采集到的数据回调出来，您需要自己完成画面渲染。
--  pixelFormat 指定回调的数据格式，例如 NV12、i420 以及 32BGRA。
+- pixelFormat 指定回调的数据格式，例如 NV12、i420 以及 32BGRA。
 
--  bufferType 指定 buffer 的类型，直接使用 PixelBuffer 效率最高；使用 NSData 相当于让 SDK 在内部做了一次内存转换，因此会有额外的性能损耗。
+- bufferType 指定 buffer 的类型，直接使用 PixelBuffer 效率最高；使用 NSData 相当于让 SDK 在内部做了一次内存转换，因此会有额外的性能损耗。
 
 参考文档：[自定义采集和渲染](https://cloud.tencent.com/document/product/647/34066)。
 
@@ -1484,13 +1493,13 @@ Android 平台有两种投送方案：
 **设置音频数据自定义回调。**
 
 设置该回调之后，SDK 内部会把音频数据（PCM 格式）回调出来，包括：
--  onCapturedAudioFrame：本地麦克风采集到的音频数据回调
+- onCapturedAudioFrame：本地麦克风采集到的音频数据回调
 
--  onLocalProcessedAudioFrame：本地采集并经过音频模块前处理后的音频数据回调
+- onLocalProcessedAudioFrame：本地采集并经过音频模块前处理后的音频数据回调
 
--  onRemoteUserAudioFrame：混音前的每一路远程用户的音频数据
+- onRemoteUserAudioFrame：混音前的每一路远程用户的音频数据
 
--  onMixedPlayAudioFrame：将各路音频混合之后并最终要由系统播放出的音频数据回调
+- onMixedPlayAudioFrame：将各路音频混合之后并最终要由系统播放出的音频数据回调
 
 > **注意**
 >
@@ -1502,11 +1511,11 @@ Android 平台有两种投送方案：
 **设置本地麦克风采集出的音频帧回调格式。**
 
 本接口用于设置 onCapturedAudioFrame 回调出来的 AudioFrame 的格式：
--  sampleRate：采样率，支持：16000、32000、44100、48000。
+- sampleRate：采样率，支持：16000、32000、44100、48000。
 
--  channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+- channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
 
--  samplesPerCall：采样点数，定义回调数据帧长。帧长必须为 10ms 的整数倍。
+- samplesPerCall：采样点数，定义回调数据帧长。帧长必须为 10ms 的整数倍。
 
 如果希望用毫秒数计算回调帧长，则将毫秒数转换成采样点数的公式为： `采样点数 = 毫秒数 * 采样率 / 1000` 。
 
@@ -1530,11 +1539,11 @@ Android 平台有两种投送方案：
 **设置经过前处理后的本地音频帧回调格式。**
 
 本接口用于设置 onLocalProcessedAudioFrame 回调出来的 AudioFrame 的格式：
--  sampleRate：采样率，支持：16000、32000、44100、48000。
+- sampleRate：采样率，支持：16000、32000、44100、48000。
 
--  channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+- channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
 
--  samplesPerCall：采样点数，定义回调数据帧长。帧长必须为 10ms 的整数倍。
+- samplesPerCall：采样点数，定义回调数据帧长。帧长必须为 10ms 的整数倍。
 
 如果希望用毫秒数计算回调帧长，则将毫秒数转换成采样点数的公式为： `采样点数 = 毫秒数 * 采样率 / 1000` 。
 
@@ -1558,11 +1567,11 @@ Android 平台有两种投送方案：
 **设置最终要由系统播放出的音频帧回调格式。**
 
 本接口用于设置 onMixedPlayAudioFrame 回调出来的 AudioFrame 的格式：
--  sampleRate：采样率，支持：16000、32000、44100、48000。
+- sampleRate：采样率，支持：16000、32000、44100、48000。
 
--  channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
+- channel：声道数（如果是立体声，数据是交叉的），单声道：1； 双声道：2。
 
--  samplesPerCall：采样点数，定义回调数据帧长。帧长必须为 10ms 的整数倍。
+- samplesPerCall：采样点数，定义回调数据帧长。帧长必须为 10ms 的整数倍。
 
 如果希望用毫秒数计算回调帧长，则将毫秒数转换成采样点数的公式为： `采样点数 = 毫秒数 * 采样率 / 1000` 。
 
@@ -1605,11 +1614,11 @@ Android 平台有两种投送方案：
 调用该接口之前，您需要先通过 enableCustomAudioRendering 开启音频自定义播放。
 
 参数 TRTCAudioFrame 推荐下列填写方式（其他字段不需要填写）：
--  sampleRate：采样率，必填，支持 16000、24000、32000、44100、48000。
+- sampleRate：采样率，必填，支持 16000、24000、32000、44100、48000。
 
--  channel：声道数，必填，单声道请填1，双声道请填2，双声道时数据是交叉的。
+- channel：声道数，必填，单声道请填1，双声道请填2，双声道时数据是交叉的。
 
--  data：用于获取音频数据的 buffer。需要您根据一帧音频帧的帧长度分配好 data 的内存大小。获取的 PCM 数据支持 10ms 或 20ms 两种帧长，推荐使用 20ms 的帧长。
+- data：用于获取音频数据的 buffer。需要您根据一帧音频帧的帧长度分配好 data 的内存大小。获取的 PCM 数据支持 10ms 或 20ms 两种帧长，推荐使用 20ms 的帧长。
 
 计算公式为： `采样率 x 播放时长 x 声道数量 x 2（每个样点的字节数）` ， 例如： 48000Hz 采样率、单声道、且播放时长为 20ms 的一帧音频帧的 buffer 大小为  `48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节` 。
 
@@ -1710,7 +1719,7 @@ true：消息已通过限制，等待后续视频帧发送；false：消息被
 
 > **注意**
 >
-> 1. 测速过程将产生少量的基础服务费用，详见 [计费概述 > 基础服务](https://cloud.tencent.com/document/product/647/17157#.E5.9F.BA.E7.A1.80.E6.9C.8D.E5.8A.A1) 文档说明。
+> 1. 测速过程将产生少量的基础服务费用，详见 [计费概述 > 基础服务](https://cloud.tencent.com/document/product/647/17157) 文档说明。
 >
 > 2. 请在进入房间前进行网速测试，在房间中网速测试会影响正常的音视频传输效果，而且由于干扰过多，网速测试结果也不准确。
 >
@@ -1762,11 +1771,11 @@ true：消息已通过限制，等待后续视频帧发送；false：消息被
 **设置本地日志的保存路径。**
 
 通过该接口您可以更改 SDK 本地日志的默认存储路径，SDK 默认的本地日志的存储位置：
--  Windows 平台：在 C:/Users/[系统用户名]/AppData/Roaming/liteav/log，即 %appdata%/liteav/log 下。
+- Windows 平台：在 C:/Users/[系统用户名]/AppData/Roaming/liteav/log，即 %appdata%/liteav/log 下。
 
--  iOS 或 Mac 平台：在 sandbox Documents/log 下。
+- iOS 或 Mac 平台：在 sandbox Documents/log 下。
 
--  Android 平台：在 /app私有目录/files/log/liteav/ 下。
+- Android 平台：在 /app私有目录/files/log/liteav/ 下。
 
 |参数|描述|
 |---------|---------|