@tencentcloud/sdk-mcp 1.3.9 → 1.4.1

package/resource/doc/rtcengine/web/plugin/28-advanced-beauty.md

@@ -8,96 +8,16 @@
 - [TRTC SDK](https://www.npmjs.com/package/trtc-sdk-v5) 版本需要 >= 5.5.0
 - 各平台系统及配置要求如下表：
 
-
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >平台</td>
-
-<td rowspan="1" colSpan="1" >操作系统</td>
-
-<td rowspan="1" colSpan="1" >浏览器版本</td>
-
-<td rowspan="1" colSpan="1" >fps</td>
-
-<td rowspan="1" colSpan="1" >推荐配置</td>
-
-<td rowspan="1" colSpan="1" >备注</td>
-</tr>
-
-<tr>
-<td rowspan="8" colSpan="1" >Web</td>
-
-<td rowspan="2" colSpan="1" >Windows</td>
-
-<td rowspan="2" colSpan="1" >Chrome 90+<br>Firefox 90+<br>Edge 97+</td>
-
-<td rowspan="1" colSpan="1" >30</td>
-
-<td rowspan="1" colSpan="1" >内存：16GB<br>CPU：i5-10500<br>GPU：独显 2GB</td>
-
-<td rowspan="3" colSpan="1" >建议使用最新版 Chrome 浏览器<br> <b> （开启浏览器硬件加速）</b></td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >15</td>
-
-<td rowspan="1" colSpan="1" >内存：8GB<br>CPU：i3-8300<br>GPU：intel 核显 1GB</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Mac</td>
-
-<td rowspan="1" colSpan="1" >Chrome 98+<br>Firefox 96+<br>Safari 14+</td>
-
-<td rowspan="1" colSpan="1" >30</td>
-
-<td rowspan="1" colSpan="1" >2019年 MacBook<br>内存：16GB(2667MHz)<br>CPU：i7(6核 2.60GHz)<br>GPU：AMD Radeon 5300M</td>
-</tr>
-
-<tr>
-<td rowspan="3" colSpan="1" >Android</td>
-
-<td rowspan="3" colSpan="1" >微信内嵌浏览器<br>Chrome<br>火狐浏览器<br>小米浏览器<br>华为浏览器</td>
-
-<td rowspan="1" colSpan="1" >30</td>
-
-<td rowspan="1" colSpan="1" >高端机（高通骁龙 8 Gen1 等）</td>
-
-<td rowspan="3" colSpan="1" >建议使用微信内嵌、Chrome 或火狐浏览器等主流浏览器<br>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >20</td>
-
-<td rowspan="1" colSpan="1" >中端机（天玑 8000-MAX 等）</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >10</td>
-
-<td rowspan="1" colSpan="1" >低端机（高通骁龙 660 等）</td>
-</tr>
-
-<tr>
-<td rowspan="2" colSpan="1" >iOS</td>
-
-<td rowspan="2" colSpan="1" >微信内嵌浏览器<br>Chrome<br>Safari<br>Firefox</td>
-
-<td rowspan="1" colSpan="1" >30</td>
-
-<td rowspan="1" colSpan="1" >iPhone 13</td>
-
-<td rowspan="2" colSpan="1" >- 要求 iOS 14.4 以上系统<br>- 建议使用 Chrome 或 Safari 浏览器<br>- <b> 不支持 QQ 浏览器</b></td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >20</td>
-
-<td rowspan="1" colSpan="1" >iPhone xr</td>
-</tr>
-
-</tr>
-</table>
+| 平台 | 操作系统 | 浏览器版本 | fps | 推荐配置 | 备注 |
+| --- | --- | --- | --- | --- | --- |
+| 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 14+ | 30 | 2019年 MacBook<br>内存：16GB(2667MHz)<br>CPU：i7(6核 2.60GHz)<br>GPU：AMD Radeon 5300M |  |  |
+| Android | 微信内嵌浏览器<br>Chrome<br>火狐浏览器<br>小米浏览器<br>华为浏览器 | 30 | 高端机（高通骁龙 8 Gen1 等） |  |  |
+| 20 | 中端机（天玑 8000-MAX 等） |  |  |  |  |
+| 10 | 低端机（高通骁龙 660 等） |  |  |  |  |
+| iOS | 微信内嵌浏览器<br>Chrome<br>Safari<br>Firefox | 30 | iPhone 13 | - 要求 iOS 14.4 以上系统<br>- 建议使用 Chrome 或 Safari 浏览器<br>- <b> 不支持 QQ 浏览器</b> |  |
+| 20 | iPhone xr |  |  |  |  |
 
 ## 使用步骤
 

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

@@ -28,7 +28,6 @@ TRTC Web SDK v5 提供了插件系统，支持按需加载各种音视频增强
 | **AIDenoiser** | AI 降噪，智能降低环境噪声，支持远场消除模式 | - | 尊享版 | 需要 | {@tutorial 35-advanced-ai-denoiser} |
 | **VoiceChanger** | 美声变声，支持 11 种变声效果（熊孩子、萝莉、大叔等） | ≥ 5.10.0 | 旗舰版 | - | {@tutorial 37-advanced-voice-changer} |
 | **RealtimeTranscriber** | 实时语音转录与翻译，将用户语音实时转换为文字并支持多语言翻译 | ≥ 5.15.0 | 无 | - | {@tutorial 42-advanced-realtime-transcriber} |
-| **Chorus** | 合唱，支持 KTV 合唱场景，包含主唱/伴唱角色、歌词同步、打分 | - | [联系我们](https://cloud.tencent.com/document/product/647/19906)开通 | - | - |
 
 ### 推流与混流类
 
@@ -43,9 +42,7 @@ TRTC Web SDK v5 提供了插件系统，支持按需加载各种音视频增强
 |---------|---------|---------|---------|---------|---------|
 | **DeviceDetector** | 设备检测，检测摄像头、麦克风、扬声器及网络，提供默认 UI | ≥ 5.8.0 | 无 | - | {@tutorial 23-advanced-support-detection} |
 | **Debug** | 调试模式，支持全量日志上传/导出、音视频转储 | ≥ 5.8.0 | 无 | - | {@tutorial 18-basic-debug} |
-| **TRTCVideoDecoder** | 视频解码器降级，解码失败时自动降级到软解码 | ≥ 5.9.0 | [联系我们](https://cloud.tencent.com/document/product/647/19906)开通 | 需要 | {@tutorial 39-advanced-video-decoder} |
 | **SmallStreamAutoSwitcher** | 大小流自动切换，弱网时自动切换小流保证流畅度 | ≥ 5.11.0 | 无 | - | {@tutorial 41-advanced-small-stream-auto-switcher} |
-<!-- | **CustomEncryption** | 自定义加密，支持音视频端到端加密，可自定义或使用内置加密算法 | - | 需联系我们开通 | - | - | -->
 
 > **说明：**
 > - **版本要求**：使用该插件所需的 TRTC SDK 最低版本
@@ -63,7 +60,7 @@ import TRTC from 'trtc-sdk-v5';
 import { VirtualBackground } from 'trtc-sdk-v5/plugins/video-effect/virtual-background';
 import { AIDenoiser } from 'trtc-sdk-v5/plugins/ai-denoiser';
 
-const trtc = TRTC.create({ 
+const trtc = TRTC.create({
   plugins: [VirtualBackground, AIDenoiser],
   assetsPath: 'https://your-cdn/assets' // 如果插件需要静态资源
 });
@@ -241,8 +238,8 @@ await trtc.updatePlugin('VideoMixer', {
 });
 
 // 使用合流后的 track 推流
-await trtc.startLocalVideo({ 
-  option: { 
+await trtc.startLocalVideo({
+  option: {
     videoTrack: track,
     profile: { width: 1920, height: 1080, bitrate: 2000 }
   }
@@ -262,7 +259,7 @@ TRTCVideoDecoder 插件注册后会自动在解码失败时启动降级逻辑，
 ```javascript
 import TRTCVideoDecoder from 'trtc-sdk-v5/plugins/video-decoder';
 
-const trtc = TRTC.create({ 
+const trtc = TRTC.create({
   plugins: [TRTCVideoDecoder],
   assetsPath: 'https://your-cdn/assets'
 });
@@ -386,7 +383,7 @@ cp -r node_modules/trtc-sdk-v5/assets ./public/assets
 创建 TRTC 实例时传入资源路径：
 
 ```javascript
-const trtc = TRTC.create({ 
+const trtc = TRTC.create({
   plugins: [VirtualBackground, AIDenoiser],
   assetsPath: 'https://your-cdn.com/assets'
 });

package/resource/doc/rtcengine/web/plugin/34-advanced-proxy.md

@@ -28,7 +28,7 @@ trtc.on(TRTC.EVENT.ERROR, error => {
   // 用户网络防火墙受限，会导致无法正常进行音视频通话。
   // 此时引导用户更换网络 or 检查网络防火墙设置。
   if (error.code === TRTC.ERROR_CODE.OPERATION_FAILED && error.extraCode === 5501) {
-    
+
   }
 });
 ```
@@ -37,14 +37,13 @@ trtc.on(TRTC.EVENT.ERROR, error => {
 
 > 该方案适用于：您确定用户的网络是受防火墙限制的，此时需要搭建代理服务器来解决。
 
-
 | 方案 | 适用场景                           | 网络要求                                                                     |
 | ------ | ---------------------------------- | ---------------------------------------------------------------------------- |
 | 2-A | 用户网络可以访问特定的外网代理服务器   | 代理服务器搭建在外网，内网防火墙需开通白名单，允许内网用户访问外网的代理服务器。       |
 | 2-B | 用户网络只能访问内网代理服务器 | 代理服务器搭建在内网，内网防火墙需开通白名单，允许内网代理服务器访问外网。 |
 
 <div style="display: flex;justify-content: center;">
-  <img src="./assets/proxy-1.png"/>
+
 </div>
 
   <div style="display: flex;justify-content: center;">
@@ -52,7 +51,7 @@ trtc.on(TRTC.EVENT.ERROR, error => {
   </div>
 
 <div style="display: flex;justify-content: center;">
-	<img src="./assets/proxy-2.png" />
+
 </div>
 
 <div style="display: flex;justify-content: center;">2-B 方案示例图</div>
@@ -62,7 +61,7 @@ trtc.on(TRTC.EVENT.ERROR, error => {
 当您搭建好 Nginx 和 Turn server 后，可以参考如下示例，设置代理服务器。
 
 ```javascript
-const trtc = TRTC.create(); 
+const trtc = TRTC.create();
 
 await trtc.enterRoom({
   ...,
@@ -72,7 +71,7 @@ await trtc.enterRoom({
     // 设置 turn server，用于中转 SDK 与 TRTC 后台的媒体数据包。14.3.3.3:3478 为 turn server 的 ip 及端口。
     turnServer: { url: '14.3.3.3:3478', username: 'turn', credential: 'turn', credentialType: 'password' },
     // 默认 SDK 会直连 TRTC 服务器，如果连不上，则会尝试连 TURN server。你可以指定 'relay' 来强制连接 TURN server。
-    iceTransportPolicy: 'all', 
+    iceTransportPolicy: 'all',
     // SDK 默认会向 yun.tim.qq.com 域名上报日志，但若该域名在您的内网无法访问，您需要给该域名开白名单或者配置以下日志代理。
     // 设置日志上报代理，日志是排查问题的关键数据，请务必设置该代理。
     loggerProxy: 'https://proxy.example.com/logger/',
@@ -91,32 +90,32 @@ await trtc.enterRoom({
 2. 配置 Nginx 服务器
 
    ```sh
-   vi /etc/nginx/nginx.conf 
+   vi /etc/nginx/nginx.conf
    ```
 
    ```
    http {
-     server { 
+     server {
        # nginx 服务器的访问域名
-       server_name proxy.example.com; 
+       server_name proxy.example.com;
        # nginx 服务器的访问端口
-       listen 443; 
-   
-       ssl on; 
-   
+       listen 443;
+
+       ssl on;
+
        location /ws/ { # 对应 setProxyServer 中的 websocketProxy 参数
          proxy_pass https://signaling.rtc.qq.com/; # TRTC 的服务器
-         proxy_http_version 1.1; 
-         proxy_set_header Upgrade $http_upgrade; 
-         proxy_set_header Connection "upgrade"; 
+         proxy_http_version 1.1;
+         proxy_set_header Upgrade $http_upgrade;
+         proxy_set_header Connection "upgrade";
        }
        location /logger/ { # 对应 setProxyServer 中的 loggerProxy 参数
          proxy_pass https://yun.tim.qq.com/;
        }
-   
-       #域名对应的 SSL 证书，HTTPS 用，用户自行申请 
-       ssl_certificate ./crt/1_proxy.trtcapi.com_bundle.crt; 
-       ssl_certificate_key ./crt/2_proxy.trtcapi.com.key; 
+
+       #域名对应的 SSL 证书，HTTPS 用，用户自行申请
+       ssl_certificate ./crt/1_proxy.trtcapi.com_bundle.crt;
+       ssl_certificate_key ./crt/2_proxy.trtcapi.com.key;
      }
    }
    ```
@@ -137,44 +136,44 @@ await trtc.enterRoom({
 
    ```sh
    #!/usr/bin/env bash
-   
+
    # current file name is turn.sh
-   
+
    # ref:
    # https://gabrieltanner.org/blog/turn-server    STEP 3 testing turn server
    # https://medium.com/av-transcode/what-is-webrtc-and-how-to-setup-stun-turn-server-for-webrtc-communication-63314728b9d0
-   
+
    # as super-user
    # usage:  current_program <external-ip>
-   
+
    set -x
    set -e
-   
+
    ip a
    pwd
    whoami
-   
+
    display_usage() {
            echo "This script must be run with super-user privileges."
            echo -e "\nUsage: $0 <external-ip> \ne.g. $0 154.8.246.205"
    }
-   
+
    # if less than two arguments supplied, display usage
    if [ $# -lt 1 ]
    then
            display_usage
            exit 1
    fi
-   
+
    if [[ $1 =~ ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
      echo "get external ip $1"
    else
      echo "wrong external ip $1 , must not have whitespace, tab and other char"
      exit 2
    fi
-   
+
    yum install -y coturn
-   
+
    # $1 is <external-ip>
    cat <<EOF > /etc/coturn/turnserver.conf
    external-ip=$1
@@ -206,10 +205,10 @@ await trtc.enterRoom({
 
    ```sh
    systemctl start coturn
-   
+
    # 检测 turn 是否启动成功
    ps aux | grep coturn
-   
+
    # 若要重启服务，则执行
    service coturn restart 
    ```
@@ -222,8 +221,6 @@ await trtc.enterRoom({
 
    使用该[测试页面](https://webrtc.github.io/samples/src/content/peerconnection/trickle-ice/)，测试搭建好的 turn server 是否能够正常连通访问。如下截图中 done 说明 turn 能正常访问。
 
-   <img src="./assets/turn-test.png" alt="turn-test" style="zoom: 33%;" />
-
 ### 2-B 方案
 
 2-B 方案搭建 Nginx 代理的方式，与 2-A 方案相同。主要有两处区别：
@@ -241,4 +238,3 @@ sudo ./turn.sh 10.0.0.4
 
 - 对于 Nginx 服务器，需要在公司内网防火墙配置域名白名单，允许 Nginx 服务器访问 TRTC 的相关域名，参考：[TRTC Web SDK 域名和端口白名单](https://cloud.tencent.com/document/product/647/34399#webrtc-.E9.9C.80.E8.A6.81.E9.85.8D.E7.BD.AE.E5.93.AA.E4.BA.9B.E7.AB.AF.E5.8F.A3.E6.88.96.E5.9F.9F.E5.90.8D.E4.B8.BA.E7.99.BD.E5.90.8D.E5.8D.95.EF.BC.9F)
 - 对于 Turn Server，需要允许 Turn Server 能够访问外网。
-

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

@@ -27,7 +27,6 @@ AI 降噪插件能够降低通话中的噪声，减少环境噪声对通话的
   > - 如果目录下文件的 Host URL 与网页应用的 Host URL 不一致，则需要开启访问文件域名的 CORS 策略。
   > - 不能把目录文件放在 HTTP 服务下，因为在 HTTPS 域名下加载 HTTP 资源会被浏览器安全策略禁止。
 
-
 #### 开启降噪
 
 ```javascript
@@ -81,4 +80,3 @@ await trtc.stopPlugin('AIDenoiser');
 ### trtc.stopPlugin('AIDenoiser')
 
 用于关闭降噪
-

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

@@ -4,7 +4,7 @@
 
 | 原始摄像头                                                                                | 背景虚化                                                                                  | 背景图片                                                                                  |
 | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
-| <img src="https://qcloudimg.tencent-cloud.cn/raw/28a9246a5e1071ea0200bfde6d2b110b.jpg" /> | <img src="https://qcloudimg.tencent-cloud.cn/raw/a605b69b39cea73a6ebfde6324e93fff.jpg" /> | <img src="https://qcloudimg.tencent-cloud.cn/raw/fec848fc9ff4a2b4dbfc49a5f4c2fb3d.jpg" /> |
+|  |  |  |
 
 ## 前提条件
 
@@ -12,53 +12,11 @@
 - TRTC Web SDK 版本 >= 5.2.0
 - 各平台系统及配置要求如下表：
 
-
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >平台</td>
-
-<td rowspan="1" colSpan="1" >操作系统</td>
-
-<td rowspan="1" colSpan="1" >浏览器版本</td>
-
-<td rowspan="1" colSpan="1" >fps</td>
-
-<td rowspan="1" colSpan="1" >推荐配置</td>
-
-<td rowspan="1" colSpan="1" >备注</td>
-</tr>
-
-<tr>
-<td rowspan="8" colSpan="1" >Web</td>
-
-<td rowspan="2" colSpan="1" >Windows</td>
-
-<td rowspan="2" colSpan="1" >Chrome 90+<br>Firefox 90+<br>Edge 97+</td>
-
-<td rowspan="1" colSpan="1" >30</td>
-
-<td rowspan="1" colSpan="1" >内存：16GB<br>CPU：i5-10500<br>GPU：独显 2GB</td>
-
-<td rowspan="3" colSpan="1" >建议使用最新版 Chrome 浏览器<br> <b> （开启浏览器硬件加速）</b></td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >15</td>
-
-<td rowspan="1" colSpan="1" >内存：8GB<br>CPU：i3-8300<br>GPU：intel 核显 1GB</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Mac</td>
-
-<td rowspan="1" colSpan="1" >Chrome 98+<br>Firefox 96+<br>Safari 15+</td>
-
-<td rowspan="1" colSpan="1" >30</td>
-
-<td rowspan="1" colSpan="1" >2019年 MacBook<br>内存：16GB(2667MHz)<br>CPU：i7(6核 2.60GHz)<br>GPU：AMD Radeon 5300M</td>
-</tr>
-
-</table>
+| 平台 | 操作系统 | 浏览器版本 | fps | 推荐配置 | 备注 |
+| --- | --- | --- | --- | --- | --- |
+| 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 |  |  |
 
 ## 实现流程
 
@@ -162,7 +120,7 @@ await trtc.startPlugin('VirtualBackground', {
 | Name      | Type     | Attributes             | Description                                                            |
 | --------- | -------- | ---------------------- | ---------------------------------------------------------------------- |
 | type      | `string` | 必填                   | - `image` 图片背景 <br> - `blur` 虚化背景                              |
-| enableFaceCentering (Since v5.11.0)      | `boolean`        | 选填                   |`false`（默认）    
+| enableFaceCentering (Since v5.11.0)      | `boolean`        | 选填                   |`false`（默认）
 | blurLevel | `number` | 选填                   | - `blur` 虚化背景时可用，用于调节虚化程度，默认为 3，取值范围为 [1,10] |
 | src       | `string` | type 为 `image` 时必填 | 图片地址，如 `https://picsum.photos/seed/picsum/200/300`               |
 

package/resource/doc/rtcengine/web/plugin/37-advanced-voice-changer.md

@@ -95,4 +95,4 @@ await trtc.updatePlugin('VoiceChanger', {
 // 关闭麦克风采集前关闭美声插件
 await trtc.stopPlugin('VoiceChanger');
 await trtc.stopLocalAudio();
-```
+```

package/resource/doc/rtcengine/web/plugin/39-advanced-video-decoder.md

@@ -6,8 +6,6 @@
 
 - TRTC Web SDK 版本 >= 5.9.0
 
-- [联系我们](https://cloud.tencent.com/document/product/647/19906)开通解码器降级能力
-
 ## 实现流程
 
 ### 部署静态资源
@@ -19,7 +17,6 @@
   > - 如果目录下文件的 Host URL 与网页应用的 Host URL 不一致，则需要开启访问文件域名的 CORS 策略。
   > - 不能把目录文件放在 HTTP 服务下，因为在 HTTPS 域名下加载 HTTP 资源会被浏览器安全策略禁止。
 
-
 ### 引入并注册插件
 
 ```javascript

package/resource/doc/rtcengine/web/plugin/40-advanced-video-mixer.md

@@ -2,8 +2,6 @@
 
 本文档详细介绍了如何使用 TRTC Web SDK 的 VideoMixer 插件，将摄像头、屏幕共享、文字、图片和视频等多个输入源合成为一个视频轨道，实现自定义布局的推流。开发者可以灵活控制每个源的布局（位置、大小、层级 zIndex）。
 
-![The Workflow of Video Mixer](./assets/videomixer-workflow.png)
-
 ## 前提条件
 
 - TRTC Web SDK version >= 5.12.0.
@@ -51,7 +49,7 @@ const { track } = await trtc.startPlugin('VideoMixer', options);
 合流插件只负责生成合流后的视频轨道，推流操作仍由 TRTC SDK 控制。将 startPlugin 返回的 track 作为参数传入 startLocalVideo 接口即可进行推流。
 
 ```js
-await trtc.startLocalVideo({ option: { 
+await trtc.startLocalVideo({ option: {
   videoTrack: track,
   profile: { width: 1920, height: 1080, bitrate: 2000 } // 设置编码参数
 }});
@@ -64,7 +62,7 @@ await trtc.startLocalVideo({ option: {
 **更新规则：**
 
 * **输入源说明：** 输入源分为：`camera, screen, text, image, video`。都是数组，每一个数组元素代表一个输入源，通过 id 属性做唯一标识。
-* **更新输入源：** 传入相同 id，并修改其他参数。  
+* **更新输入源：** 传入相同 id，并修改其他参数。
 * **添加输入源：** 传入新的 id 对象。
 * **移除输入源：** 从对应的输入源数组中去掉该对象。
 
@@ -73,7 +71,7 @@ await trtc.startLocalVideo({ option: {
 可以控制摄像头的采集和布局。
 
 ```javascript
-// 更新 id 为 'camera1' 的摄像头布局  
+// 更新 id 为 'camera1' 的摄像头布局
 await trtc.updatePlugin('VideoMixer', {
   camera: [
     {
@@ -84,7 +82,7 @@ await trtc.updatePlugin('VideoMixer', {
   ]
 });
 
-// 移除所有摄像头  
+// 移除所有摄像头
 await trtc.updatePlugin('VideoMixer', { camera: [] });
 // 如果只是想临时隐藏画布上的输入源，而不是物理关闭采集，可以在 layout 参数中设置 hidden: true。其他输入源同理。
 ```
@@ -102,7 +100,7 @@ await trtc.updatePlugin('VideoMixer', {
       y: 0,
       width: 1920,
       height: 1080,
-      zIndex: 0,      
+      zIndex: 0,
     },
     systemAudio: true, // 是否采集系统音频，默认不采集 v5.15 版本新增
   }],
@@ -143,13 +141,13 @@ await trtc.updatePlugin('VideoMixer', {
 
 ```js
 await trtc.updatePlugin('VideoMixer', {
-  image: [{ 
-    id: 'img1', 
+  image: [{
+    id: 'img1',
     url: './image.png',
     layout: { x: 0, y: 500, width: 800, height: 400, zIndex: 4 }
   }],
-  video: [{ 
-    id: 'video1', 
+  video: [{
+    id: 'video1',
     url: './video.mp4',
     layout: { x: 0, y: 0, width: 1000, height: 500, zIndex: 5 }
   }]
@@ -190,11 +188,11 @@ try {
   })
   console.log(result.successOptions) // 本次更新成功应用的参数
 } catch (error: any) {
-  // 场景二：全部失败时的错误捕获 (捕获抛出的错误)  
+  // 场景二：全部失败时的错误捕获 (捕获抛出的错误)
   console.error(error);
   error?.data?.failedDetails.forEach(({ id, error }: { id: string, error: any }) => {
     console.error(`${id} mix failed`, error);
-  })  
+  })
 }
 ```
 
@@ -221,7 +219,6 @@ try {
 | video             | [VideoSource](#videosource)[]       | 选填     | 控制视频输入源的参数                                                                                                 |
 | onScreenShareStop | `(id: string) => {}`                | 选填     | 合流共享屏幕停止时调用的回调，用户未通过 sdk 而是通过浏览器按钮取消屏幕分享时可能会用到，回调参数为停止采集的屏幕 id |
 
-
 **Returns: Promise\<MixParseResult\>**
 
 `MixParseResult`
@@ -230,7 +227,10 @@ try {
 | ------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | track  | [MediaStreamTrack](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack)  | 合流输出的视频轨道                                                                                                                                                                                                                                                           |
 | systemAudioTrackList  | object | 系统音频轨道列表。在设置 ScreenSource 参数 systemAudio:true 并且采集成功后会返回系统音频的 audio track。数据格式为：{key: audioTrack}，其中 key 为 ScreenSource 配置的 ID，例如： {id1: audioTrack，id2: audioTrack}                                                                                                                                                                                                                                                         |
-| result | object            | 本次传入的参数中执行成功或失败的相关信息，结构如下：<table><tr><th>Name</th><th>Type</th><th>Description</th></tr><tr><td>successOptions</td><td>[Options](#options)</td><td>本次更新成功执行的 options </td></tr><tr><td>failedDetails</td><td>MixFailedDetail[]</td><td>本次更新执行失败详细信息</td></tr></table> |
+| result | object            | 本次传入的参数中执行成功或失败的相关信息，结构如下：| Name | Type | Description |
+| --- | --- | --- |
+| successOptions | [Options](#options) | 本次更新成功执行的 options |
+| failedDetails | MixFailedDetail[] | 本次更新执行失败详细信息 | |
 
 `MixFailedDetail`
 
@@ -323,10 +323,10 @@ try {
 
 ### 1. 帧率与性能优化
 
-* **帧率设置：**  
-  * **不推荐**手动设置 canvasInfo.frameRate。  
-  * **推荐**由插件内部自动计算：当存在摄像头或屏幕分享时，取两者中的最大帧率；否则固定为 15 帧。手动指定可能导致性能损失。  
-* **性能考量：**  
+* **帧率设置：**
+  * **不推荐**手动设置 canvasInfo.frameRate。
+  * **推荐**由插件内部自动计算：当存在摄像头或屏幕分享时，取两者中的最大帧率；否则固定为 15 帧。手动指定可能导致性能损失。
+* **性能考量：**
   * 画布分辨率越大、合流的输入源越多，渲染开销越大。业务侧应根据用户设备性能情况，决定合适的画布参数和输入源数量。
 
 ### 2. 分辨率、码率怎么设置？
@@ -377,4 +377,4 @@ await trtc.startPlugin('VideoMixer', {
     console.log(`screen share stop, id: ${id}`);
   }
 });
-```
+```

package/resource/doc/rtcengine/web/plugin/41-advanced-small-stream-auto-switcher.md

@@ -84,7 +84,7 @@ trtc.startPlugin('SmallStreamAutoSwitcher', {
 2. 帧率条件：小流帧率稳定（最大帧率与最小帧率的差值不超过最大帧率的1/3）
 3. 限制条件：用户当前订阅的是小流，且该用户只切换过1次小流，且不在休眠期
 
-> **注意：** 
+> **注意：**
 > - 检测频率为每 2 秒一次
 > - 网络质量和帧率数据的统计窗口大小自动适应poorDuration和goodDuration的最大值
 > - 每次切换后会进入 `sleepTime` 时长的休眠期，期间不会再次触发自动切换

package/resource/doc/rtcengine/web/plugin/42-advanced-realtime-transcriber.md

@@ -90,7 +90,7 @@ const robotId = await trtc.startPlugin('RealtimeTranscriber', {
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (data) => {
   console.log(`👤 ${data.speakerUserId}:`);
   console.log(`  原文: ${data.sourceText}`);
-  
+
   if (data.translationTexts) {
     Object.entries(data.translationTexts).forEach(([lang, text]) => {
       console.log(`  ${lang.toUpperCase()}: ${text}`);
@@ -204,10 +204,10 @@ trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED, (event) => {
 ```javascript
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
   const { speakerUserId, sourceText, translationTexts, isCompleted } = event;
-  
+
   // 显示实时转录结果
   console.log(`[${isCompleted ? '完成' : '进行中'}] ${speakerUserId}: ${sourceText}`);
-  
+
   // 显示翻译结果
   if (translationTexts) {
     translationTexts.forEach(({ language, text }) => {
@@ -301,7 +301,7 @@ const subtitleMap = new Map();
 
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
   subtitleMap.set(event.segmentId, event);
-  
+
   if (event.isCompleted) {
     // 语音片段完成，可以归档
     archiveSubtitle(subtitleMap.get(event.segmentId));

package/resource/doc/rtcengine/web/plugin/43-advanced-face-detection.md

@@ -34,8 +34,8 @@
 ```javascript
 import { FaceDetection } from 'trtc-sdk-v5/plugins/video-effect/face-detection';
 
-const trtc = TRTC.create({ 
-  plugins: [FaceDetection], 
+const trtc = TRTC.create({
+  plugins: [FaceDetection],
   assetsPath: 'https://xxxx/assets'  // 替换为您的静态资源地址
 });
 ```
@@ -177,4 +177,4 @@ await trtc.updatePlugin('FaceDetection', {
 
 **2. 视频流恢复后需要重新开启检测吗？**
 
-不需要。插件会自动处理视频流状态变化，恢复后会继续检测。
+不需要。插件会自动处理视频流状态变化，恢复后会继续检测。