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

package/resource/index/vectors/index.json

@@ -0,0 +1,4 @@
+[diffend] Oversized file quarantined before diffing.
+name: package/resource/index/vectors/index.json
+size: 55634849 bytes
+sha256: 1a1ede6da1f0cd8436e10c9318209a63cd906bec102f4ed20536edf27c87b44d

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

@@ -15,8 +15,6 @@
 
 ## 快速接入
 
-### 步骤1：导入组件
-
 ### 步骤2：工程配置
 1. 在工程根目录下找到`settings.gradle.kts`（或 `settings.gradle )`文件，增加如下代码，导入`tuicallkit-kt`、`atomic_x` 组件到项目中。
 

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

@@ -385,8 +385,6 @@ TUICallKit.createInstance().enableMuteMode(enable: true)
 
 ## 常见问题
 
-### **TUIKit 是否支持后台运行？**
-
 ### Xcode 出现 **Sandbox: rsync** 编译报错？
 
 可以在 **Build Settings** 中把 **User Script Sandboxing** 设置为 **NO：**

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

@@ -39,7 +39,7 @@ npm run dev
 > **说明：**
 > 示例项目地址：[点击查看 Gitee 示例项目](https://gitee.com/tencent-cloud-uikit/rtc-chat-web)。
 >
-> 示例项目用于帮助您快速体验和对照接入流程。若您需要在已有项目中集成，建议继续阅读下方步骤，按文档逐步完成接入。
+> 示例项目用于帮助您快速体验完整接入效果，并对照接入流程。若您需要在已有项目中集成，建议继续阅读下方步骤，按文档逐步完成接入。
 >
 
 ## 创建项目
@@ -78,7 +78,7 @@ npm create vite@latest
 
 【shell】
 ``` bash
-npm i @tencentcloud/chat-uikit-react
+npm i @tencentcloud/chat-uikit-react @trtc/calls-uikit-react
 ```
 
 ### 步骤 2. 引入组件
@@ -111,6 +111,7 @@ import {
   useUIKit,
   useChatContext,
 } from "@tencentcloud/chat-uikit-react";
+import { TUICallKit } from '@trtc/calls-uikit-react';
 import { IconChat, IconUsergroup, IconBulletpoint, IconSearch } from "@tencentcloud/uikit-base-component-react";
 
 function App() {
@@ -118,6 +119,7 @@ function App() {
   // 主题支持 light(default) / dark
   return (
     <UIKitProvider theme={'light'} language={'zh-CN'}>
+      <TUICallKit className="call-kit" />
       <ChatApp />
     </UIKitProvider>
   );
@@ -397,12 +399,12 @@ npm run dev
 ### 音视频通话
 
 > **说明：**
-> TUICallKit 是腾讯云推出一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
->
+> - TUICallKit 是腾讯云推出一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
 > 更多详细信息可参考：音视频通话-开通服务。
 >
+> - 在上面的过程中已经集成了 TUICallKit，若不需要音视频通话功能，可参考以下过程移除集成代码。
 
-1. 安装 `@trtc/calls-uikit-react` 依赖
+1. 安装 `@trtc/calls-uikit-react` 依赖。
 
    ``` bash
    npm install @trtc/calls-uikit-react
@@ -432,6 +434,8 @@ npm run dev
    ```
 4. 拨打语音通话
 
+5. 如果不需要集成音视频通话，可以通过移除 `<TUICallKit />`、修改 ChatHeader 组件的 enableCall 属性，来移除音视频通话的能力。
+
 ### 云端搜索
 
 > **说明：**

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

@@ -472,6 +472,10 @@ import { initCallService } from '@/uni_modules/tuikit-atomic-x/server/callServic
 initCallService();
 ```
 
+## 集成音视频会议
+
+集成 [TUIRoomKit](https://cloud.tencent.com/document/product/647/133183)，快速获得开箱即用的多人音视频会议能力。
+
 ## 常见问题
 
 ### 技术兼容性类

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

@@ -32,9 +32,9 @@ chat-uikit-vue3 主要分为 ConversationList、Chat、MessageList、ChatHeader
 
 - Node.js（Node.js ≥ 20.0.0，建议使用目前的 LTS v22 版本）
 
-## 快速体验完整示例项目
+## 快速体验完整接入项目
 
-如果您希望先快速跑通完整效果，或在接入过程中对照最终代码结构，可以直接克隆我们已经完成接入的示例项目。示例项目已完成 Chat UIKit 相关依赖安装、组件引入、初始化配置和基础页面接入，适合作为接入参考。
+**您可以直接克隆我们已经完成接入的示例项目，**以快速查看跑通完整效果，或在接入过程中对照最终代码结构。示例项目已完成 Chat UIKit 相关依赖安装、组件引入、初始化配置和基础页面接入，适合作为接入参考。
 ``` bash
 git clone https://gitee.com/tencent-cloud-uikit/rtc-chat-web.git
 cd chat-desktop-vue3
@@ -45,7 +45,7 @@ npm run dev
 > **说明：**
 > 示例项目地址：[点击查看 Gitee 示例项目](https://gitee.com/tencent-cloud-uikit/rtc-chat-web)。
 >
-> 示例项目用于帮助您快速体验和对照接入流程。若您需要在已有项目中集成，建议继续阅读下方步骤，按文档逐步完成接入。
+> 示例项目用于帮助您快速体验完整接入效果。若您需要在已有项目中集成，建议继续阅读下方步骤，按文档逐步完成接入。
 >
 
 ## 创建项目
@@ -94,7 +94,7 @@ cd chat-integration-vue3
 
 【shell】
 ``` bash
-npm i @tencentcloud/chat-uikit-vue3@6 tuikit-atomicx-vue3@6
+npm i @tencentcloud/chat-uikit-vue3@6 tuikit-atomicx-vue3@6 @trtc/calls-uikit-vue
 ```
 
 ### 步骤2：引入组件
@@ -109,6 +109,7 @@ npm i @tencentcloud/chat-uikit-vue3@6 tuikit-atomicx-vue3@6
 ``` typescript
 <template>
   <UIKitProvider language="zh-CN" theme="light">
+    <TUICallKit class="call-kit" />
     <ChatLayout v-if="isLoggedIn" />
   </UIKitProvider>
 </template>
@@ -116,6 +117,7 @@ npm i @tencentcloud/chat-uikit-vue3@6 tuikit-atomicx-vue3@6
 <script setup lang="ts">
 import { ref } from 'vue';
 import { UIKitProvider, useLoginState } from '@tencentcloud/chat-uikit-vue3';
+import { TUICallKit } from '@trtc/calls-uikit-vue';
 import ChatLayout from './components/ChatLayout.vue';
 
 const { login } = useLoginState();
@@ -364,10 +366,10 @@ npm run dev
 ### 音视频通话
 
 > **说明：**
-> TUICallKit 是腾讯云推出一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
->
+> - TUICallKit 是腾讯云推出一款音视频通话 UI 组件，通过集成该组件，您只需要编写几行代码就可以在聊天应用中体验音视频通话功能。
 > 更多详细信息可参考：音视频通话-开通服务。
 >
+> - 在上面的过程中已经集成了 TUICallKit，若不需要音视频通话功能，可参考以下过程移除集成代码。
 
 1. 安装 `@trtc/calls-uikit-vue` 依赖。
 
@@ -416,6 +418,8 @@ npm run dev
    ```
 4. 拨打语音通话。
 
+5. 如果不需要集成音视频通话，可以通过移除 `<TUICallKit />`、移除 MessageInput 组件的 #headerToolbar 插槽中的 VideoCallPicker 和 AudioCallPicker 组件，来移除音视频通话的能力。
+
 ### 视频会议
 
 TUIRoomKit 是一款定位企业会议、网络研讨会、在线教育等多人音视频会话场景的含 UI 低代码组件，提供房间管理、成员管理、屏幕分享等会控功能，支持标清、高清、超高清等多种画质。

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

@@ -9,10 +9,6 @@
 
 TUILiveKit UI 组件为您提供的是功能闭环、交互丰富的直播全链路逻辑，集成后可快速实现一套交互完整、业务丰富的直播系统。
 
-### **视频直播**
-
-### **语聊房**
-
 ## **准备工作**
 
 ### 开通服务

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

@@ -9,10 +9,6 @@
 
 `TUILiveKit` 是一个功能全面的直播组件，集成后可快速实现以下场景功能。
 
-### **视频直播**
-
-### **语聊房**
-
 ## 准备工作
 
 ### 开通服务

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

@@ -9,8 +9,6 @@
 
 - **SDKSecretKey：**应用密钥，仅用于本地调试时生成 UserSig，不可写入生产代码。
 
-- **UserSig：**登录凭证。须由业务服务端签发并下发，切勿在客户端硬编码 SDKSecretKey。本地调试可用 `genTestUserSig` 生成临时签名，不可用于生产，详见 [正式运行阶段如何计算 UserSig](https://cloud.tencent.com/document/product/647/17275#formal)。
-
 ### 环境准备
 - **Node.js：**≥ 18.19.1 (推荐使用官方 LTS 版本)。
 
@@ -18,7 +16,8 @@
 
 - **媒体设备：**建议配备摄像头、麦克风和扬声器。缺少相应设备时仍可入会，但对应音视频能力不可用。
 
-### 安装依赖
+## 安装与初始化
+1. **安装 SDK**
 
 【npm】
 ``` bash
@@ -38,243 +37,190 @@ pnpm install @tencentcloud/roomkit-web-vue3 tuikit-atomicx-vue3 @tencentcloud/ui
 yarn add @tencentcloud/roomkit-web-vue3 tuikit-atomicx-vue3 @tencentcloud/uikit-base-component-vue3 @tencentcloud/universal-api
 ```
 
-## 快速接入
-
-### 发起会议
-
-**适用场景：**用户在客户端点击“快速会议”，需要立即创建房间并加入（如临时沟通、IM 聊天内发起会议）。
-
-**实现方式：**由客户端生成或向业务后台申请一个唯一的房间号，随后由发起人调用 `createAndJoin` 创建并直接进入该房间。
+2. **初始化实例**
+
+   在业务页面的 `<script setup>` 中初始化会议实例：
+
+   ``` typescript
+   <script setup>
+   import { RoomKit, genTestUserSig } from '@tencentcloud/roomkit-web-vue3';
+   const SDKAppID = 0;  // 替换为您在开通服务阶段获取的 SDKAppID
+   const SDKSecretKey = '';  // 替换为您在开通服务阶段获取的 SDKSecretKey
+   const userId = 'your_user_id';  // 业务侧用户唯一标识
+
+   const { userSig } = genTestUserSig({ sdkAppId: SDKAppID, secretKey: SDKSecretKey, userId });
+   const room = RoomKit.getInstance({ sdkAppId: SDKAppID, userId, userSig });
+   </script>
+   ```
+
+   > **说明：**
+   >
+   > 示例采用客户端生成 UserSig 的方式，仅可用于本地开发调试。正式环境请改为由业务服务端生成 UserSig，详见 正式运行阶段如何计算 UserSig。
+   >
+
+## 发起会议
+
+用户点击“发起会议”时，调用 `createAndJoin` 创建并进入会议，传入以下参数：
+- `roomId`： 业务生成的房间号，同一应用内不能重复，长度为 1～48 字节，仅支持英文字母（区分大小写）、数字、下划线 _ 和连字符 -。
+
+- `password`： 参会密码，可不传；设置后，其他用户调用 join 时，RoomKit 会自动弹出密码输入框，验证通过后即可入会。
+
+   ``` typescript
+   <script setup>
+   const hostMeeting = async () => {
+     // room 为“安装与初始化”中创建的实例
+     await room.createAndJoin({
+       roomId: 'meeting_001', // 替换为业务生成的唯一房间号
+       password: '123456', // 参会密码
+       // 方式一：页面指定区域显示
+       container: { appendTo: '#meeting' },
+       // 方式二：固定尺寸弹窗显示
+       // container: { appendTo: 'body', width: '960px', height: '640px' },
+     });
+   };
+   </script>
+   <template>
+     <button @click="hostMeeting">发起会议</button>
+     <!-- 仅方式一需要，用于显示会议界面 -->
+     <div id="meeting" style="width: 1080px; height: 720px"></div>
+   </template>
+   ```
+
+## 加入会议
+
+调用 `join` 并传入已预定或创建的房间号 `roomId`，即可加入会议。
 ``` typescript
 <script setup>
-import { RoomKit } from '@tencentcloud/roomkit-web-vue3';
-
-// 房间不存在则创建并成为房主，已存在则直接加入
-const startQuickMeeting = async () => {
-  const room = RoomKit.getShareInstance({
-    sdkAppId: 0, // 控制台获取的 SDKAppID
-    userId: 'your_user_id', // 业务侧用户唯一标识
-    userSig: 'your_user_sig', // 由业务服务端签发并下发，切勿在客户端硬编码 SDKSecretKey
+const joinMeeting = async () => {
+  // room 为“安装与初始化”中创建的实例
+  await room.join({
+    roomId: 'meeting_001',
+    // 方式一：页面指定区域显示
+    container: { appendTo: '#meeting' },
+    // 方式二：固定尺寸弹窗显示
+    // container: { appendTo: 'body', width: '960px', height: '640px' },
   });
-
-  const myRoomId = `room_${Date.now()}`; // 由业务生成，需保证全局唯一
-  await room.createAndJoin({ container: '#meeting', roomId: myRoomId });
-};
+}
 </script>
-
 <template>
-  <button @click="startQuickMeeting">发起会议</button>
-  <!-- 会议界面的挂载节点，需在进会前完成渲染，并指定明确宽高 -->
-  <div id="meeting" style="width: 1080px; height: 640px"></div>
+  <button @click="joinMeeting">加入会议</button>
+  <!-- 仅方式一需要，用于显示会议界面 -->
+  <div id="meeting" style="width: 1080px; height: 720px"></div>
 </template>
 ```
 
-### 预定会议
-
-#### **场景一：客户端预订**
+## 预定会议
 
-**适用场景：**适用于需要在未来特定时间召开的会议（如团队周会、线上培训等）。用户可在客户端提前设定会议标题、时间及受邀参会成员。
+#### **客户端预定**
 
-**实现方式：**由客户端生成或向业务后台申请一个唯一的房间号，并配合会议时间等参数调用 scheduleRoom 接口提交预定。预定成功后，会议信息将同步至参与者的会议列表中。更多客户端预订会议能力请参考 [无 UI 集成 > 预订房间](https://cloud.tencent.com/document/product/647/126931)。
-
-#### **场景二：服务端预订**
-
-**适用场景：**会议排期完全由业务系统统一管理，不由客户端发起（如政务、医疗、大型企业 OA 等强管控场景）。
-
-**实现方式：**由业务服务端调用 [服务端 REST API 创建房间](https://cloud.tencent.com/document/product/647/104446)，在 invitees 中指定受邀成员后，这些成员在客户端同样能拉取到该会议。
-
-### 加入会议
-
-房间已经存在时调用 `join` 接口，参数中传入 `roomId`。
+调用 `scheduleRoom` 预定会议，通过 `scheduleStartTime` 指定开始时间、`scheduleAttendees` 指定参会人、`password` 设置参会密码。
 ``` typescript
-<script setup>
-import { RoomKit } from '@tencentcloud/roomkit-web-vue3';
-
-const room = RoomKit.getShareInstance({
-  sdkAppId: 0, // 控制台获取的 SDKAppID
-  userId: 'your_user_id', // 业务侧用户唯一标识
-  userSig: 'your_user_sig', // 由业务服务端签发并下发，切勿在客户端硬编码 SDKSecretKey
-});
-
-const joinMeeting = async (sharedRoomId) => {
-  await room.join({ container: '#meeting', roomId: sharedRoomId });
-};
-</script>
-
-<template>
-  <div id="meeting" style="width: 1080px; height: 640px"></div>
-</template>
-
+import { useLoginState, useRoomState } from 'tuikit-atomicx-vue3/room';
+const { login } = useLoginState();
+const { scheduleRoom } = useRoomState();
+const schedule = async () => {
+  await login({
+    sdkAppId: 0, // 控制台获取的 SDKAppID
+    userId: 'your_user_id', // 业务侧用户唯一标识
+    userSig: 'your_user_sig', // 由业务服务端签发并下发
+  });
+  const start = Math.floor(Date.now() / 1000) + 3600;
+  await scheduleRoom({
+    roomId: 'meeting_002', // 业务生成的唯一房间号，规则同“发起会议”
+    options: {
+      roomName: '产品需求评审', // 会议名称
+      scheduleStartTime: start, // 秒级时间戳，示例为 1 小时后开始
+      scheduleEndTime: start + 1800, // 秒级时间戳，示例为开会 30 分钟后结束
+      scheduleAttendees: ['userA', 'userB'], // 参会人的 userId 列表
+      password: '739251', // 参会密码；不设置密码时省略
+    },
+  });
+}
 ```
 
-### 离开会议
-
-TUIRoomKit 已在界面上内置离开与解散房间功能，用户可直接点击 **离开房间** 或 **解散房间** 完成操作。
-
-如需在业务代码中主动触发离开或解散，可调用以下接口，接口执行完成即代表退出成功，**不会触发** `exited` **事件**。
+#### **服务端预定**
 
-**场景一：主动离开房间**
+如果您希望由后台业务系统而不是客户端来预定会议，可以使用我们提供的 [REST API](https://cloud.tencent.com/document/product/647/104446)。
 
-参与者和房主均可调用 `leave()` 离开会议，调用后不影响其他成员，房间继续存在。
-``` typescript
-const room = RoomKit.getShareInstance({
-  sdkAppId: 0, // 控制台获取的 SDKAppID
-  userId: 'your_user_id', // 业务侧用户唯一标识
-  userSig: 'your_user_sig', // 由业务服务端签发并下发，切勿在客户端硬编码 SDKSecretKey
-});
+## 界面定制
 
-await room.leave();
-```
+TUIRoomKit 支持定制视频画面信息、主题、字体、语言和联系人列表，均通过 `setUIConfig` 配置。该方法在入会前和会议过程中均可调用，每次只更新传入的配置项，未传入的保持不变。
 
-> **说明：**
-> 房主离开房间或关闭网页，不会自动解散房间，其他参会成员可继续正常使用 TUIRoomKit 能力，系统会在会议结束时间后 6 小时、且房间内人数为 0 时自动回收房间资源
->
+### 视频画面信息
 
-**场景二：主动解散房间**
+TUIRoomKit 会在每路视频画面上叠加一层信息，默认展示参会者的头像、显示名、麦克风状态和主持人标识，屏幕共享画面则显示共享提示。如果默认的内容或样式不满足需求，可通过 `participantViewUI` 自行定义这层信息。
 
-房主调用 `end()` 后，房间内所有成员均会收到房间已解散的通知。传入 `roomId` 可解散指定房间，调用者无需身处该房间，适用于在会议列表中直接解散某一场会议。
+**步骤1：**编写视频画面信息组件。
 ``` typescript
-const room = RoomKit.getShareInstance({
-  sdkAppId: 0, // 控制台获取的 SDKAppID
-  userId: 'your_user_id', // 业务侧用户唯一标识
-  userSig: 'your_user_sig', // 由业务服务端签发并下发，切勿在客户端硬编码 SDKSecretKey
-});
-
-// 解散当前所在的会议
-await room.end();
+// ParticipantOverlay.vue
+<template>
+  <div class="overlay">
+    <div v-if="streamType === VideoStreamType.Screen" class="sharing">正在共享屏幕</div>
+    <div v-else class="info">
+      <span class="name">{{ participant.nameCard || participant.userName || participant.userId }}</span>
+      <span v-if="participant.microphoneStatus === DeviceStatus.Off" class="muted">已静音</span>
+    </div>
+  </div>
+</template>
+<script setup lang="ts">
+import { DeviceStatus, VideoStreamType } from 'tuikit-atomicx-vue3/room';
+import type { RoomParticipant } from 'tuikit-atomicx-vue3/room';
+defineProps<{
+  participant: RoomParticipant;
+  streamType: VideoStreamType;
+}>();
+</script>
 ```
 
-### 事件监听
-
-房间可能因用户离开、被解散、被踢或登录态失效而结束。TUIRoomKit 会处理底层音视频资源与界面提示，**页面怎么走由业务接管**。通过 `on('exited')` 监听退出，在回调中恢复业务页面，该方法返回一个取消监听的函数。
+**步骤2：**通过 `setUIConfig` 方法传入该组件。
 ``` typescript
-import { onUnmounted } from 'vue';
-import { RoomKit, ExitReason } from '@tencentcloud/roomkit-web-vue3';
-
-const room = RoomKit.getShareInstance({
-  sdkAppId: 0, // 控制台获取的 SDKAppID
-  userId: 'your_user_id',
-  userSig: 'your_user_sig', // 由业务服务端签发
-});
-
-const offExited = room.on('exited', ({ roomId, reason }) => {
-  switch(reason) {
-    case ExitReason.KickedOffline:
-    case ExitReason.UserSigExpired:
-      backToLogin(); // 业务侧的登录逻辑
-      break;
-    default:
-      // 隐藏会议容器或返回上一页
-      return;
-  }
-});
+import ParticipantOverlay from './ParticipantOverlay.vue';
 
-onUnmounted(() => offExited()); // 组件销毁时取消监听
+// room 为 RoomKit.getInstance() 返回的会议实例
+room.setUIConfig({ participantViewUI: ParticipantOverlay });
 ```
 
-`reason` 的取值及触发时机如下。
-
-|`reason`|触发时机|
-|---------|---------|
-|`ExitReason.RoomLeave`|用户点击界面上的「离开会议」按钮，或在密码输入框中点击取消|
-|`ExitReason.RoomDismiss`|会议被解散，对所有成员触发|
-|`ExitReason.KickedOut`|被房主踢出会议|
-|`ExitReason.RoomError`|会议界面已挂载后进房失败（如输入密码后进房失败），TUIRoomKit 会先给出错误提示。界面挂载前的失败不触发本事件：`join` 由 TUIRoomKit 弹出错误提示且 Promise resolve，`createAndJoin` 当场失败则抛出异常|
-|`ExitReason.KickedOffline`|同一账号在其他设备登录，当前设备被强制下线|
-|`ExitReason.UserSigExpired`|UserSig 已过期|
-
 > **说明：**
-> `KickedOffline` 与 `UserSigExpired` 属于登录态失效，即使用户当前不在会议中也会触发，此时 `roomId` 为空字符串。
->
-
-## 界面定制
+> 1. `participantViewUI` 传入的组件会同时用于摄像头画面和屏幕共享画面，如需对两者做不同展示，可在组件内通过 `streamType` 区分。
+> 2. 视频流的采集、订阅、渲染，以及宫格、演讲者等画面布局仍由 TUIRoomKit 负责，不受 `participantViewUI` 影响。
 
-在完成基础集成后，您可以根据业务需求进一步定制会议界面。以下配置均通过会议实例调用，建议在进会前调用，避免界面加载后再变化。
-
-### 配置主题及语言
-
-会议界面默认使用浅色主题，界面语言跟随浏览器语言。用户可在会中通过内置的主题、语言按钮自行切换；如需隐藏这两个按钮。更多自定义主题及语言。
-
-### 调整工具栏按钮
-
-会议界面的工具栏按钮默认全部展示。如需隐藏某些能力（如后台系统不需要主题切换、教育场景不开放屏幕共享），可调用 `setWidgetVisible`：
-``` typescript
-import { RoomKit, BuiltinWidget } from '@tencentcloud/roomkit-web-vue3';
-
-const room = RoomKit.getShareInstance({
-  sdkAppId: 0, // 控制台获取的 SDKAppID
-  userId: 'your_user_id',
-  userSig: 'your_user_sig', // 由业务服务端签发
-});
-
-room.setWidgetVisible({
-  [BuiltinWidget.ScreenShareWidget]: false, // 隐藏屏幕共享
-  [BuiltinWidget.ThemeWidget]: false, // 隐藏主题切换
-});
-```
+### 主题与语言
 
-若需要在用户操作生效前插入业务校验（如开启摄像头前确认权限、共享屏幕前提示保密要求），可使用 `onWill` 拦截：
+TUIRoomKit 支持通过 `setUIConfig` 调整界面的主题、字体和语言。
 ``` typescript
-import { InterceptorAction } from '@tencentcloud/roomkit-web-vue3';
-
-const offInterceptor = room.onWill(InterceptorAction.StartScreenShare, async (_action, proceed, abort) => {
-  const confirmed = await showYourOwnConfirmDialog();
-  confirmed ? proceed() : abort();
+// room 为 RoomKit.getInstance() 返回的会议实例
+room.setUIConfig({
+  theme: {
+    themeStyle: 'light',
+    primaryColor: '#07C160',
+    backgroundColor: '#F2FAF5',
+    textColor: '#122B1C',
+  },
+  fontFamily: "'Avenir Next', Avenir, 'Helvetica Neue', 'PingFang SC', sans-serif",
+  language: 'en-US',
 });
 ```
 
-更多界面调整能力。
-
-### 配置用户联系人列表
-
-TUIRoomKit 内置的邀请参会和预定会议选人组件，底层默认依赖腾讯云 IM 的用户关系链（好友列表）。如果您希望在这些组件中展示您企业内部的组织架构或好友列表，请先通过服务端 REST API 将您的业务联系人同步至腾讯云 IM 系统中：
-1. 使用 [账号管理 > 导入多个账号](https://cloud.tencent.com/document/product/269/4919) REST API 接口批量导入用户账号。
-
-2. 使用 [好友管理 > 导入好友](https://cloud.tencent.com/document/product/269/8301) REST API 接口批量导入用户关系链。
+|配置项|默认值|说明|
+|---------|---------|---------|
+|`theme`|浅色主题、蓝色主色|`themeStyle` 可切换 `'light'`、`'dark'` 两套风格。也可通过 `primaryColor`、`backgroundColor`、`textColor` 自定义主色、背景色和文字色。|
+|`fontFamily`|`'PingFang SC', 'Microsoft YaHei', 'Noto Sans SC', sans-serif`|会议界面的全局字体。|
+|`language`|跟随浏览器语言|可指定为 `'zh-CN'` 或 `'en-US'`。|
 
-### 修改房间分享链接
+### 导入联系人
 
-TUIRoomKit 默认使用当前页面地址作为房间分享链接。
-
-如您需要修改链接地址，可调用 `setFeatureConfig` 更新分享链接。
+会中邀请他人加入会议时，默认显示当前用户的腾讯云 IM 好友。如需使用您的业务联系人，可参考以下代码配置 `contactList`。
 ``` typescript
-import { RoomKit } from '@tencentcloud/roomkit-web-vue3';
-
-const room = RoomKit.getShareInstance({
-  sdkAppId: 0, // 控制台获取的 SDKAppID
-  userId: 'your_user_id',
-  userSig: 'your_user_sig', // 由业务服务端签发
-});
-
-// 在 createAndJoin / join 成功之后立即调用，确保 roomId 已知
-const roomId = '123456';
-room.setFeatureConfig({
-  shareLink: `https://your-domain.com/room?roomId=${roomId}`,
+// room 为 RoomKit.getInstance() 返回的会议实例
+room.setUIConfig({
+  contactList: () => [
+    { userId: 'denny', userName: 'Denny' },
+    { userId: 'tommy', userName: 'Tommy' },
+    { userId: 'lucy', userName: 'Lucy' },
+  ],
 });
 ```
 
-### 设置视频布局及挂件
-
-TUIRoomKit 目前支持九宫格、侧边栏及顶部栏三种流布局，默认为九宫格布局，开发者可调用 `setFeatureConfig` 修改默认视频布局。
-``` typescript
-import { RoomKit } from '@tencentcloud/roomkit-web-vue3';
-import { RoomLayoutTemplate } from 'tuikit-atomicx-vue3/room';
-
-const room = RoomKit.getShareInstance({
-  sdkAppId: 0, // 控制台获取的 SDKAppID
-  userId: 'your_user_id',
-  userSig: 'your_user_sig', // 由业务服务端签发
-});
-
-// 方案一：修改默认视频流布局为侧边栏布局
-room.setFeatureConfig({ layoutTemplate: RoomLayoutTemplate.SidebarLayout });
-
-// 方案二：修改默认视频流布局为顶部栏布局
-room.setFeatureConfig({ layoutTemplate: RoomLayoutTemplate.CinemaLayout });
-```
-
-TUIRoomKit 默认内置以下视频流挂件，如您需要自定义视频流挂件。
-
 ## 常见问题
 
 ### 创建房间的用户（房主）关闭网页或异常退出后，会议会立即结束吗？
@@ -307,12 +253,12 @@ TUIRoomKit 默认内置以下视频流挂件，如您需要自定义视频流挂
 ### 是否支持使用 iframe 集成?
 
 支持。使用 iframe 集成 TUIRoomKit 时, 需要在 iframe 标签中配置 allow 属性以授予必要的浏览器权限（麦克风、摄像头、屏幕共享、全屏等），示例如下:
-``` typescript
-// 开启麦克风、摄像头、屏幕分享、全屏权限
-<iframe src="https://your-domain.com/index.html" allow="microphone; camera; display-capture; display; fullscreen;">
+``` html
+<!-- 开启麦克风、摄像头、屏幕分享、全屏权限 -->
+<iframe src="https://your-domain.com/index.html" allow="microphone; camera; display-capture; display; fullscreen;"></iframe>
 ```
 
-更多信息可参考 内嵌页面 （iframe)。
+更多信息可参考 内嵌页面 （iframe）。
 
 ### 是否支持设置内网代理？
 
@@ -327,8 +273,8 @@ TUIRoomKit 已提供丰富的 UI 自定义能力，包括 主题及语言、界
 
    若您已充分评估维护风险，且业务存在必须修改底层结构的深度定制需求，可按以下步骤导出源码：
 
-【Vue3】
-1. 执行源码导出脚本，默认拷贝路径为 `./src/components/RoomKit`
+【源码导出步骤】
+1. 执行源码导出脚本，默认拷贝路径为 `./src/components/RoomKit`。
 
 ``` bash
   node ./node_modules/@tencentcloud/roomkit-web-vue3/scripts/eject.js
@@ -342,7 +288,7 @@ TUIRoomKit 已提供丰富的 UI 自定义能力，包括 主题及语言、界
 // 替换引用路径为 TUIRoomKit 源码的真实路径
 + import { RoomKit } from './components/RoomKit/index.ts';
 ```
-4. 配置 ESLint 校验
+4. 配置 ESLint 校验。
 
 如果您导出 TUIRoomKit 源码后运行项目出现 ESLint 报错，您可以在 `.eslintignore` 文件中添加 RoomKit 文件夹忽略 ESLint 检测。
 ``` javascript

package/resource/knowledge/callkit/best-practice/android/video-chat-dating.md

@@ -7,8 +7,6 @@
 
 - 两台以上 Android 5.0 的设备。
 
-### 开通服务
-
 ## 跑通 Demo
 
 ### 步骤 1: 下载 Demo

package/resource/knowledge/callkit/core-sdk/android/answer-call.md

@@ -11,8 +11,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：集成 SDK
 1.  请在您的 **build.gradle** 文件中添加 api `"io.trtc.uikit:atomicx-core:latest.release"` 和 api `"com.tencent.imsdk:imsdk-plus:8.7.7201"` 依赖，然后执行 **Gradle Sync**。