@tencentcloud/sdk-mcp 1.3.9 → 1.4.0

package/resource/doc/roomkit/vue/features/room-chat.md

@@ -7,15 +7,13 @@
 
 - **直播教学：**学生可以在聊天区发送弹幕或问题，老师实时查看并解答，增强课堂互动性。
 
-
 ## 前提条件
 
 在接入功能前，请确保满足以下条件：
-- **用户状态：**用户已经通过 useLoginState 完成登录鉴权，参考 [接入概览](https://write.woa.com/document/197379797539790848)，并已作为一个房间的房主或成员在房间内，参考 [房间管理](https://write.woa.com/document/197379861957083136)。
+- **用户状态：**用户已经通过 useLoginState 完成登录鉴权，参考 接入概览，并已作为一个房间的房主或成员在房间内，参考 房间管理。
 
 - **环境依赖：**项目已正确安装并引入 `tuikit-atomicx-vue3`。
 
-
 ## 实现会中聊天功能
 
 本功能提供两种集成方案，您可以根据业务需求选择最适合的一种：
@@ -23,11 +21,8 @@
 
 - **方案二（高级）：**使用底层 API 自定义集成。基于 atomicx-core SDK API [useMessageListState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageListState) 和 [useMessageInputState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageInputState) 状态钩子自行实现 UI 和交互逻辑，灵活度最高。
 
-   ![会中聊天](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027160512/8c740e5cdf1111f09143525400bf7822.png)
-
    会中聊天
 
-
 ## 方案一：使用 UI 组件快速集成
 
 `tuikit-atomicx-vue3` 提供了两个核心组件：
@@ -35,13 +30,12 @@
 
 - [**MessageInput**](https://github.com/Tencent-RTC/TUIKit_Vue3/tree/main/packages/tuikit-atomicx-vue3/src/components/MessageInput)**：** 消息输入组件，支持文本、表情、图片、文件发送，并可根据禁言状态自动禁用。
 
-
 ### 步骤1：数据初始化
 
 在用户加入房间成功后，需要调用 [setActiveConversation](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setActiveConversation) 接口初始化聊天数据。建议监听 [currentRoom](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#currentRoom) 的变化来自动处理。
 
 > **说明：**
-> 
+>
 > - `GROUP` 为固定前缀，`setActiveConversation` 参数必须为 ``GROUP${roomId}``，否则无法正常收发消息。
 > - `GROUP` 为 IM SDK 群组会话的固定前缀（参考 [IM 会话类型](https://web.sdk.qcloud.com/im/doc/zh-cn/Conversation.html)）。房间聊天基于 IM 群组实现，因此会话 ID 必须为 ``GROUP${roomId}`` 格式。
 
@@ -67,10 +61,10 @@ watch(() => currentRoom.value?.roomId, (roomId) => {
 在您的页面中，可以直接组合使用这两个组件。同时结合 [useRoomParticipantState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState) 获取当前用户的禁言状态，控制输入框的可用性。
 
 > **注意：**
-> 
+>
 
-> 所有 TUIKit 组件必须包裹在 [UIKitProvider](https://write.woa.com/document/197379797539790848) 内部，否则将无法获取上下文依赖，导致样式异常。
-> 
+> 所有 TUIKit 组件必须包裹在 UIKitProvider 内部，否则将无法获取上下文依赖，导致样式异常。
+>
 
 ``` typescript
 <template>
@@ -108,7 +102,7 @@ const { localParticipant } = useRoomParticipantState();
 const isMessageDisabled = computed(() => localParticipant.value?.isMessageDisabled);
 
 // 根据状态动态显示占位符提示
-const inputPlaceholder = computed(() => 
+const inputPlaceholder = computed(() =>
   isMessageDisabled.value ? '您已被禁言' : '请输入消息...'
 );
 </script>
@@ -151,18 +145,17 @@ const openChatWindow = () => {
 本节主要介绍如何通过 atomicx-core SDK API [useMessageListState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageListState) 和 [useMessageInputState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageInputState) 接口来实现自定义的聊天界面。
 
 > **注意：**
-> 
+>
 
 > `MessageInputState` 默认支持与 `@tiptap/vue-3` 编辑器集成。如果您仅需要简单的文本输入框（例如 `<input>` 或 `<textarea>`），请**忽略**`setEditorInstance`、`setContent` 等与编辑器实例绑定的 API，直接使用 `updateRawValue` 和 `sendMessage` 即可。
-> 
-
+>
 
 #### 步骤1：数据初始化
 
 在用户加入房间成功后，需要调用 [setActiveConversation](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setActiveConversation) 接口初始化聊天数据。建议监听 [currentRoom](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#currentRoom) 的变化来自动处理。
 
 > **说明：**
-> 
+>
 > - `GROUP` 为固定前缀，`setActiveConversation` 参数必须为 ``GROUP${roomId}``，否则无法正常收发消息。
 > - 在房间切换或退房时，建议重置或清空活跃会话，避免消息错发至错误会话。
 
@@ -189,7 +182,7 @@ watch(() => currentRoom.value?.roomId, (roomId) => {
 ``` typescript
 import { useMessageListState } from 'tuikit-atomicx-vue3/chat';
 
-const { 
+const {
   messageList,      // 响应式消息列表
   loadMoreOlderMessage, // 加载更多历史消息方法
   hasMoreOlderMessage,   // 是否还有更多历史消息
@@ -207,7 +200,7 @@ const {
 ``` typescript
 import { useMessageInputState } from 'tuikit-atomicx-vue3/chat';
 
-const { 
+const {
   inputRawValue,  // 响应式数据：当前输入内容
   updateRawValue, // 方法：更新输入内容（会自动触发"对方正在输入"状态）
   sendMessage     // 方法：发送消息
@@ -216,17 +209,17 @@ const {
 const handleSend = async () => {
   // 校验非空
   if (!inputRawValue.value) return;
-  
+
   try {
     // 1. 发送消息
     // 方式 A：发送当前 inputRawValue 的内容
     await sendMessage();
-    
+
     // 方式 B：直接发送指定文本（不依赖 inputRawValue）
     // await sendMessage('Hello World');
 
     console.log('发送成功');
-    
+
     // 2. 发送成功后清空输入框
     // 关键点：非富文本模式下，务必使用 updateRawValue('') 清空
     // 请勿使用 setContent('')，该方法仅在绑定了 editor 实例后生效
@@ -237,10 +230,10 @@ const handleSend = async () => {
 };
 
 // 示例：绑定原生输入框
-// <input 
-//   :value="inputRawValue" 
-//   @input="(e) => updateRawValue(e.target.value)" 
-//   @keyup.enter="handleSend" 
+// <input
+//   :value="inputRawValue"
+//   @input="(e) => updateRawValue(e.target.value)"
+//   @keyup.enter="handleSend"
 // />
 ```
 
@@ -249,15 +242,15 @@ const handleSend = async () => {
 通过 [loadMoreOlderMessage](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageListState) 方法分页拉取历史消息。通常在滚动到列表顶部时触发。
 
 > **注意：**
-> 
+>
 
 > 在加载历史消息后，通常需要手动调整滚动条位置，以保持当前浏览视角不发生跳变。
-> 
+>
 
 ``` typescript
 import { useMessageListState } from 'tuikit-atomicx-vue3/chat';
 
-const { 
+const {
   hasMoreOlderMessage,
   loadMoreOlderMessage
 } = useMessageListState();
@@ -266,9 +259,9 @@ const loadHistory = async () => {
   if (hasMoreOlderMessage.value) {
     // 记录加载前的滚动高度
     // const previousHeight = scrollContainer.value.scrollHeight;
-    
+
     await loadMoreOlderMessage();
-    
+
     // DOM 更新后恢复滚动位置
     // nextTick(() => {
     //   const currentHeight = scrollContainer.value.scrollHeight;
@@ -282,7 +275,7 @@ const loadHistory = async () => {
 
 如果您需要已读回执功能，可以使用 [setEnableReadReceipt](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#setEnableReadReceipt)。
 ``` typescript
-const { 
+const {
   setEnableReadReceipt, // 开启/关闭已读回执
 } = useMessageListState();
 
@@ -293,45 +286,36 @@ setEnableReadReceipt(true);
 ## 开发注意事项
 - **禁言状态同步**
 
-
    `localParticipant.isMessageDisabled` 是由房间管理员控制的。当管理员开启“全员禁言”或单独禁言某用户时，该属性会自动更新。请务必将此属性绑定到输入框的 `disabled` 状态上，以在前端层面限制用户发言。
 
 - **会话切换时机**
 
-
    确保 `setActiveConversation` 在进房成功后且 `roomId` 有值时调用。如果在进房前调用，可能会因为 SDK 尚未初始化完毕或未登录而失败。
 
 - **容器布局要求（重要）**
 
-
    消息列表组件内部处理了滚动逻辑，因此**父容器必须有固定的高度**（例如 `height: 100%` 或具体像素值）并设置 `overflow: hidden`，否则会导致列表无限拉长、无法滚动。
 
 - **消息类型处理**
 
-
    `messageList` 中包含多种类型的消息（文本、图片、文件等），自定义渲染时需根据 `msg.type` 进行区分处理。
 
 - **输入状态管理**
 
-
    使用 `updateRawValue` 更新输入内容会自动触发 "对方正在输入" 的状态通知（如果支持）。如果仅使用 `inputRawValue.value = 'xxx'` 可能不会触发该状态。
 
 - **历史消息滚动维持**
 
-
    在自定义开发中，调用 `loadMoreOlderMessage` 加载历史消息后，DOM 高度会增加。为了防止视图跳动，需要在加载前记录 `scrollHeight`，加载后（`nextTick`）计算高度差并调整 `scrollTop`。
 
 - **新消息滚动策略**
 
-
    建议实现“智能滚动”逻辑：当用户位于列表底部时，收到新消息自动滚动到底部；当用户正在浏览历史消息时，保持当前位置不动，并显示“有新消息”的提示气泡。
 
 - **会话 ID 格式要求**
 
-
    调用 `setActiveConversation` 时，必须使用 ``GROUP${roomId}`` 格式（GROUP 为固定前缀）。这是 IM SDK 群组会话的标准格式，不可自定义或省略前缀，否则无法正常收发消息。
 
-
 ## 常见问题
 
 **切到群组会话失败或消息列表无内容？**
@@ -376,52 +360,10 @@ await sendMessage([{ type: 'image', file }]);
 腾讯云在 GitHub 上提供了示例项目 [atomicx-vite-vue3-ts](https://github.com/Tencent-RTC/TUIRoomKit/tree/main/Web/example/atomicx-vite-vue3-ts) ，您可以参考以实现完整的 RoomKit 功能。
 
 ## API 文档
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**State/Component**</td>
-
-<td rowspan="1" colSpan="1" >**功能描述**</td>
-
-<td rowspan="1" colSpan="1" >**API 文档**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**useRoomState**</td>
-
-<td rowspan="1" colSpan="1" >房间状态管理（创建、加入、预约等）</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomState)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**useRoomParticipantState**</td>
-
-<td rowspan="1" colSpan="1" >房间参与者管理（成员列表、权限控制）</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**useConversationListState**</td>
-
-<td rowspan="1" colSpan="1" >会话列表管理</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-ConversationListState)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**useMessageListState**</td>
-
-<td rowspan="1" colSpan="1" >消息列表管理</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageListState)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**useMessageInputState**</td>
-
-<td rowspan="1" colSpan="1" >消息输入管理</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageInputState)</td>
-</tr>
-</table>
+| **State/Component** | **功能描述** | **API 文档** |
+| --- | --- | --- |
+| **useRoomState** | 房间状态管理（创建、加入、预约等） | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomState) |
+| **useRoomParticipantState** | 房间参与者管理（成员列表、权限控制） | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState) |
+| **useConversationListState** | 会话列表管理 | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-ConversationListState) |
+| **useMessageListState** | 消息列表管理 | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageListState) |
+| **useMessageInputState** | 消息输入管理 | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-MessageInputState) |

package/resource/doc/roomkit/vue/features/room-participant-state.md

@@ -9,20 +9,15 @@
 
 - **分级管理：**支持对房主、管理员及普通成员实现差异化的权限策略。
 
-
 ## 前提条件
-- 用户已经通过 [useLoginState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-LoginState) 完成登录鉴权，请参考 [接入概览](https://write.woa.com/document/197379797539790848)。
-
-- 用户已经通过 [useRoomState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomState) 进入房间，请参考 [房间管理](https://write.woa.com/document/197379861957083136)。
+- 用户已经通过 [useLoginState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-LoginState) 完成登录鉴权，请参考 接入概览。
 
+- 用户已经通过 [useRoomState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomState) 进入房间，请参考 房间管理。
 
 ## 集成成员管理组件
 
 如果您需要快速构建成员列表界面，推荐直接使用 `RoomParticipantList` 组件。`RoomParticipantList` 是一个开箱即用的参会者列表组件，内置了完整的成员管理 UI 和交互。
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027337918/9407bc54dbe911f0a4f35254007c27c5.png)
-
-
 集成 `RoomParticipantList` 组件示例代码：
 ``` typescript
 <template>
@@ -43,11 +38,11 @@
 <script setup lang="ts">
 import { ref } from 'vue';
 import { IconClose } from '@tencentcloud/uikit-base-component-vue3';
-import { 
+import {
   RoomView,
   RoomParticipantList,
   useRoomState,
-  useRoomParticipantState 
+  useRoomParticipantState
 } from 'tuikit-atomicx-vue3/room';
 
 const { currentRoom } = useRoomState();
@@ -86,11 +81,10 @@ const { participantList } = useRoomParticipantState();
 ```
 
 > **说明：**
-> 
+>
 > - `RoomParticipantList` 会自动占满父容器的高度和宽度，请确保其父容器具备明确的尺寸。
 > - 使用 `RoomParticipantList` 组件请确保在 `App.vue` 中配置全局 `UIKitProvider`，具体请参考 [配置 App.vue](https://cloud.tencent.com/document/product/647/81962#ce98ee15-b0cb-43af-81da-70f51231430e)。
 
-
 ## 实现成员管理功能
 
 如果您需要自定义成员列表 UI 或在特定业务中触发管理行为，请使用 [useRoomParticipantState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState)。
@@ -118,11 +112,10 @@ const handleLoadMore = async () => {
 ```
 
 > **说明：**
-> 
+>
 
 > `getParticipantList` 接口拉取成功的数据会自动维护在 `participantList` 中，UI 只需要渲染 `participantList` 的数据即可。
-> 
-
+>
 
 ### 步骤2：渲染参会者信息
 
@@ -137,15 +130,15 @@ const handleLoadMore = async () => {
       </button>
     </div>
     <div class="list-content">
-      <div 
-        v-for="participant in participantList" 
+      <div
+        v-for="participant in participantList"
         :key="participant.userId"
         class="participant-item"
       >
         <!-- 头像 -->
-        <Avatar 
-          :user-id="participant.userId" 
-          :avatar-url="participant.avatarUrl" 
+        <Avatar
+          :user-id="participant.userId"
+          :avatar-url="participant.avatarUrl"
         />
 
         <!-- 用户信息 -->
@@ -153,14 +146,14 @@ const handleLoadMore = async () => {
           <div class="user-name">
             <span>{{ participant.userName }}</span>
             <span v-if="participant.userId === localParticipant.userId" class="badge">我</span>
-            <span 
-              v-if="participant.role === RoomParticipantRole.Owner" 
+            <span
+              v-if="participant.role === RoomParticipantRole.Owner"
               class="role-badge owner"
             >
               房主
             </span>
-            <span 
-              v-else-if="participant.role === RoomParticipantRole.Admin" 
+            <span
+              v-else-if="participant.role === RoomParticipantRole.Admin"
               class="role-badge admin"
             >
               管理员
@@ -170,15 +163,15 @@ const handleLoadMore = async () => {
 
         <!-- 设备状态 -->
         <div class="device-status">
-          <IconMicOn 
+          <IconMicOn
             size="20"
-            v-if="participant.microphoneStatus === DeviceStatus.On" 
+            v-if="participant.microphoneStatus === DeviceStatus.On"
             class="icon-on"
           />
           <IconMicOff size="20" v-else class="icon-off" />
           <IconCameraOn
             size="20"
-            v-if="participant.cameraStatus === DeviceStatus.On" 
+            v-if="participant.cameraStatus === DeviceStatus.On"
             class="icon-on"
           />
           <IconCameraOff size="20" v-else class="icon-off" />
@@ -191,15 +184,15 @@ const handleLoadMore = async () => {
 <script setup lang="ts">
 import { computed } from 'vue';
 import { IconRefresh, IconMicOn, IconMicOff, IconCameraOn, IconCameraOff } from '@tencentcloud/uikit-base-component-vue3';
-import { 
+import {
   useRoomParticipantState,
   Avatar,
   RoomParticipantRole,
   DeviceStatus
 } from 'tuikit-atomicx-vue3/room';
 
-const { 
-  localParticipant, 
+const {
+  localParticipant,
   participantList,
   getParticipantList,
   transferOwner
@@ -231,11 +224,11 @@ const handleRefresh = async () => {
 <script setup lang="ts">
 import { computed } from 'vue';
 import { IconRefresh, IconMicOn, IconMicOff, IconCameraOn, IconCameraOff } from '@tencentcloud/uikit-base-component-vue3';
-import { 
+import {
   useRoomParticipantState,
 } from 'tuikit-atomicx-vue3/room';
 
-const { 
+const {
   updateParticipantMetaData,
 } = useRoomParticipantState();
 
@@ -362,27 +355,12 @@ await kickParticipant({ userId });
 
 ### 步骤9：邀请其他人加入房间
 
-实际业务中，您可能需要向未进房的用户发起呼叫邀请。Atomicx 提供了完整的呼叫系统支持，请查看 [会中呼叫](https://write.woa.com/document/197380078005506048)。
+实际业务中，您可能需要向未进房的用户发起呼叫邀请。Atomicx 提供了完整的呼叫系统支持，请查看 会中呼叫。
 
 ## API 文档
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**State/Component**</td>
-
-<td rowspan="1" colSpan="1" >**功能描述**</td>
-
-<td rowspan="1" colSpan="1" >**API 文档**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**useRoomParticipantState**</td>
-
-<td rowspan="1" colSpan="1" >包含房间内用户数据，用户管理接口。</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState)</td>
-</tr>
-</table>
-
+| **State/Component** | **功能描述** | **API 文档** |
+| --- | --- | --- |
+| **useRoomParticipantState** | 包含房间内用户数据，用户管理接口。 | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState) |
 
 ## 开发建议
 

package/resource/doc/roomkit/vue/features/room-state.md

@@ -1,8 +1,5 @@
 本篇文档将详细指导您如何使用 Atomicx 的 [useRoomState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomState) 管理房间的完整生命周期，包括创建、加入、离开以及结束房间，以及处理关键的房间状态通知。以下时序图演示了房间从创建到销毁的主要流程。
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027337918/b5d730a6dfdc11f08775525400bf7822.png)
-
-
 ## 功能介绍
 
 [useRoomState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomState) 是 Atomicx 方案中负责房间管理的核心 Hook。它封装了复杂的底层信令流程，开发者可以通过简单的响应式数据和方法调用来驱动房间状态。
@@ -12,10 +9,9 @@
 
 - **权限分明的退出机制：**针对不同角色提供了清晰的操作边界。普通成员可以使用 [leaveRoom](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#leaveRoom) 退出；而房主（主持人）则拥有 [endRoom](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#endRoom) 权限，可以一键结束房间并销毁房间资源。
 
-
 ## **前提条件**
 
-用户已经通过 [useLoginState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-LoginState) 完成登录鉴权，请参考 [接入概览](https://write.woa.com/document/197379797539790848)。
+用户已经通过 [useLoginState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-LoginState) 完成登录鉴权，请参考 接入概览。
 
 ## 实现房间管理
 
@@ -23,12 +19,12 @@
 ``` typescript
 import { useRoomState } from 'tuikit-atomicx-vue3/room';
 
-const { 
-  createAndJoinRoom, 
-  joinRoom, 
-  leaveRoom, 
+const {
+  createAndJoinRoom,
+  joinRoom,
+  leaveRoom,
   endRoom,
-  currentRoom 
+  currentRoom
 } = useRoomState();
 ```
 
@@ -37,17 +33,17 @@ const {
 创建房间（房主）：使用 [createAndJoinRoom](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#createAndJoinRoom)，调用成功后该用户将自动获得房主权限。
 
 > **注意：**
-> 
+>
 
 > 创建房间时指定的 roomId 建议由业务后台生成并下发，以确保房间 Id 在全局应用中的唯一性与稳定性。
-> 
+>
 
 - **示例一：用户创建房间**
 
    ``` typescript
    import { useRoomState } from 'tuikit-atomicx-vue3/room';
    const { createAndJoinRoom } = useRoomState();
-   
+
    await createAndJoinRoom({
      roomId: 'YOUR_ROOM_ID',    // 指定房间 Id，由业务后台生成
    })
@@ -57,7 +53,7 @@ const {
    ``` typescript
    import { useRoomState } from 'tuikit-atomicx-vue3/room';
    const { createAndJoinRoom } = useRoomState();
-   
+
    await createAndJoinRoom({
      roomId: 'YOUR_ROOM_ID',    // 指定房间 Id，由业务后台生成
      options: {
@@ -70,7 +66,7 @@ const {
    ``` typescript
    import { useRoomState } from 'tuikit-atomicx-vue3/room';
    const { createAndJoinRoom } = useRoomState();
-   
+
    await createAndJoinRoom({
      roomId: 'YOUR_ROOM_ID',    // 指定房间 Id，由业务后台生成
      options: {
@@ -78,20 +74,20 @@ const {
        password: '123456',
      }
    })
-   ```   
+   ```
 
    > **说明：**
-   > 
+   >
 
    > 创建者在调用 [createAndJoinRoom](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#createAndJoinRoom) 时会自动加入房间，无需输入密码。
-   > 
+   >
 
 - **示例四：用户创建房间并配置成员管理信息**
 
    ``` typescript
    import { useRoomState } from 'tuikit-atomicx-vue3/room';
    const { createAndJoinRoom } = useRoomState();
-   
+
    await createAndJoinRoom({
      roomId: 'YOUR_ROOM_ID',    // 指定房间 Id，由业务后台生成
      options: {
@@ -103,14 +99,13 @@ const {
        isAllMessageDisabled: true,      // 开启全员禁止发会中消息
      }
    })
-   ```   
+   ```
 
    > **说明：**
-   > 
-
-   > 成员管理配置信息仅对普通成员生效，房主和管理员不受限制。如需在房间创建后修改成员管理配置或单独管理成员权限，请参考 [成员管理](https://write.woa.com/document/197380064613830656)。
-   > 
+   >
 
+   > 成员管理配置信息仅对普通成员生效，房主和管理员不受限制。如需在房间创建后修改成员管理配置或单独管理成员权限，请参考 成员管理。
+   >
 
 ### 步骤3：用户加入已有房间
 
@@ -120,7 +115,7 @@ const {
    ``` typescript
    import { useRoomState } from 'tuikit-atomicx-vue3/room';
    const { joinRoom } = useRoomState();
-   
+
    await joinRoom({
      roomId: 'YOUR_ROOM_ID',    // 指定房间 Id，由业务后台生成
    })
@@ -130,7 +125,7 @@ const {
    ``` typescript
    import { useRoomState } from 'tuikit-atomicx-vue3/room';
    const { joinRoom } = useRoomState();
-   
+
    await joinRoom({
      roomId: 'YOUR_ROOM_ID',    // 指定房间 Id，由业务后台生成
      password: '123456',
@@ -154,11 +149,10 @@ await updateRoomInfo({
 ```
 
 > **说明：**
-> 
+>
 
 > 房主必须在房间内才能调用 [updateRoomInfo](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#updateRoomInfo)。如果房主已离开房间，需要重新加入后才能更新房间信息。
-> 
-
+>
 
 ### 步骤5：离开房间
 
@@ -181,11 +175,10 @@ await endRoom();
 ```
 
 > **说明：**
-> 
+>
 > - 如果房主离开房间但未调用 [endRoom](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#endRoom)，房间将继续存在，直到满足自动回收条件（连续 6 小时无用户）。
 > - 房主可以通过 [transferOwner](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#transferOwner) 接口将房主身份转移给其他用户。
 
-
 ### 步骤7：异常退出处理
 
 #### 处理房间被销毁事件
@@ -268,9 +261,7 @@ Atomicx 提供了完整的预约房间能力，包括：
 
 - **入会提醒：**支持开始前的自动提醒逻辑。
 
-
-   如果您需要实现上述更复杂的商业多人音视频房间管理逻辑，请参考：[预定房间](https://write.woa.com/document/197380092150673408)。
-
+   如果您需要实现上述更复杂的商业多人音视频房间管理逻辑，请参考：预定房间。
 
 ## 常见问题
 
@@ -284,8 +275,6 @@ Atomicx 提供了完整的预约房间能力，包括：
 
 ### 一个用户可以同时加入多个房间吗？
 
-Atomicx 提供的 `useRoomState` 为单例接口，仅支持用户同时加入一个房间。若您需要支持一个用户同时加入多个房间，欢迎 [联系我们](https://cloud.tencent.com/document/product/647/19906) 提交反馈。
-
 ### 最多支持多少人同时加入房间？
 
 房间内用户数量上限和您的套餐包相关，具体请查看 [TUIRoomKit 套餐包说明](https://cloud.tencent.com/document/product/647/104842#function)。