@tencentcloud/sdk-mcp 1.6.8 → 1.7.1

package/resource/integration/callkit/preset/flutter/integration.md

@@ -1,5 +1,9 @@
 本文将介绍如何快速接入 TUICallKit 组件。您可以在 10 分钟内完成以下关键步骤，最终获得一个功能完备的音视频通话界面。
 
+> **说明：**
+> 您也可以使用 TRTC Agent Skill 辅助将 TUICallKit 接入现有 Flutter 项目。安装后，在项目目录中告诉 AI “帮我在当前 Flutter 项目中接入音视频通话”，AI 将分析项目结构，并协助完成依赖、工程配置、登录、通话入口接入及验证。
+>
+
 ## 准备工作
 
 ### 环境要求
@@ -8,7 +12,7 @@ Flutter 3.24.0、Dart 3.5.0 及以上版本。
 
 ### 开通服务
 
-在使用腾讯云提供的音视频服务前，您需要前往控制台，为应用开通音视频服务。具体步骤详细参见 开通服务。开通服务后，请记录`SDKAppID` 和`SDKSecretKey`，在后续的步骤（登录）中会用到。
+在使用腾讯云提供的音视频服务前，您需要前往控制台，为应用开通音视频服务。具体步骤详情参见 开通服务。开通服务后，请记录 `SDKAppID` 和 `SDKSecretKey`，在后续的步骤（登录）中会用到。
 
 ## 快速接入
 
@@ -25,7 +29,7 @@ flutter pub add tencent_calls_uikit
 【Android】
 1. 由于 SDK 内部使用了 Java 反射机制（或特性），需要将部分 SDK 类加入不进行混淆处理的名单。
 
-  - 请在工程的`android/app/`目录下找到`build.gradle.kts`（或`build.gradle` ）文件中配置并开启混淆规则：
+  - 请在工程的 `android/app/` 目录下找到 `build.gradle.kts`（或 `build.gradle` ）文件中配置并开启混淆规则：
 
 【build.gradle.kts】
 ``` java
@@ -152,7 +156,7 @@ void login() async {
 |userSig|String|一种安全保护签名，用于对用户进行登录鉴权认证，确认用户是否真实，阻止恶意攻击者盗用您的云服务使用权。|
 
 > **说明：**
-> - **开发环境**：如果您在本地开发调试阶段，可以采用本地 `GenerateTestUserSig.genTestSig`函数生成 userSig。该方法中 secretKey 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。
+> - **开发环境**：如果您在本地开发调试阶段，可以采用本地 `GenerateTestUserSig.genTestSig` 函数生成 userSig。该方法中 secretKey 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。
 > - **生产环境**：如果您的项目要发布上线，请采用 服务端生成 UserSig 的方式。
 
 ### 步骤4：设置昵称和头像 [可选]

package/resource/integration/callkit/preset/ios/integration.md

@@ -393,3 +393,4 @@ TUICallKit.createInstance().enableMuteMode(enable: true)
 ### Xcode 出现 **Sandbox: rsync** 编译报错？
 
 可以在 **Build Settings** 中把 **User Script Sandboxing** 设置为 **NO：**
+

package/resource/integration/chat/preset/android/integration.md

@@ -519,3 +519,4 @@ TencentAiDeskCustomer.getInstance().initWithProfile(context, SDKAppID, userID, u
 #### **登录失败，提示签名错误？**
 
 请检查 SDKAppID 和 UserSig 是否正确，UserSig 是否已过期。可以参考上文 配置用户鉴权 重新生成 UserSig。
+

package/resource/integration/chat/preset/flutter/integration.md

@@ -2,11 +2,12 @@ TUIKit Flutter 是基于腾讯云 IM SDK 的一套 Flutter UI 组件库，提供
 
 ## 问卷反馈
 
+> **说明：**
 > **花 30 秒，帮 Flutter TUIKit 变得更好用！**
 >
-> 正在接入、已经跑通、还是卡住了？都欢迎你填写 [Flutter TUIKit 接入体验问卷](https://wj.qq.com/s2/27299252/ff84/)**。**
+> 正在接入、已经跑通、还是卡住了？都欢迎您填写 [Flutter TUIKit 接入体验问卷](https://wj.qq.com/s2/27299252/ff84/)**。**
 >
-> **你的每一条卡点反馈和改进建议，官方都会及时跟进处理**。
+> **您的每一条卡点反馈和改进建议，官方都会及时跟进处理**。
 >
 
 ## 关键概念
@@ -19,12 +20,16 @@ TUIKit 提供了一套完整的即时通信 UI 组件，向下依赖 AtomicXCore
 - AtomicXCore（数据层）：提供数据管理和业务逻辑，包含各种 Store 和 Manager。
 
 ## 前提条件
+- **支持平台：**Android、iOS、HarmonyOS。
+
 - Flutter >= 3.29.0 版本，Dart >= 3.7.0 版本，Kotlin >= 1.9版本。
 
 - Android Studio Ladybug 2024.2.1 及以上版本，Android Gradle Plugin 7.3.1 以上版本，JDK 17 版本。
 
 - Xcode 12.0 及以上版本。
 
+- HarmonyOS：[Flutter-OH 3.35.7-ohos-release](https://gitcode.com/CPF-Flutter/flutter_flutter/tree/oh-3.35.7-release)、DevEco Studio 5.0+(可选)、HarmonyOS NEXT 真机 / 模拟器、hdc 命令行、ohpm。注意：标准 Flutter 不能构建鸿蒙 hap，必须使用 Flutter-OH 分支。
+
 - 一个有效的腾讯云账号及 Chat 应用。可参考 开通服务 从控制台获取以下信息：
 
   - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
@@ -102,6 +107,8 @@ call/
 
 ### 配置项目
 
+#### iOS
+
 在 iOS 端添加必要的权限配置。请打开 ios/Podfile ，在文件末尾新增如下权限代码：
 ``` objectivec
 post_install do |installer|
@@ -124,7 +131,9 @@ post_install do |installer|
 end
 
 ```
-- **清理 Gradle 全局配置（仅 Android 需要）：**如果您本地存在 `~/.gradle/init.gradle`，运行如下命令：
+
+#### Android
+- **清理 Gradle 全局配置：**如果您本地存在 `~/.gradle/init.gradle`，运行如下命令：
 
    ``` bash
    # 或者直接删除：rm -f ~/.gradle/init.gradle
@@ -136,13 +145,104 @@ end
    > 如果您本地不存在 Gradle 全局配置文件 `~/.gradle/init.gradle`，请忽略。如果存在，并且该文件里配置有 `allprojects.repositories`，可以删除 `allprojects.repositories` 相关内容，或者删除 `~/.gradle/init.gradle`（建议备份文件），以免引起运行报错。
    >
 
-- **配置 JDK 17（仅 Android 需要）：**在项目例如 `chat/demo` 目录下的 `gradle.properties` 里增加一条 `org.gradle.java.home`，用来配置 JDK 17 路径，请替换成您实际的 JDK 17 的完整路径。参考如下：
+- **配置 JDK 17：**在项目例如 `chat/demo` 目录下的 `gradle.properties` 里增加一条 `org.gradle.java.home`，用来配置 JDK 17 路径，请替换成您实际的 JDK 17 的完整路径。参考如下：
 
    ``` bash
    # 请替换为您本地 JDK 17 的真实完整路径
    org.gradle.java.home=xx/Java/JavaVirtualMachines/jdk-17.0.6.jdk/Contents/Home
    ```
 
+#### HarmonyOS
+- 参考 [鸿蒙 Flutter 仓库文档](https://gitcode.com/CPF-Flutter/flutter_flutter/tree/oh-3.35.7-release) 的开发指南搭建环境。
+
+- 在您项目的 `pubspec.yaml` 文件中依赖重写（dependency_overrides）鸿蒙适配的第三方库，参考 `chat/demo/pubspec.yaml` 文件：
+
+   ``` javascript
+   dependency_overrides:
+     # ... 已有的 override 保持不变 ...
+     # HarmonyOS 专用(仅在使用 Flutter-OH 构建时启用,构建 Android/iOS 时请注释掉)
+
+     path_provider:
+       git:
+         url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+         path: "packages/path_provider/path_provider"
+         ref: "provider-v2.1.5-ohos-1.0.0"
+     shared_preferences:
+       git:
+         url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+         path: "packages/shared_preferences/shared_preferences"
+         ref: "shared_preferences-v2.5.4-ohos-1.0.0"
+     url_launcher:
+       git:
+         url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+         path: "packages/url_launcher/url_launcher"
+         ref: "url_launcher_v6.3.2-ohos-1.0.0"
+
+   ```
+- 声明 HarmonyOS 权限，参考 `chat/demo/ohos/entry/src/main/module.json5` 在 `requestPermissions` 数组中加入所需权限。
+
+   ``` java
+   {
+     "module": {
+       "requestPermissions": [
+         // ===== system_grant(声明即得) =====
+         { "name": "ohos.permission.INTERNET" },
+         { "name": "ohos.permission.GET_NETWORK_INFO" },
+         { "name": "ohos.permission.VIBRATE" },
+         // ===== user_grant(需运行时申请,必须提供 reason 和 usedScene) =====
+         {
+           "name": "ohos.permission.CAMERA",
+           "reason": "$string:permission_reason_camera",
+           "usedScene": {
+             "abilities": [ "EntryAbility" ],
+             "when": "inuse"
+           }
+         },
+         {
+           "name": "ohos.permission.MICROPHONE",
+           "reason": "$string:permission_reason_microphone",
+           "usedScene": {
+             "abilities": [ "EntryAbility" ],
+             "when": "inuse"
+           }
+         },
+         {
+           "name": "ohos.permission.WRITE_IMAGEVIDEO",
+           "reason": "$string:permission_reason_write_media",
+           "usedScene": {
+             "abilities": [ "EntryAbility" ],
+             "when": "inuse"
+           }
+         },
+         {
+           "name": "ohos.permission.READ_PASTEBOARD",
+           "reason": "$string:permission_reason_read_pasteboard",
+           "usedScene": {
+             "abilities": [ "EntryAbility" ],
+             "when": "inuse"
+           }
+         }
+       ]
+     }
+   }
+
+   ```
+- 在项目根目录 `ohos/build-profile.json5` 里启用 `useNormalizedOHMUrl`，否则会报“Bytecode HARs not supported when useNormalizedOHMUrl is not true”的错误。
+
+   ``` java
+   {
+     "app": {
+       "products": [{
+         "name": "default",
+         "buildOption": {
+           "arkOptions": { "useNormalizedOHMUrl": true }
+         }
+       }]
+     }
+   }
+
+   ```
+
 ## 接入步骤
 
 ### 步骤1：配置用户鉴权
@@ -385,16 +485,16 @@ import 'package:tencentcloud_ai_desk_customer/tencentcloud_ai_desk_customer.dart
 // 上述sdkAppID、userID和userSig三个参数, 可以同您登录腾讯云 IM 的保持一致, 也可以使用不同的应用和用户
 
 TencentCloudAIDeskCustomer.init(
-  sdkAppID: SDKAppID， // 开通了智能客服 Desk 的应用 ID
-  userID: userID， // 详情可参见腾讯云 IM 登录鉴权
-  userSig: userSig， // 详情可参见腾讯云 IM 登录鉴权
+  sdkAppID: SDKAppID, // 开通了智能客服 Desk 的应用 ID
+  userID: userID, // 详情可参见腾讯云 IM 登录鉴权
+  userSig: userSig, // 详情可参见腾讯云 IM 登录鉴权
 );
 
 // 打开智能客服会话页面
 TencentCloudAIDeskCustomer.navigate(
-  context: context， // BuildContext
-  customerServiceID: "@customer_service_account"， // 可选, 如不配置多客服号或修改默认的客服号 UserID, 可无需传入. 客服号 UserID 可从智能客服管理端查看: https://desk.qcloud.com/
-  config: TencentCloudCustomerConfig()， // 可选针对该客服会话的特殊配置，具体参数及使用方式可查看该类注释. 此处仅需手动指定相比全局配置的增项和修改项即可，其余配置来自全局默认配置.
+  context: context, // BuildContext
+  customerServiceID: "@customer_service_account", // 可选, 如不配置多客服号或修改默认的客服号 UserID, 可无需传入. 客服号 UserID 可从智能客服管理端查看: https://desk.qcloud.com/
+  config: TencentCloudCustomerConfig(), // 可选针对该客服会话的特殊配置，具体参数及使用方式可查看该类注释. 此处仅需手动指定相比全局配置的增项和修改项即可，其余配置来自全局默认配置.
 );
 ```
 
@@ -407,3 +507,4 @@ TencentCloudAIDeskCustomer.navigate(
 ### **登录失败，提示签名错误怎么办？**
 
 请检查 SDKAppID 和 UserSig 是否正确，UserSig 是否已过期。可以参考上文 配置用户鉴权 重新生成 UserSig。
+

package/resource/integration/chat/preset/ios/integration.md

@@ -595,3 +595,4 @@ NSString *avatar = @"";
 #### **登录失败，提示签名错误怎么办？**
 
 请检查 SDKAppID 和 UserSig 是否正确，UserSig 是否已过期。可以参考上文“配置用户鉴权”重新生成 UserSig。
+

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

@@ -510,3 +510,4 @@ function onChatSettingClose() {
 - [chat-uikit-react npm](https://www.npmjs.com/package/@tencentcloud/chat-uikit-react)
 
 - [GitHub Demo](https://github.com/TencentCloud/chat-uikit-react)
+

package/resource/integration/chat/preset/uni-app/integration.md

@@ -544,3 +544,4 @@ import MessageInput, { DEFAULT_TOOLS } from '@/uni_modules/tuikit-atomic-x/compo
 const customToolList = computed(() => DEFAULT_TOOLS.filter(tool => tool.id !== 'videoCall' && tool.id !== 'voiceCall'));
 </script>
 ```
+

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

@@ -549,3 +549,4 @@ const isChatSettingShow = ref(false);
 ### GitHub
 
 [GitHub Demo](https://github.com/Tencent-RTC/TUIKit_Vue3/tree/main/demos/rtcube-vite-vue3)
+

package/resource/integration/livekit/preset/live/android/prepare-integration.md

@@ -256,3 +256,4 @@ class YourLoginService {
 ### 集成代码后还需要添加摄像头麦克风等权限的声明吗？
 
 不需要，TUILiveKit 中已经内置了摄像头麦克风等权限的声明，在接入过程中您无需再关心这些权限的声明。
+

package/resource/integration/livekit/preset/live/vue/live-player-desk-integration.md

@@ -12,11 +12,11 @@
 
 ### 前提条件
 
-请您先阅读准备工作，请确保集成对应组件并实现登录。
+请您先阅读 准备工作，请确保集成对应组件并实现登录。
 
 ### 集成观众观看页面
 
-新建`live-player.vue`，作为观看页面的入口，负责播放直播画面、切换分辨率、画中画等，您根据指引按需引入观看端的各功能模块。将以下代码复制到该文件即可：
+新建 `live-player.vue`，作为观看页面的入口，负责播放直播画面、切换分辨率、画中画等，您根据指引按需引入观看端的各功能模块。将以下代码复制到该文件即可：
 ``` typescript
 <template>
   <UIKitProvider language="zh-CN" theme="dark">
@@ -92,18 +92,20 @@ onMounted(async () => {
 
 ### 启动并运行示例
 
-执行 `npm run dev` 成功后，在浏览器地址栏输入本地访问地址（例如`https://localhost:5173/live-player`，具体端口号可能因项目配置不同而有所差异），即可看到观看页面，输入对应的房间号（**liveId**），即可观看对应的直播间画面。
+执行 `npm run dev` 成功后，在浏览器地址栏输入本地访问地址（例如 `https://localhost:5173/live-player`，具体端口号可能因项目配置不同而有所差异），即可看到观看页面，输入对应的房间号（**liveId**），即可观看对应的直播间画面。
 ``` bash
 npm run dev
 ```
 
-> **开启直播的两种方式**
+> **开启直播的两种方式：**
 >
-> 集成观看页面成功后，可通过以下任一方式开播效果：
+> 集成观看页面成功后，可通过以下任一方式体验开播效果：
 >
 > - 在线开播网站：打开[在线开播网站](https://web.sdk.qcloud.com/trtc/livekit/pusher/index.html#/)，输入对应 **sdkAppId** 等信息，点击直播列表右上角的**开始直播**按钮进入开播页面，开始一场直播。
 > - 集成开播页面：在您的项目中接入 主播开播（Web 桌面浏览器）组件进行开播。
-> ⚠️ 观看请使用与开播端不同的用户 ID，否则先登录的设备会被强制下线。
+
+> **注意：**
+> 观看请使用与开播端不同的用户 ID，否则先登录的设备会被强制下线。
 >
 
 ## UI 自由定制
@@ -129,9 +131,9 @@ import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3';
 我们支持您根据项目需求对观众观看页面进行 UI 定制——除页面布局调整外，还可对**颜色主题、字体、圆角、输入框、弹框**等内容进行增删改；若需新增或替换按钮（Button）、图标（Icon）等控件，也可找到对应控件的指定位置源码，直接进行增加、删除、替换等操作，满足您的 UI 定制需要。
 | <strong>类别</strong> | <strong>功能</strong> | <strong>描述</strong> | <strong>组件详细定制指引</strong> |
 | --- | --- | --- | --- |
-| <strong>素材管理</strong> | 自定义素材管理区域展示 | <strong>支持：</strong><br>- <strong>调整展示 Icon 的大小、颜色或对 Icon 进行替换。</strong> | <a href="https://cloud.tencent.com/document/product/647/123838">媒体源配置面板</a> |
-| <strong>在线观众</strong> | 自定义观众信息展示 | <strong>支持：</strong><br>- <strong>展示/隐藏观众等级。</strong><br>- <strong>观众信息字体、颜色 UI 自定义设置。</strong><br>- <strong>替换为您需要的 Icon 风格。</strong> | <a href="https://cloud.tencent.com/document/product/647/123834">视频源编辑画板</a> |
-| <strong>消息列表</strong> | 自定义消息弹幕区域展示 | <strong>支持：</strong><br>- <strong>展示/隐藏聊天输入区域。</strong><br>- <strong>支持 UI 定制聊天气泡风格、定制观众等级等内容。</strong> | <a href="https://cloud.tencent.com/document/product/647/123836">聊天弹幕组件</a> |
+| <strong>直播视频</strong> | 自定义直播视频区域展示 | <strong>支持：</strong><br>- <strong>调整展示 Icon 的大小、颜色或对 Icon 进行替换。</strong><br>- <strong>自定义视频挂件。</strong> | 直播视频组件 |
+| <strong>在线观众</strong> | 自定义观众信息展示 | <strong>支持：</strong><br>- <strong>展示或隐藏观众等级。</strong><br>- <strong>观众信息字体、颜色 UI 自定义设置。</strong><br>- <strong>替换为您需要的 Icon 风格。</strong> | 观众列表 |
+| <strong>消息列表</strong> | 自定义消息弹幕区域展示 | <strong>支持：</strong><br>- <strong>展示或隐藏聊天输入区域。</strong><br>- <strong>支持 UI 定制聊天气泡风格、定制观众等级等内容。</strong> | <a href="https://cloud.tencent.com/document/product/647/123836">聊天弹幕组件</a> |
 
 ## 常见问题
 
@@ -141,7 +143,7 @@ import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3';
 
 #### 自动播放失败表现
 
-当用户对该站点的媒体互动指数 (MEI, Media Engagement Index) 未达到阈值时，企图自动播放有声视频会失败。在 SDK 默认情况下，当检测到自动播放失败时，会弹窗引导用户与页面产生交互（如点击**确认**按钮）。产生交互后，浏览器策略即被满足，有声视频即可正常播放。
+当用户对该站点的媒体互动指数 (MEI, Media Engagement Index) 未达到阈值时，企图自动播放有声视频会失败。在 SDK 默认情况下，当检测到自动播放失败时，会弹窗引导用户与页面产生交互（例如点击**确认**按钮）。产生交互后，浏览器策略即被满足，有声视频即可正常播放。
 
 #### 解决方案：自定义处理自动播放失败
 

package/resource/integration/livekit/preset/live/vue/live-pusher-integration.md

@@ -12,11 +12,11 @@
 
 ### 前提条件
 
-请您先阅读准备工作，请确保集成对应组件并实现登录。
+请您先阅读 准备工作，请确保集成对应组件并实现登录。
 
 ### 集成主播开播页面
 
-新建`live-pusher.vue`，作为开播页面的入口，负责**整体布局**、**开播 / 停播**、**登录初始化**，并按需引入底部控制栏的各功能模块。将以下代码复制到该文件即可：
+新建 `live-pusher.vue`，作为开播页面的入口，负责**整体布局**、**开播 / 停播**、**登录初始化**，并按需引入底部控制栏的各功能模块。将以下代码复制到该文件即可：
 ``` typescript
 <template>
   <UIKitProvider language="zh-CN" theme="dark">
@@ -44,10 +44,10 @@
           </div>
           <div class="live-controls">
             <div class="bottom-panel">
-              <!-- <MediaDeviceSetting />// 媒体设置能力请参考本文高级功能集成部分
-              <CoGuestButton />          // 连麦观众能力请参考本文高级功能集成部分
-              <OrientationSwitch />      // 布局设置请参考本文高级功能集成部分
-              <LayoutSwitch />           // 横竖屏推流能力请参考本文高级功能集成部分 -->
+              <!-- <MediaDeviceSetting />// 媒体设置能力请参考本文功能模块集成部分
+              <CoGuestButton />          // 连麦观众能力请参考本文功能模块集成部分
+              <OrientationSwitch />      // 布局设置请参考本文功能模块集成部分
+              <LayoutSwitch />           // 横竖屏推流能力请参考本文功能模块集成部分 -->
             </div>
             <TUIButton type="primary" v-if="!currentLive?.liveId" @click="handleStartLive">开始直播</TUIButton>
             <TUIButton color="red" v-else @click="handleStopLive">停止直播</TUIButton>
@@ -128,7 +128,7 @@ onMounted(async () => {
 
 ### 启动并运行示例
 
-执行 `npm run dev` 成功后，在浏览器地址栏输入本地访问地址（例如`https://localhost:5173/live-pusher`，具体端口号可能因项目配置不同而有所差异），即可看到开播页面，添加媒体源素材点击开始直播即可开启您的直播。
+执行 `npm run dev` 成功后，在浏览器地址栏输入本地访问地址（例如 `https://localhost:5173/live-pusher`，具体端口号可能因项目配置不同而有所差异），即可看到开播页面，添加媒体源素材点击开始直播即可开启您的直播。
 ``` bash
 npm run dev
 ```
@@ -139,12 +139,14 @@ npm run dev
 >
 > - 在线观看网站：打开[在线观看网站](https://web.sdk.qcloud.com/trtc/livekit/player/index.html#/)，输入对应 **sdkAppId** 等信息，在直播列表中找到并进入你的直播间。
 > - 集成观看页面：在您的项目中接入 观众观看（Web 桌面浏览器）或者 观众观看（H5 移动端浏览器）组件观看。
-> ⚠️ 观看请使用与开播端不同的用户 ID，否则先登录的设备会被强制下线。
+
+> **注意：**
+> 观看请使用与开播端不同的用户 ID，否则先登录的设备会被强制下线。
 >
 
 ## 功能模块
 
-以下模块均为可独立复制的组件，需要先通过集成主播开播页面，然后根据您的业务需求将下列各个模块的代码直接粘贴进对应的注释部分去即可。
+以下模块均为可独立复制的组件，需要先通过 集成主播开播页面，然后根据您的业务需求将下列各个模块的代码直接粘贴进对应的注释部分去即可。
 
 ### 支持媒体设置能力
 
@@ -658,9 +660,9 @@ import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3';
 我们支持您根据项目需求对观众观看页面进行 UI 定制——除页面布局调整外，还可对**颜色主题、字体、圆角、输入框、弹框**等内容进行增删改；若需新增或替换按钮（Button）、图标（Icon）等控件，也可找到对应控件的指定位置源码，直接进行增加、删除、替换等操作，满足您的 UI 定制需要。
 | <strong>类别</strong> | <strong>功能</strong> | <strong>描述</strong> | <strong>组件详细定制指引</strong> |
 | --- | --- | --- | --- |
-| <strong>素材管理</strong> | 自定义素材管理区域展示 | <strong>支持：</strong><br>- <strong>调整展示 Icon 的大小、颜色或对 Icon 进行替换。</strong> | <a href="https://cloud.tencent.com/document/product/647/123838">媒体源配置面板</a> |
-| <strong>在线观众</strong> | 自定义观众信息展示 | <strong>支持：</strong><br>- <strong>展示/隐藏观众等级。</strong><br>- <strong>观众信息字体、颜色 UI 自定义设置。</strong><br>- <strong>替换为您需要的 Icon 风格。</strong> | <a href="https://cloud.tencent.com/document/product/647/123834">视频源编辑画板</a> |
-| <strong>消息列表</strong> | 自定义消息弹幕区域展示 | <strong>支持：</strong><br>- <strong>展示/隐藏聊天输入区域。</strong><br>- <strong>支持 UI 定制聊天气泡风格、定制观众等级等内容。</strong> | <a href="https://cloud.tencent.com/document/product/647/123836">聊天弹幕组件</a> |
+| <strong>直播视频</strong> | 自定义直播视频区域展示 | <strong>支持：</strong><br>- <strong>调整展示 Icon 的大小、颜色或对 Icon 进行替换。</strong><br>- <strong>自定义视频挂件。</strong> | 直播视频组件 |
+| <strong>在线观众</strong> | 自定义观众信息展示 | <strong>支持：</strong><br>- <strong>展示或隐藏观众等级。</strong><br>- <strong>观众信息字体、颜色 UI 自定义设置。</strong><br>- <strong>替换为您需要的 Icon 风格。</strong> | 观众列表 |
+| <strong>消息列表</strong> | 自定义消息弹幕区域展示 | <strong>支持：</strong><br>- <strong>展示或隐藏聊天输入区域。</strong><br>- <strong>支持 UI 定制聊天气泡风格、定制观众等级等内容。</strong> | <a href="https://cloud.tencent.com/document/product/647/123836">聊天弹幕组件</a> |
 
 ## 下一步
 
@@ -669,5 +671,3 @@ import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3';
 | --- | --- | --- |
 | <strong>观众观看</strong> | 实现观众进入主播的直播间后观看直播，实现观众连麦 、直播间信息、在线观众、弹幕显示等功能。 | 观众观看 |
 | <strong>直播列表</strong> | 展示直播列表界面和功能，包含直播列表，房间信息展示功能。 | 直播列表 |
-
-###

package/resource/integration/roomkit/preset/vue/integration.md

@@ -849,3 +849,4 @@ TUIRoomKit 已提供丰富的 UI 自定义能力，包括 主题及语言、界
 // 请替换为 TUIRoomKit 源码真实路径
 src/components/RoomKit
 ```
+

package/resource/knowledge/callkit/best-practice/callkit-miniprogram/uniapp-shrink.md

@@ -0,0 +1,64 @@
+---
+title: uniapp 打包微信小程序 TUICallKit 体积裁剪方案
+product: call
+frameworks: [miniprogram]
+scope: platform_specific
+tags: [TUICallKit, uniapp, 小程序, 体积裁剪, 插件裁剪, 瘦身, 移除插件, GroupCallView]
+version_range: ">=4.0.0"
+---
+
+# uniapp 打包微信小程序 TUICallKit 体积裁剪方案
+
+## 1. 核心结论
+
+- TUICallKit 默认包含完整插件，核心通话引擎（375 KB）和 1v1 通话（111 KB）为必选模块，不可裁剪。
+- 铃声插件（23 KB）和多人通话插件（27 KB）可按需移除，移除后不影响单人通话功能。
+- 通过删除插件注册代码和对应 pages 配置实现裁剪。
+
+## 2. 字段语义对照
+
+| 模块 | 大小 | 是否必选 | 移除方式 |
+|---|---|---|---|
+| 核心通话引擎 | 375 KB | 必选 | — |
+| 1v1 单人通话 | 111 KB | 必选 | — |
+| 铃声插件 | 23 KB | 可裁剪 | 删除 `this.registerPlugin(useRingPlugin())` |
+| 多人通话插件 | 27 KB | 可裁剪 | 删除 `this.registerPlugin(useGroupCallPlugin())` + pages.json 中 `GroupCallView` 页面 |
+
+## 3. 机制/时序
+
+TUICallKit 初始化时通过 `registerPlugin` 注册各功能插件 -> 插件被注册后打包进小程序代码 -> 删除对应注册代码后，该插件不会打包 -> 小程序包体积相应减小。
+
+## 4. 标准用法
+
+1. 在 TUICallKit 初始化代码中找到插件注册部分。
+2. 删除 `this.registerPlugin(useRingPlugin())` 移除铃声插件。
+3. 删除 `this.registerPlugin(useGroupCallPlugin())` 移除多人通话插件，同步删除 `pages.json` 中的 `GroupCallView` 页面配置。
+
+## 5. 结果判定
+
+- 铃声插件移除后，通话中不再播放铃声提示，但通话功能不受影响。
+- 多人通话插件移除后，无法发起和参与多人通话，单人通话正常。
+- 小程序打包后体积减少约 50 KB。
+- 功能正常：单人通话（发起、接听、挂断）完整可用。
+
+## 6. 常见误区
+
+- 误区 1：试图移除核心通话引擎或 1v1 模块（必选，移除后无法通话）。
+- 误区 2：只删除插件注册代码，忘记同步删除 `pages.json` 中的 `GroupCallView` 页面配置，导致编译报错。
+- 误区 3：认为裁剪后还能使用多人通话功能（移除多人通话插件后只能使用单人通话）。
+
+## 7. 问题定义（检索辅助，极简）
+
+uniapp 打包微信小程序时，TUICallKit 默认插件过多导致包体积大，希望按需移除不必要的功能模块。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- TUICallKit 小程序怎么瘦身？
+- uniapp TUICallKit 如何移除铃声插件？
+- TUICallKit 多人通话怎么裁剪？
+- 微信小程序 TUICallKit 包太大怎么优化？
+- 删除 `GroupCallView` 后多人通话还能用吗？
+
+## 9. 参考来源（可选）
+
+- 微信小程序 TUICallKit（uniapp）文档：`https://cloud.tencent.com/document/product/647/78912#802b0c00-0ea7-4ca3-8892-62f47f06c92d`

package/resource/knowledge/callkit/best-practice/common/call-autoplay-blocked.md

@@ -0,0 +1,81 @@
+---
+title: Web TUICallKit 弹出"恢复播放"弹窗的原因与处理
+product: call
+frameworks: [react, vue, web]
+scope: platform_common
+tags: [TUICallKit, 恢复播放, 自动播放, webview, autoplay, enableAutoPlayDialog, callExperimentalAPI, 无声, vue2.6, vue2.7, vue3]
+version_range: ">=4.0.0"
+---
+
+# Web TUICallKit 弹出"恢复播放"弹窗的原因与处理
+
+## 1. 核心结论
+
+- 浏览器限制自动播放：在用户与网页产生交互前禁止播放带声音的媒体，Web TUICallKit 检测到播放失败后弹出"恢复播放"弹窗，需用户点击"恢复"。
+- 此问题多出现在 webview 中（如 App 内嵌 H5）。
+- 不推荐关闭该弹窗，关闭后可能出现无声问题。如需关闭可通过 `callExperimentalAPI` 设置 `enableAutoPlayDialog: 0`。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `enableAutoPlayDialog` | 自动播放弹窗开关 | `1` 开启（默认），`0` 关闭 |
+| `callExperimentalAPI` | 调用实验性 API | 通过 TRTC 实例调用，用于设置 `enableAutoPlayDialog` |
+| `getTUICallEngineInstance()` | 获取 TUICallEngine 实例 | 从 `TUICallKitAPI` 获取底层引擎 |
+| `getTRTCCloudInstance()` | 获取 TRTC 实例 | 从 TUICallEngine 获取 TRTC 云实例 |
+
+## 3. 机制/时序
+
+用户进入通话页面 -> TUICallKit 尝试自动播放音频 -> 浏览器拦截自动播放 -> 播放失败 -> TUICallKit 弹出"恢复播放"弹窗 -> 用户点击"恢复" -> 音频正常播放。
+
+webview 场景下，因宿主 App 对自动播放的限制更严格，此问题更容易出现。
+
+## 4. 标准用法
+
+不推荐关闭该弹窗。如业务场景确定需要关闭：
+
+1. 从 `TUICallKitAPI` 获取 TUICallEngine 实例。
+2. 从 TUICallEngine 获取 TRTC 云实例。
+3. 通过 TRTC 实例的 `callExperimentalAPI` 设置 `enableAutoPlayDialog: 0`。
+
+```javascript
+// React: @trtc/calls-uikit-react
+// Vue 3: @trtc/calls-uikit-vue
+// Vue 2.7: @trtc/calls-uikit-vue2
+// Vue 2.6: @trtc/calls-uikit-vue2.6  （API 一致，仅包名不同）
+import { TUICallKitAPI } from "@trtc/calls-uikit-react";
+
+const trtcCloudInstance = TUICallKitAPI?.getTUICallEngineInstance()?.getTRTCCloudInstance();
+const params = {
+  api: 'enableAutoPlayDialog',
+  params: { enable: 0 },
+};
+trtcCloudInstance?.callExperimentalAPI(JSON.stringify(params));
+```
+
+## 5. 结果判定
+
+- 不关闭弹窗：通话时弹出"恢复播放"提示，用户点击后音频正常播放。
+- 关闭弹窗：通话时不再弹出提示，音频在浏览器允许后自动播放（若仍被拦截则无声）。
+
+## 6. 常见误区
+
+- 误区 1：认为弹窗是 TUICallKit 的 bug（实际是浏览器自动播放限制策略）。
+- 误区 2：直接关闭弹窗后期望所有场景都能正常播放（关闭弹窗不解除自动播放限制，无声问题仍可能发生）。
+- 误区 3：在 TUICallKit 初始化前调用 `enableAutoPlayDialog`（需在获取到 TRTC 实例后调用）。
+
+## 7. 问题定义（检索辅助，极简）
+
+Web TUICallKit 通话时弹出"恢复播放"弹窗，用户需点击才能听到声音，如何解决及是否可关闭弹窗。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- TUICallKit 通话没有声音怎么办？
+- 为什么 TUICallKit 会弹出"恢复播放"提示？
+- 如何关闭 TUICallKit 的自动播放弹窗？
+- webview 中 TUICallKit 无声怎么处理？
+- `enableAutoPlayDialog` 怎么设置？
+
+## 9. 参考来源（可选）
+
+- TUICallKit Web 自动播放说明：`https://cloud.tencent.com/document/product/647/78769#066739b9-fb33-4f11-a21c-66edd91be64a`

package/resource/knowledge/callkit/best-practice/common/call-message-in-chat.md

@@ -0,0 +1,84 @@
+---
+title: 在无 UI Chat SDK 项目中集成 TUICallKit 时如何显示音视频通话消息
+product: call
+frameworks: [react, vue, miniprogram, android, ios, flutter, uni-app, web]
+scope: platform_common
+tags: [TUICallKit, call-message, custom message, actionType, cmd, call_end, 通话消息渲染]
+version_range: ">=2.0.0"
+---
+
+# 在无 UI Chat SDK 项目中集成 TUICallKit 时如何显示音视频通话消息
+
+## 1. 核心结论
+
+- 通话消息是 TUICallKit 通话过程中由后台通过 Chat REST API 补发的自定义消息，各平台可通过 Chat SDK 的消息接收事件或拉取历史消息获取。
+- 通话过程中的实时状态（振铃、接听、挂断）由 TUICallKit 的事件监听处理，不依赖 Chat 消息。
+- 通过 `actionType` 判断通话结果类型（挂断/取消/拒绝/超时），通过 `cmd` 区分语音/视频/忙线。
+- 通话时长从 `call_end` 字段获取，单位秒。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `actionType` | 通话事件类型 | 1=发起/挂断，2=取消，3=接听，4=拒绝，5=超时未接听 |
+| `cmd` | 通话指令细分 | `videoCall` 视频通话、`audioCall` 语音通话、`hangup` 挂断、`line_busy` 忙线 |
+| `call_end` | 通话时长 | `actionType=1` 且 `cmd=hangup` 时存在，单位秒 |
+| `MESSAGE_RECEIVED` | 消息接收事件 | Chat SDK 统一事件，含通话自定义消息 |
+| `getMessageList` | 拉取历史消息 | 进入会话后拉取，通话消息也在返回列表中 |
+
+### actionType 与 cmd 对照表
+
+| 场景 | actionType | cmd | 备注 |
+|---|---|---|---|
+| 发起通话 | 1 | `videoCall` 或 `audioCall` | 主叫发出 |
+| 已接听 | 3 | — | 被叫接听后触发 |
+| 通话已结束 | 1 | `hangup` | 有一方挂断；`call_end` 含通话时长 |
+| 取消通话 | 2 | — | 主叫在接听前取消 |
+| 拒绝通话 | 4 | — | 被叫主动拒绝 |
+| 对端忙线 | 4 | `line_busy` | 被叫正在通话中 |
+| 超时未接听 | 5 | — | 被叫在规定时间内未接听 |
+
+## 3. 机制/时序
+
+主叫发起通话 -> TUICallKit 通过信令通道（非 Chat 消息）建立通话连接 -> 通话过程中，每发生一次状态变化（取消/接听/拒绝/超时/挂断），TUICallKit 后台都会通过 REST API 向 Chat SDK 补发一条自定义消息 -> 双方通过 `MESSAGE_RECEIVED` 收到补发消息 -> 按 `actionType` 和 `cmd` 区分事件类型并更新 UI。
+
+通话过程本身（发起、接听、取消、拒绝、超时）不依赖 Chat 自定义消息通知；Chat 消息仅用于通话结束后在会话中展示通话记录。
+
+## 4. 标准用法
+
+1. 通过 Chat SDK 获取补发的通话自定义消息（监听消息接收事件或拉取历史消息，接口名因平台而异，但语义一致）。
+2. 读取 `message.actionType` 和 `message.cmd` 判断通话事件类型。
+3. 通话挂断消息（`actionType=1, cmd=hangup`）读取 `message.call_end` 显示通话时长。
+4. 其他 `actionType` 值用于判断通话未接通的原因（取消/拒绝/忙线/超时），更新 UI 展示。
+
+## 5. 结果判定
+
+- 通话各状态变化后，能通过 Chat SDK 收到补发的通话自定义消息。
+- `actionType` 与 `cmd` 能正确反映通话状态变化。
+- `call_end` 值准确反映通话实际时长。
+- `actionType` 与 `cmd` 能正确反映通话状态变化。
+- `call_end` 值准确反映通话实际时长。
+
+## 6. 常见误区
+
+- 误区 1：将通话消息当作普通自定义消息处理，没有读取 `actionType` 做状态区分。
+- 误区 2：只处理 `MESSAGE_RECEIVED`，不处理 `getMessageList` 拉取的离线通话消息。
+- 误区 3：通话时长从消息的 `timestamp` 差值计算（应直接从 `call_end` 字段读取）。
+- 误区 4：未处理 `line_busy` 场景，导致忙线被当作普通拒绝。
+
+## 7. 问题定义（检索辅助，极简）
+
+在无 UI Chat SDK 项目中集成 TUICallKit，如何通过 Chat SDK 获取并渲染音视频通话消息（发起/接听/挂断/取消/拒绝/超时/忙线）。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- TUICallKit 通话消息怎么解析？
+- `actionType` 各值代表什么意思？
+- 通话结束后怎么拿到通话时长？
+- `MESSAGE_RECEIVED` 收到通话消息怎么区分是发起还是挂断？
+- 如何判断被叫忙线？
+- 小程序中通话消息和 Web 端解析方式一样吗？
+
+## 9. 参考来源（可选）
+
+- 音视频通话信令字段说明：`https://cloud.tencent.com/document/product/647/84363`