@tencentcloud/sdk-mcp 1.7.6 → 1.7.8

package/resource/knowledge/chat/preset/react/h5/integration.md

@@ -78,7 +78,7 @@ npm create vite@latest
 
 【shell】
 ``` bash
-npm install @tencentcloud/chat-uikit-react @tencentcloud/uikit-base-component-react
+npm install @tencentcloud/chat-uikit-react @tencentcloud/uikit-base-component-react @trtc/calls-uikit-react
 ```
 
 ### 步骤2：引入组件
@@ -163,6 +163,7 @@ npm install @tencentcloud/chat-uikit-react @tencentcloud/uikit-base-component-re
    ``` typescript
    import { useState } from 'react';
    import { LoginStatus, UIKitProvider, useLoginState } from '@tencentcloud/chat-uikit-react';
+   import { TUICallKit } from '@trtc/calls-uikit-react';
    import { LoginView } from './LoginView';
    import { ChatLayout } from './ChatLayout';
    import { languageResources } from './i18n';
@@ -177,9 +178,14 @@ npm install @tencentcloud/chat-uikit-react @tencentcloud/uikit-base-component-re
      const [language, setLanguage] = useState('zh-CN');
 
      return (
-       <UIKitProvider language={language} languageResources={languageResources}>
+       <UIKitProvider theme="light" language={language} languageResources={languageResources}>
          {isLogined
-           ? <ChatLayout onChangeLanguage={setLanguage} />
+           ? (
+             <>
+               <ChatLayout onChangeLanguage={setLanguage} />
+               <TUICallKit className="call-kit" />
+             </>
+           )
            : <LoginView language={language} onChangeLanguage={setLanguage} />}
        </UIKitProvider>
      );
@@ -833,10 +839,10 @@ npm run dev
 ### 音视频通话
 
 > **说明：**
-> TUICallKit 是腾讯云推出的一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
->
+> - TUICallKit 是腾讯云推出的一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
 > 更多详细信息可参考：音视频通话-开通服务。
 >
+> - 在上面的过程中已经集成了 TUICallKit，若不需要音视频通话功能，可参考以下过程移除集成代码。
 
 1. 安装 `@trtc/calls-uikit-react` 依赖
 
@@ -882,6 +888,11 @@ npm run dev
 
    export default App;
    ```
+3. 如果不需要集成音视频通话，可以通过移除 `<TUICallKit />`、修改 MessageInputH5 组件的 `actions` 属性，来移除音视频通话的能力。
+
+   ``` typescript
+   <MessageInputH5 actions={['EmojiPicker', 'ImagePicker', 'VideoPicker', 'FilePicker']} />
+   ```
 
 ### 云端搜索
 

package/resource/knowledge/chat/preset/vue/features/conversation-list.md

@@ -274,8 +274,11 @@ const handleFilterClick = (filterType: FilterType) => {
 |PlaceholderLoadError|Component|<PlaceHolder type={PlaceHolderTypes.WRONG} />|自定义会话列表加载错误时的占位元素。|
 |filter|(conversationList: ConversationInfo[]) => ConversationInfo[]|-|用于筛选会话列表的函数。|
 |sort|(conversationList: ConversationModel[]) => ConversationModel[]|-|用于排序会话列表的函数。|
-|onConversationSelect|(conversation: ConversationInfo) => void;|-|点击会话后的回调函数，参数为所点击的会话对象。|
-|onBeforeCreateConversation|(params: CreateParams) => CreateParams;|-|创建会话前执行的自定义操作，参数为创建会话所需的参数。|
-|onConversationCreate|(conversation: ConversationInfo)  => void;|-|会话创建后的回调函数，参数为创建的会话对象。|
 |className|String|-|指定根元素类的 CSS 自定义名称。|
 |style|CSSProperties|-|指定根元素样式的自定义样式。|
+
+## Emits
+| conversation-select | (conversation: ConversationInfo) => void; | - | 点击会话后的回调函数，参数为所点击的会话对象。 |
+| --- | --- | --- | --- |
+| before-create-conversation | (params: CreateParams) => CreateParams; | - | 创建会话前执行的自定义操作，参数为创建会话所需的参数。 |
+| conversation-created | (conversation: ConversationInfo)  => void; | - | 会话创建后的回调函数，参数为创建的会话对象。 |

package/resource/knowledge/chat/preset/vue/h5/integration.md

@@ -80,7 +80,7 @@ npm create vite@latest
 
 【shell】
 ``` bash
-npm install @tencentcloud/chat-uikit-vue3 @tencentcloud/uikit-base-component-vue3
+npm install @tencentcloud/chat-uikit-vue3 @tencentcloud/uikit-base-component-vue3 @trtc/calls-uikit-vue
 ```
 
 ### 步骤2：引入组件
@@ -163,6 +163,7 @@ npm install @tencentcloud/chat-uikit-vue3 @tencentcloud/uikit-base-component-vue
    <script setup lang="ts">
    import { ref, watch } from 'vue';
    import { UIKitProvider, useLoginState } from '@tencentcloud/chat-uikit-vue3';
+   import { TUICallKit } from '@trtc/calls-uikit-vue';
    import LoginView from './LoginView.vue';
    import ChatLayout from './ChatLayout.vue';
    import { languageResources } from './i18n';
@@ -184,8 +185,10 @@ npm install @tencentcloud/chat-uikit-vue3 @tencentcloud/uikit-base-component-vue
      <UIKitProvider theme="light" :language="language" :language-resources="languageResources">
        <LoginView v-if="loginStatus !== LoginStatus.LOGINED" />
        <ChatLayout v-else />
+       <TUICallKit class="call-kit" />
      </UIKitProvider>
    </template>
+
    ```
 4. 配置登录页和聊天页面。
 
@@ -580,10 +583,10 @@ npm run dev
 ### 音视频通话
 
 > **说明：**
-> TUICallKit 是腾讯云推出的一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
->
+> - TUICallKit 是腾讯云推出的一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
 > 更多详细信息可参考：音视频通话-开通服务。
 >
+> - 在上面的过程中已经集成了 TUICallKit，若不需要音视频通话功能，可参考以下过程移除集成代码。
 
 1. 安装 @trtc/calls-uikit-vue 依赖。
 
@@ -631,7 +634,7 @@ npm run dev
    </template>
 
    ```
-3. 如果不需要集成音视频通话，可以修改 MessageInputH5 组件 actions 属性，来隐藏语音通话和视频通话的入口。
+3. 如果不需要集成音视频通话，可以通过移除 `<TUICallKit />`、修改 MessageInputH5 组件的 `actions` 属性，来移除音视频通话的能力。
 
    ``` typescript
    <MessageInputH5 class="chat-pane__input" :actions="['EmojiPicker', 'ImagePicker', 'VideoPicker', 'FilePicker']" />

package/resource/knowledge/push/config/android/honor.md

@@ -57,7 +57,22 @@
 
 ### 配置回执和点击统计
 
-如需统计消息触达或点击数据，请在厂商配置阶段设置回执地址为：`https://api.im.qcloud.com/v3/offline_push_report/honor`。
+如需统计消息触达或点击数据，请在厂商配置阶段设置回执地址为：`https://<domain>/v3/offline_push_report/honor`，其中 domain 取决于你的站点。目前支持的站点有：
+- 中   国： `https://api.im.qcloud.com/v3/offline_push_report/honor`
+
+- 新加坡： `https://apisgp.im.qcloud.com/v3/offline_push_report/honor`
+
+- 德   国： `https://apiger.im.qcloud.com/v3/offline_push_report/honor`
+
+- 美   国： `https://apiusa.im.qcloud.com/v3/offline_push_report/honor`
+
+- 韩   国： `https://apikr.im.qcloud.com/v3/offline_push_report/honor`
+
+- 印   尼：`https://apiidn.im.qcloud.com/v3/offline_push_report/honor`
+
+- 日   本： `https://apijpn.im.qcloud.com/v3/offline_push_report/honor`
+
+- 中   东： `https://apiksa.im.qcloud.com/v3/offline_push_report/honor`
 
 ## 合规提示
 

package/resource/knowledge/push/config/android/huawei.md

@@ -55,11 +55,27 @@
 
 ### 配置回执和点击统计
 
-如需统计消息触达或点击数据，请配置回执，回调地址填写：`https://api.im.qcloud.com/v3/offline_push_report/huawei`。
+如需统计消息触达或点击数据，请在厂商配置阶段设置回执地址为：`https://<domain>/v3/offline_push_report/huawei`，其中 domain 取决于你的站点。目前支持的站点有：
+- 中   国： `https://api.im.qcloud.com/v3/offline_push_report/huawei`
 
-> **注意：**
-> 华为推送证书 ID <= 11344 时，使用华为推送 v2 版本接口，不支持触达和点击回执，请重新生成更新证书 ID 。
->
+- 新加坡： `https://apisgp.im.qcloud.com/v3/offline_push_report/huawei`
+
+- 德   国： `https://apiger.im.qcloud.com/v3/offline_push_report/huawei`
+
+- 美   国： `https://apiusa.im.qcloud.com/v3/offline_push_report/huawei`
+
+- 韩   国： `https://apikr.im.qcloud.com/v3/offline_push_report/huawei`
+
+- 印   尼：`https://apiidn.im.qcloud.com/v3/offline_push_report/huawei`
+
+- 日   本： `https://apijpn.im.qcloud.com/v3/offline_push_report/huawei`
+
+- 中   东： `https://apiksa.im.qcloud.com/v3/offline_push_report/huawei`
+
+   > **注意：**
+   >
+   > 华为推送证书 ID <= 11344 时，使用华为推送 v2 版本接口，不支持触达和点击回执，请重新生成更新证书 ID 。
+   >
 
 ## 消息分类限制对推送效果的影响
 

package/resource/knowledge/push/config/android/meizu.md

@@ -56,13 +56,27 @@
 
 ### 配置回执和点击统计
 
-如需统计消息触达或点击数据，请在厂商开放平台开启回执：
+如需统计消息触达或点击数据，请在厂商配置阶段设置回执地址为：`https://<domain>/v3/offline_push_report/meizu`，其中 domain 取决于你的站点。目前支持的站点有：
+- 中   国： `https://api.im.qcloud.com/v3/offline_push_report/meizu`
 
-并设置回执地址为：`https://api.im.qcloud.com/v3/offline_push_report/meizu` ：
+- 新加坡： `https://apisgp.im.qcloud.com/v3/offline_push_report/meizu`
 
-> **注意：**
-> 打开回执开关后，请务必确保回执地址正确配置。不配置或者配置地址错误，都会影响推送功能。
->
+- 德   国： `https://apiger.im.qcloud.com/v3/offline_push_report/meizu`
+
+- 美   国： `https://apiusa.im.qcloud.com/v3/offline_push_report/meizu`
+
+- 韩   国： `https://apikr.im.qcloud.com/v3/offline_push_report/meizu`
+
+- 印   尼：`https://apiidn.im.qcloud.com/v3/offline_push_report/meizu`
+
+- 日   本： `https://apijpn.im.qcloud.com/v3/offline_push_report/meizu`
+
+- 中   东： `https://apiksa.im.qcloud.com/v3/offline_push_report/meizu`
+
+   > **注意：**
+   >
+   > 打开回执开关后，请务必确保回执地址正确配置。不配置或者配置地址错误，都会影响推送功能。
+   >
 
 ## 消息分类限制对推送效果的影响
 

package/resource/knowledge/push/config/android/vivo.md

@@ -49,7 +49,26 @@
 
 ### 配置回执和点击统计
 
-如需统计消息触达或点击数据，请在 vivo 开放平台设置 App 回执地址为：`https://api.im.qcloud.com/v3/offline_push_report/vivo`，并在腾讯云控制台设置回执 ID。
+如需统计消息触达或点击数据，请在厂商配置阶段设置 App 回执地址为：`https://<domain>/v3/offline_push_report/vivo`，并在腾讯云控制台设置回执 ID，其中 domain 取决于你的站点。目前支持的站点有：
+- 中   国： `https://api.im.qcloud.com/v3/offline_push_report/vivo`
+
+- 新加坡： `https://apisgp.im.qcloud.com/v3/offline_push_report/vivo`
+
+- 德   国： `https://apiger.im.qcloud.com/v3/offline_push_report/vivo`
+
+- 美   国： `https://apiusa.im.qcloud.com/v3/offline_push_report/vivo`
+
+- 韩   国： `https://apikr.im.qcloud.com/v3/offline_push_report/vivo`
+
+- 印   尼：`https://apiidn.im.qcloud.com/v3/offline_push_report/vivo`
+
+- 日   本： `https://apijpn.im.qcloud.com/v3/offline_push_report/vivo`
+
+- 中   东： `https://apiksa.im.qcloud.com/v3/offline_push_report/vivo`
+
+   |**回调地址配置**|**腾讯云即时通信 IM 控制台**|
+   |---------|---------|
+   |||
 
 ## 消息分类限制对推送效果的影响
 

package/resource/knowledge/push/config/harmonyos.md

@@ -14,7 +14,14 @@
 ### 步骤1：开启推送服务
 1. 登录 [AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/)，在首页选择**开发与服务**，选择对应的项目，单击**立即开通**以开启推送服务。
 
-2. 项目设置中，API 管理 tab 页面搜索 `Push`，打开推送服务。
+2. 若项目当前未配置数据处理位置，请在提示中点击**确定**，会弹出设置数据处理位置的弹窗。完成数据处理位置的设置，点击**确定**。
+
+   5-10 分钟后访问 [AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)，**项目设置 > 开放能力管理** 中推送服务能力会显示已勾选。同时，**增长 > 推送服务**中“推送服务”会自动开通。
+
+   > **说明：**
+   >
+   > 详情请参考 HarmonyOS 官方文档：[开通推送服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-config-setting)。
+   >
 
 ### 步骤2：证书与签名申请
 1. **证书申请：调试阶段必须申请调试证书，发布阶段必须申请发布证书。**
@@ -42,7 +49,7 @@
 
       > **说明：**
       >
-      > 关于各类型设备如何获取 UDID，请参见 [UDID 获取方法](https://developer.huawei.com/consumer/cn/doc/app/agc-help-add-device-0000002283189937#section67331926102911)。
+      > 关于各类型设备如何获取 UDID，请参见 HarmonyOS 官方文档：[UDID 获取方法](https://developer.huawei.com/consumer/cn/doc/app/agc-help-add-device-0000002283189937#section67331926102911)。
       >
 
 3. **申请 Profile 文件：调试阶段必须申请调试 Profile 文件，发布阶段必须申请发布 Profile 文件。**
@@ -59,22 +66,31 @@
 
 5. **调试阶段自动签名（仅适用调试阶段，不适用发布阶段）**
 
-   针对开发调试场景，从 DevEco Studio 6.0.0 Beta5 版本开始，新增了更高效的自动签名以及开通 Push Kit 开放能力方案，请参考 [HarmonyOS 官方配置](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-config-setting)。
+   针对开发调试场景，从 DevEco Studio 6.0.0 Beta5 版本开始，新增了更高效的自动签名以及开通 Push Kit 开放能力方案，请参考 HarmonyOS 官方文档：[开通推送服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-config-setting)。
 
 ### 步骤3：创建 IM 控制台证书凭证
 1. 登录 [API Console](https://developer.huawei.com/consumer/cn/console/overview)，在页面左侧的导航栏中，单击**我的 API**，确保所选项目已开通推送服务（Push Kit），若未开通，请单击右侧 申请新 HMS API 服务 进行**申请新 HMS API 服务。**
 
 2. 单击左侧导航栏中 **API 服务** > **凭证**，在项目下单击**服务账号密钥**下的**创建凭证。**
 
-3. 填写必填项，并单击**创建公私钥**。创建并下载 JSON，下载后的文件就是您的 Service Account 凭据文件。
+3. 填写必填项，并单击**生成公私钥**。创建并下载 JSON，下载后的文件就是您的 Service Account 凭据文件。
 
 4.  将下载好的文件保存，待下一步 IM 控制台配置使用。
 
+   > **说明：**
+   >
+   > 详情请参考 HarmonyOS 官方文档：[API 服务操作指南](https://developer.huawei.com/consumer/cn/doc/start/api-0000001062522591)。
+   >
+
 ### 步骤4：申请场景化权益
 
 Push Kit 支持多种场景化消息类型，其中部分场景化消息类型需要您申请特殊权益才能正常发送，像 IM 消息类型场景。
 
-登录 [AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)，选择**开发与服务**，单击**推送服务**，在**配置**页，单击申请自分类权益。按照提示申请并激活。详情介绍请参考 [推送场景化消息权益](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-apply-right)。
+登录 [AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)，选择**开发与服务**，单击**推送服务**，在**配置**页，单击申请自分类权益。按照提示申请并激活。
+
+> **说明：**
+> 详情请参考 HarmonyOS 官方文档：[申请推送场景化消息权益](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-apply-right)。
+>
 
 ## 腾讯云 IM 控制台配置
 1. 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置** 中添加 HarmonyOS 证书。

package/resource/knowledge/push/integration/flutter.md

@@ -37,7 +37,7 @@ flutter pub add tencent_cloud_chat_push
 
 【Android】
 
-请先按 Android TIMPush 公共集成 和 Android 厂商通道集成 完成原生工程配置。
+请先按 Android 集成 TIMPush 和 Android 厂商通道集成 完成原生工程配置。
 
 与原生 Android 的差异如下，请按下方完成：
 1. **厂商通道包**：Flutter 插件已处理 TIMPush 基础依赖，**不要**再添加 `com.tencent.timpush:timpush` / `tuicore`。只需按需引入目标厂商通道包。

package/resource/knowledge/roomkit/preset/uniapp-app/integration.md

@@ -1,24 +1,28 @@
 本文档介绍如何在 uniapp 业务项目中集成 TUIRoomKit，快速获得开箱即用的多人音视频会议能力。
 
 ## 前提条件
+- **IDE**： HBuilderX 版本 ≥ 4.66。
 
-### 开通服务
+- **Vue 版本**： Vue3。
 
-请参考 开通服务 领取 TUIRoomKit 体验版，并在 [应用管理](https://console.cloud.tencent.com/trtc) 页面获取以下信息：
-- **SDKAppID**：应用标识（必填），腾讯云基于 SDKAppID 完成计费统计。
+- **Node 版本**：Node.js  ≥ 18.0.0。
 
-- **SDKSecretKey**：应用密钥，用于初始化配置文件的密钥信息。
+- **支持平台**： 仅支持打包为 Android / iOS App，不支持 H5 和小程序。
 
-### 环境准备
-- **IDE**： HBuilderX 升级到新版本。
+- **支持项目**： uni-app 项目。
 
-- **语言**： nvue。
-
-- **运行环境**： Node.js v12 版本及以上。
-
-- **包管理**： npm (版本需与 Node 版本匹配)。
-
-- **支持平台**： uni-app 打包 App。
+   > **说明：**
+   >
+   > Vue2 暂不支持，可通过 [视频会议 SDK 接入反馈问卷](https://wj.qq.com/s2/27395009/ac34/) 进行反馈。
+   >
+   > uniappx 暂不支持，可通过 [视频会议 SDK 接入反馈问卷](https://wj.qq.com/s2/27395009/ac34/) 进行反馈。
+   >
+   > H5 和小程序项目，如有需要请参考以下替代方案：
+   >
+   > - 打包 Web H5，可参考：Web&H5（Vue3）。
+   > - 打包小程序，可参考：uni-app（小程序）。
+   > 接入过程中遇到任何卡点或有改进建议，欢迎通过 [视频会议 SDK 接入反馈问卷](https://wj.qq.com/s2/27395009/ac34/)  反馈，官方会及时跟进处理。
+   >
 
 ## 集成步骤
 
@@ -176,7 +180,7 @@ cp -r uni_modules/tuikit-atomic-x/quickstart_room/static/* static/ && cp -r uni_
 在 `pages/login/login.vue` 中，填入 `SDKAppID`、 `userID`、`SecretKey`，点击**登录**。
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| SDKAppID | Number | SDKAppID 是 RoomKit 客户应用的唯一标识。您可以在 <a href="https://console.cloud.tencent.com/trtc">TRTC 控制台 > 应用管理</a> 创建新应用获取 。<br><strong>说明：</strong><br>SDKAppID 是 RoomKit 客户应用的唯一标识。我们建议每一个独立的 App 都申请一个新的 SDKAppID。不同 SDKAppID 之间是天然隔离的，不能互通。 |
+| SDKAppID | Number | SDKAppID 是 RoomKit 客户应用的唯一标识。您可以在 <a href="https://console.cloud.tencent.com/trtc">TRTC 控制台 > 应用管理</a> 创建新应用获取 。<br><strong>说明：</strong><br>- SDKAppID 是 RoomKit 客户应用的唯一标识。每个独立的 App 都应单独申请一个 SDKAppID。不同 SDKAppID 之间天然隔离、互不相通，请勿混用。<br>- 开始使用前，<strong>请先领取 TUIRoomKit 体验版</strong>，领取方式见「开通服务 」。 |
 | SecretKey | String | SecretKey 是 RoomKit 客户应用的密钥。您可以在 <a href="https://console.cloud.tencent.com/trtc">TRTC 控制台 > 应用管理</a> 对应应用获取。<br><strong>安全提示：</strong><br>- 项目示例支持通过 <code>genTestUserSig</code> 函数生成 <code>userSig</code>。该方法中 <code>SecretKey</code> 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。<strong>该方法仅适合本地跑通功能调试</strong>。 正确的 UserSig 签发方式请参见 <a href="https://cloud.tencent.com/document/product/647/17275#formal">服务端生成 UserSig</a>。<br>- 敏感信息（SecretKey）仅用于 Demo 测试，不可提交到代码仓库或用于生产环境。 |
 | userID | String | 用户的唯一标识符，由您定义，只能包含大小写字母（a-z，A-Z）、数字（0-9）、下划线和连字符。 |
 

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/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 |  |  |  |  |
 
 ## 实现流程