@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.1

package/resource/{doc/roomkit/android/features → knowledge/roomkit/core-sdk/android}/room-participant-state.md

@@ -1,56 +1,27 @@
 `RoomParticipantStore` 是 `AtomicXCore` 中专用于房间参与者管理的模块。该模块为多人房间场景提供了核心能力，支持构建完整的成员管理体系。
 
-## 房间模式说明
-
-在开始使用成员管理功能之前，需要了解 `AtomicXCore` 中房间模块支持的两种房间模式，不同模式下的成员管理功能有所区别：
-| **标准房间模式（Standard Room）** | **网络研讨会房间模式（Webinar Room）** |
-| --- | --- |
-| - **适用场景：**小型会议、团队协作、朋友聊天等。<br>- **成员特点：**所有成员都是参与者，可以自由开启/关闭音视频设备。<br>- **管理特点：**扁平化管理，房主可设置管理员进行协助管理。 | - **适用场景**：网络研讨会、在线培训等。<br>- **成员特点**：<br>- **嘉宾（Participants）**：可以开启音视频设备，参与互动。<br>- **观众（Audience）**：只能观看，无法开启音视频设备。<br>- **管理特点**：分层管理，支持观众与嘉宾身份转换。 |
-
 ## 核心功能
-- **获取参与者列表**：获取并展示当前房间内所有参与者信息（网络研讨会房间模式下，获取到的是嘉宾列表，嘉宾可以开启麦克风与其他嘉宾互动）。
-
-- **获取观众列表：**网络研讨会房间模式下，获取观众列表信息。
-
-- **搜索房间内成员：**搜索所在房间内的指定用户。
+- **获取参与者列表**：获取并展示当前房间内所有参与者信息。
 
-- **将观众提升为嘉宾：**网络研讨会房间模式下，可以将观众提升为嘉宾，提升为嘉宾的用户可以开启麦克风与房间内其他的嘉宾互动。
-
-- **将嘉宾降级为观众：**网络研讨会房间模式下，可以将嘉宾降级为观众， 降级为观众的用户无法与房间内的嘉宾进行语音互动。
-
-- **转移房主身份**：房主可以将房主身份转移给房间内任意一名参与者。
+- **房主转移**：房主可以将房主身份转移给房间内任意一名参与者。
 
 - **设置/撤销管理员**：房主可以设置参与者为管理员，同时也可撤销房间内的管理员。
 
-- **将参与者移出房间**：房主或者管理员可以将房间内任意一名参与者移出房间。
+- **将参与者移除房间**：房主或者管理员可以将房间内任意一名参与者移出房间。
 
-- **参与者信息更新**：房间内所有人都可以更新自己的参与者信息。
+- **更新参与者信息**：房间内所有人都可以更新自己的参与者信息。
 
-- **音视频设备管理**：支持申请/邀请打开摄像头、麦克风，关闭远端摄像头、麦克风，以及房主和管理员设置全体静音，全体禁画功能。
-
-## 功能对比
-| **功能** | **标准房间模式** | **网络研讨会房间模式** |
-| --- | --- | --- |
-| 获取参与者列表 | 获取所有房间成员 | 获取嘉宾列表 |
-| 获取观众列表 | 不适用 | 获取观众列表 |
-| 搜索房间内成员 | 支持 | 支持 |
-| 将观众提升为嘉宾 | 不适用 | 支持 |
-| 将嘉宾降级为观众 | 不适用 | 支持 |
-| 转移房主身份 | 支持 | 支持 |
-| 设置/撤销管理员 | 支持 | 支持 |
-| 移出房间 | 支持 | 支持 |
-| 更新参与者信息 | 支持 | 支持 |
-| 音视频设备管理 | 支持 | 支持 |
+- **音视频设备管理**：支持申请/邀请打开摄像头、麦克风，关闭远端摄像头、麦克风，以及房主和管理员设置全体静音，全体禁用摄像头功能。
 
 ## 核心概念
 
 在开始集成之前，需要通过下表了解一下`RoomParticipantStore`相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| [RoomParticipant](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant/index.html) | `data class` | 代表参与者的核心数据模型，封装了参与者的完整信息和状态管理能力。<br>**标准房间模式：**代表房间内的所有成员。<br>**网络研讨会房间模式：**代表嘉宾，可以开启/关闭麦克风。<br>核心功能包括：参与者基本信息管理（用户 ID 、用户名称、用户头像、房间内角色身份）、参与者设备状态管理（麦克风状态，摄像头状态，屏幕分享状态，消息状态）。 |
-| [RoomParticipantState](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-state/index.html) | `data class` | 代表参与者状态管理的核心数据结构，负责维护房间内与参与者相关状态信息。<br>核心属性：<br>- `participantList`**标准房间模式**存储所有房间成员，**网络研讨会房间模式**存储嘉宾列表。<br>- `participantListCursor`**标准房间模式**代表房间内所有成员列表的分页游标，**网络研讨会房间模式**代表房间内嘉宾列表的分页游标。<br>- `localParticipant` 代表自身所在房间内的参与者信息。 |
-| [RoomParticipantListener](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-listener/index.html) | `abstract class` | 代表房间内和参与者相关的实时事件。主要事件分为三大类：参与者进退房事件、 参与者身份改变事件，参与者设备控制事件。 |
-| [RoomParticipantStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-store/index.html) | `abstract class` | 这是参与者控制相关的核心类。功能包含：控制房间内参与者音视频状态、执行参与者管理操作，并通过订阅其 `RoomParticipantListener` 来接收实时事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant/index.html">RoomParticipant</a> | <code>data class</code> | 代表参与者的核心数据模型，封装了参与者的完整信息和状态管理能力。<br>核心功能包括：参与者基本信息管理（用户 ID 、用户名称、用户头像、房间内角色身份）、参与者设备状态管理（麦克风状态，摄像头状态，屏幕分享状态，消息状态）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-state/index.html">RoomParticipantState</a> | <code>data class</code> | 代表参与者状态管理的核心数据结构，负责维护房间内与参与者相关状态信息。<br>核心属性：<br>- <code>participantList</code> 存储了当前所在房间的所有参与者信息集合。<br>- <code>participantListCursor</code> 则代表房间内参与者列表的分页快照。<br>- <code>localParticipant</code> 则代表自身所在房间内的参与者信息。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-listener/index.html">RoomParticipantListener</a> | <code>abstract class</code> | 代表房间内和参与者相关的实时事件。主要事件分为三大类：参与者进退房事件、 参与者身份改变事件，参与者设备控制事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-store/index.html">RoomParticipantStore</a> | <code>abstract class</code> | 这是参与者控制相关的核心类。功能包含：控制房间内参与者音视频状态、执行参与者管理操作，并通过订阅其 <code>RoomParticipantListener</code> 来接收实时事件。 |
 
 ## 实现步骤
 
@@ -89,38 +60,7 @@ fun getParticipantList() {
 }
 ```
 
-### 步骤3：获取观众列表
-
-在进入的房间类型为`WEBINAR`类型时，可以通过调用`RoomParticipantStore`的`getAudienceList`接口获取房间内的观众列表。
-``` java
-import android.util.Log
-import io.trtc.tuikit.atomicxcore.api.ListResultCompletionHandler
-import io.trtc.tuikit.atomicxcore.api.room.RoomParticipantStore
-import io.trtc.tuikit.atomicxcore.api.room.RoomUser
-
-fun getAudienceList() {
-    // 前提：需要先完成进房操作, 并且进房时 roomType 设置为 WEBINAR 类型。
-    // 1. 业务逻辑说明
-    // 通过进房的roomID创建RoomParticipantStore实例
-    val participantStore = RoomParticipantStore.create(roomID = "your_room_id")
-
-    // 2. 首次获取观众列表（从头开始）
-    // 支持分页加载，可以通过 cursor 参数实现增量获取
-    val initialCursor: String? = null  // null 表示从第一页开始获取
-
-    participantStore.getAudienceList(cursor = initialCursor, completion = object : ListResultCompletionHandler<RoomUser> {
-        override fun onSuccess(result: List<RoomUser>, cursor: String) {
-            Log.d("Test", "获取观众列表成功，观众数量: ${result.size}")
-        }
-
-        override fun onFailure(code: Int, desc: String) {
-            Log.e("Test", "获取观众列表失败 [错误码: $code]: $desc")
-        }
-    })
-}
-```
-
-### 步骤4：搜索房间内成员
+### 步骤3：搜索房间内成员
 
 进入房间成功后，可以通过调用`RoomParticipantStore`的`searchUsers`接口搜索房间内的成员。
 ``` java
@@ -150,118 +90,7 @@ fun searchUsers() {
 }
 ```
 
-### 步骤5：将**观众提升为嘉宾**
-
-网络研讨会房间模式下，作为房主或管理员，调用`RoomParticipantStore`的`promoteAudienceToParticipant`接口可以将房间内的观众提升成为嘉宾。
-``` java
-import android.util.Log
-import io.trtc.tuikit.atomicxcore.api.CompletionHandler
-import io.trtc.tuikit.atomicxcore.api.room.RoomParticipantStore
-
-fun promoteAudienceToParticipant(userID: String) {
-    // 前提：需要先完成进房操作。
-    // 1. 业务逻辑说明
-    // 通过进房的 roomID 创建 RoomParticipantStore 实例
-    val participantStore = RoomParticipantStore.create(roomID = "your_room_id")
-
-    // 2. 调用 RoomParticipantStore 提升观众为嘉宾接口
-    // 注意：只有房主或管理员才有权限执行此操作。
-    participantStore.promoteAudienceToParticipant(userID = userID, completion = object : CompletionHandler {
-        override fun onSuccess() {
-            Log.d("Test", "提升为嘉宾成功")
-        }
-
-        override fun onFailure(code: Int, desc: String) {
-            Log.e("Test", "提升为嘉宾失败 [错误码: $code]: $desc")
-        }
-    })
-}
-```
-
-作为房间内成员订阅`RoomParticipantStore`的`RoomParticipantListener`中的`onAudiencePromotedToParticipant`事件，被动接收观众提升为嘉宾的变化通知。
-``` java
-import android.util.Log
-import io.trtc.tuikit.atomicxcore.api.room.RoomParticipantListener
-import io.trtc.tuikit.atomicxcore.api.room.RoomParticipantStore
-import io.trtc.tuikit.atomicxcore.api.room.RoomUser
-
-fun subscribeParticipantEvent() {
-    // 1. 业务逻辑说明
-    // 前提：需要先完成进房操作,通过进房的 roomID 创建 RoomParticipantStore 实例
-    val participantStore = RoomParticipantStore.create(roomID = "your_room_id")
-
-    // 2. 订阅参与者事件
-    // 通过添加 RoomParticipantListener 监听所有参与者相关的事件
-    val listener = object : RoomParticipantListener() {
-        override fun onAudiencePromotedToParticipant(userInfo: RoomUser) {
-            Log.d("Test", "观众被提升为嘉宾，userInfo: $userInfo")
-        }
-    }
-
-    participantStore.addRoomParticipantListener(listener)
-
-    // 注意：在不需要监听时，记得移除监听器
-    // participantStore.removeRoomParticipantListener(listener)
-}
-
-```
-
-### 步骤6：将**嘉宾降级为观众**
-
-网络研讨会房间模式下，作为房主或管理员，调用`RoomParticipantStore`的`demoteParticipantToAudience`接口可以将房间内的嘉宾降级成为观众。
-``` java
-import android.util.Log
-import io.trtc.tuikit.atomicxcore.api.CompletionHandler
-import io.trtc.tuikit.atomicxcore.api.room.RoomParticipantStore
-
-fun demoteParticipantToAudience(userID: String) {
-    // 前提：需要先完成进房操作。
-    // 1. 业务逻辑说明
-    // 通过进房的 roomID 创建 RoomParticipantStore 实例
-    val participantStore = RoomParticipantStore.create(roomID = "your_room_id")
-
-    // 2. 调用 RoomParticipantStore 降级嘉宾为观众接口
-    // 注意：只有房主或管理员才有权限执行此操作。
-    participantStore.demoteParticipantToAudience(userID = userID, completion = object : CompletionHandler {
-        override fun onSuccess() {
-            Log.d("Test", "降级为观众成功")
-        }
-
-        override fun onFailure(code: Int, desc: String) {
-            Log.e("Test", "降级为观众失败 [错误码: $code]: $desc")
-        }
-    })
-}
-```
-
-作为房间内成员订阅`RoomParticipantStore`的`RoomParticipantListener`中的`onParticipantDemotedToAudience`事件，被动接收嘉宾降级为观众的变化通知。
-``` java
-import android.util.Log
-import io.trtc.tuikit.atomicxcore.api.room.RoomParticipantListener
-import io.trtc.tuikit.atomicxcore.api.room.RoomParticipantStore
-import io.trtc.tuikit.atomicxcore.api.room.RoomUser
-
-fun subscribeParticipantEvent() {
-    // 1. 业务逻辑说明
-    // 前提：需要先完成进房操作,通过进房的roomID创建RoomParticipantStore实例
-    val participantStore = RoomParticipantStore.create(roomID = "your_room_id")
-
-    // 2. 订阅参与者事件
-    // 通过添加 RoomParticipantListener 监听所有参与者相关的事件
-    val listener = object : RoomParticipantListener() {
-        override fun onParticipantDemotedToAudience(userInfo: RoomUser) {
-            Log.d("Test", "嘉宾被降级为观众，userInfo: $userInfo")
-        }
-    }
-
-    participantStore.addRoomParticipantListener(listener)
-
-    // 注意：在不需要监听时，记得移除监听器
-    // participantStore.removeRoomParticipantListener(listener)
-}
-```
-
-### 步骤7：转移房主身份
+### 步骤4：转移房主身份
 
 作为房主，调用 `RoomParticipantStore` 的 `transferOwner` 接口可以将房主身份直接转移给房间内任意一位参与者，转移后原房主身份将变为普通参与者，一个房间内有且仅有一名房主。
 ``` java
@@ -314,7 +143,7 @@ private fun subscribeParticipantEvent() {
 }
 ```
 
-### 步骤8：设置/撤销管理员
+### 步骤5：设置/撤销管理员
 
 作为房主，调用 `RoomParticipantStore` 的 `setAdmin` 接口，指定房间内任意一位用户为管理员，也可以将管理员身份撤销。
 ``` java
@@ -383,7 +212,7 @@ private fun subscribeParticipantEvents() {
 }
 ```
 
-### 步骤9：**将参与者移出房间**
+### 步骤6：**将参与者移出房间**
 
 作为房主和管理员，调用 `RoomParticipantStore` 的 `kickUser` 可以将房间内参与者移出房间。
 ``` java
@@ -439,7 +268,7 @@ private fun subscribeParticipantEvents() {
 }
 ```
 
-### 步骤10：更新参与者信息
+### 步骤7：更新参与者信息
 
 在加入房间后，调用 `RoomParticipantStore` 的 `updateParticipantNameCard`、 `updateParticipantMetaData` 更新您在房间里的参与者信息，包含：参与者名片信息，参与者自定义信息。
 ``` java
@@ -489,7 +318,7 @@ fun updateParticipantMetaData(userID: String, metaData: HashMap<String, ByteArra
 }
 ```
 
-### 步骤11：邀请参与者打开其设备
+### 步骤8：邀请参与者打开其设备
 
 作为房主和管理员，调用 `RoomParticipantStore` 的 `inviteToOpenDevice` 接口，邀请房间内参与者打开摄像头，麦克风。
 ``` java
@@ -580,7 +409,7 @@ fun inviteUserToOpenDevice(userID: String, device: DeviceType, timeout: Int = 30
    }
    ```
 
-### 步骤12：关闭远端参与者设备
+### 步骤9：关闭远端参与者设备
 
 作为房主和管理员，调用`RoomParticipantStore`的`closeParticipantDevice`可以主动关闭远端参与者的摄像头，麦克风。
 ``` java
@@ -638,7 +467,7 @@ private fun subscribeParticipantEvents() {
 }
 ```
 
-### 步骤13：参与者申请打开自己的设备
+### 步骤10：参与者申请打开自己的设备
 
 作为参与者，调用`RoomParticipantStore`的`requestToOpenDevice`接口，可以在房间被房主或管理员设置全体静音，全体禁画的场景下，主动申请打开摄像头，麦克风。
 ``` java
@@ -729,7 +558,7 @@ fun requestToOpenDevice(device: DeviceType, timeout: Int = 30) {
    }
    ```
 
-### 步骤14：全体静音、全体禁画
+### 步骤11：全体静音、全体禁画
 
 作为房主和管理员，调用`RoomParticipantStore`的`disableAllDevices`接口设置全员静音与全员禁用摄像头。开启后，房间内参与者的音视频开启权限将被限制，无法自主打开麦克风或摄像头设备。
 ``` java
@@ -790,7 +619,7 @@ private fun subscribeParticipantEvents() {
 }
 ```
 
-### 步骤15：监听参与者事件
+### 步骤12：监听参与者事件
 
 订阅`RoomParticipantListener`参与者相关的被动事件。以订阅参与者加入房间、离开房间为例，示例代码如下：
 ``` java
@@ -845,6 +674,6 @@ private fun subscribeParticipantState() {
 ```
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API文档** |
+| <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API 文档</strong> |
 | --- | --- | --- |
-| **RoomParticipantStore** | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-store/index.html) |
+| <strong>RoomParticipantStore</strong> | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-store/index.html">API 文档</a> |

package/resource/{doc/roomkit/android/features → knowledge/roomkit/core-sdk/android}/room-state.md

@@ -16,12 +16,12 @@
 ## 核心概念
 
 在开始集成之前，需要通过下表了解一下 `RoomStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| [RoomInfo](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-info/index.html) | `data class` | 代表房间信息的核心数据模型，封装了房间的完整信息和状态管理能力。<br>核心功能包括：<br>- 房间基本信息管理（房间 ID、名称、创建者）。<br>- 实时状态跟踪（参与者数量、房间状态、创建时间）。<br>- 房间调度功能（预约时间、参会者列表、提醒设置）。<br>- 权限控制（密码保护、设备管控、消息管理）。 |
-| [RoomState](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-state/index.html) | `data class` | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- `scheduledRoomList`存储了当前账号下所有预约的房间列表信息。<br>- `scheduledRoomListCursor` 则代表预约房间列表的分页快照。<br>- `currentRoom`则代表当前所在房间的状态信息。 |
-| [RoomListener](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/index.html) | `abstract class` | 代表房间动态的实时事件。主要事件分为三大类：预约房间事件，房间结束事件，房间呼叫事件。 |
-| [RoomStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html) | `abstract class` | 这是与房间全生命周期相关的核心类。功能包含：获取预约房间列表快照、执行房间管理操作，并通过订阅其 `RoomListener` 来接收实时动态事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-info/index.html">RoomInfo</a> | <code>data class</code> | 代表房间信息的核心数据模型，封装了房间的完整信息和状态管理能力。<br>核心功能包括：<br>- 房间基本信息管理（房间 ID、名称、创建者）。<br>- 实时状态跟踪（参与者数量、房间状态、创建时间）。<br>- 房间调度功能（预约时间、参会者列表、提醒设置）。<br>- 权限控制（密码保护、设备管控、消息管理）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-state/index.html">RoomState</a> | <code>data class</code> | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- <code>scheduledRoomList</code>存储了当前账号下所有预约的房间列表信息。<br>- <code>scheduledRoomListCursor</code> 则代表预约房间列表的分页快照。<br>- <code>currentRoom</code>则代表当前所在房间的状态信息。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/index.html">RoomListener</a> | <code>abstract class</code> | 代表房间动态的实时事件。主要事件分为三大类：预约房间事件，房间结束事件，房间呼叫事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html">RoomStore</a> | <code>abstract class</code> | 这是与房间全生命周期相关的核心类。功能包含：获取预约房间列表快照、执行房间管理操作，并通过订阅其 <code>RoomListener</code> 来接收实时动态事件。 |
 
 ## 实现步骤
 
@@ -32,11 +32,11 @@
 ### 步骤2：**创建并加入房间**
 
 #### *实现*方式：
-1. **配置房间初始化参数：**初始化`CreateRoomOptions`设置房间名称，房间密码。
+1. **配置房间初始化参数：**初始化 `CreateRoomOptions` 设置置房间名称，房间密码。
 
 2. **房间权限预设：**设置房间内全场成员权限，例如全体静音，全体禁画等。
 
-3. **创建并加入房间：**调用`RoomStore`的`createAndJoinRoom`接口执行核心操作。
+3. **创建并加入房间：**调用 `RoomStore` 的 `createAndJoinRoom` 接口执行核心操作。
 
 ##### 示例代码：
 ``` java
@@ -79,20 +79,20 @@ fun createAndJoinRoom() {
 ##### createAndJoinRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>-  建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `roomType` | `RoomType` | 是 | 房间类型<br>- `STANDARD`：标准房间（默认值）。<br>- `WEBINAR`：大型研讨会房间。 |
-| `options` | `CreateRoomOptions` | 是 | - 创建房间配置对象。<br>- 详细用法请参考：CreateRoomOptions 结构体详细说明 |
-| `completion` | `CompletionHandler` | 否 | 操作完成回调，用于返回创建和加入房间的结果。若创建失败则会返回错误码和错误信息。 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>-  建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>roomType</code> | <code>RoomType</code> | 是 | 房间类型<br>- <code>STANDARD</code>：标准房间（默认值）。<br>- <code>WEBINAR</code>：大型研讨会房间。<br>多人会议场景这里填写 <code>STANDARD</code> 房间类型。 |
+| <code>options</code> | <code>CreateRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：CreateRoomOptions 结构体详细说明 |
+| <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回创建和加入房间的结果。若创建失败则会返回错误码和错误信息。 |
 
 ##### CreateRoomOptions 结构体详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomName` | `String` | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
-| `password` | `String` | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
-| `isAllMicrophoneDisabled` | `Boolean` | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。<br>- true : 禁止。<br>- false ：取消禁止 （默认值）。 |
-| `isAllCameraDisabled` | `Boolean` | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
-| `isAllScreenShareDisabled` | `Boolean` | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
-| `isAllMessageDisabled` | `Boolean` | 否 | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
+| <code>roomName</code> | <code>String</code> | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
+| <code>password</code> | <code>String</code> | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
+| <code>isAllMicrophoneDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风：<br>- true : 禁止<br>- false ：取消禁止 （默认值） |
+| <code>isAllCameraDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头：<br>- true : 禁止<br>- false ：取消禁止（默认值） |
+| <code>isAllScreenShareDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享：<br>- true : 禁止<br>- false ：取消禁止（默认值） |
+| <code>isAllMessageDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息：<br>- true : 禁止<br>- false ：取消禁止（默认值） |
 
 ### 步骤3：**加入房间**
 
@@ -128,10 +128,10 @@ fun joinRoom() {
 ##### joinRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `roomType` | `RoomType` | 是 | 房间类型<br>- `STANDARD`：标准房间（默认值）<br>- `WEBINAR`：大型研讨会房间 |
-| `password` | `String` | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
-| `completion` | `CompletionHandler` | 否 | 操作完成回调，用于返回加入房间的结果。若加入房间失败则会返回错误码和错误信息。 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>roomType</code> | <code>RoomType</code> | 是 | 房间类型<br>- <code>STANDARD</code>：标准房间（默认值）<br>- <code>WEBINAR</code>：大型研讨会房间<br>多人会议场景这里填写 <code>STANDARD</code> 房间类型。 |
+| <code>password</code> | <code>String</code> | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
+| <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回加入房间的结果。若加入房间失败则会返回错误码和错误信息。 |
 
 ### **步骤4：离开房间**
 
@@ -226,22 +226,22 @@ fun updateRoomInfo() {
 ##### updateRoomInfo 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `options` | `UpdateRoomOptions` | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：UpdateRoomOptions 结构体详细说明 |
-| `modifyFlagList` | `List<UpdateRoomOptions.ModifyFlag>` | 是 | - 更新房间属性修改标志位。目前支持更新**房间名称**、**房间密码**。<br>- 详细用法请参考：UpdateRoomOptions.ModifyFlag 详细说明。 |
-| `completion` | `CompletionHandler` | 否 | 操作完成回调，用于返回更新房间信息的结果。若更新失败则会返回错误码和错误信息。 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：UpdateRoomOptions 结构体详细说明 |
+| <code>modifyFlagList</code> | <code>List<UpdateRoomOptions.ModifyFlag></code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法请参考：UpdateRoomOptions.ModifyFlag 详细说明。 |
+| <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回更新房间信息的结果。若更新失败则会返回错误码和错误信息。 |
 
 **UpdateRoomOptions 结构体详细说明**
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomName` | `String` | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
-| `password` | `String` | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
+| <code>roomName</code> | <code>String</code> | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
+| <code>password</code> | <code>String</code> | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
 
 **UpdateRoomOptions.ModifyFlag 详细说明**
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `ROOM_NAME` | `enum` | 否 | - 修改房间名称时的标识位。<br>- 当修改 `UpdateRoomOptions` 中的 `roomName` 后，需要同步设置 `ModifyFlag` 的<br>`ROOM_NAME`标识位。 |
-| `PASSWORD` | `enum` | 否 | - 修改房间密码时的标识位。<br>- 当修改 `UpdateRoomOptions` 中的 `password` 后，需要同步设置 `ModifyFlag` 的<br>`PASSWORD` 标识位。 |
+| <code>ROOM_NAME</code> | <code>enum</code> | 否 | - 修改房间名称时的标识位。<br>- 当修改 <code>UpdateRoomOptions</code> 中的 <code>roomName</code> 后，需要同步设置 <code>ModifyFlag</code> 的<br><code>ROOM_NAME</code>标识位。 |
+| <code>PASSWORD</code> | <code>enum</code> | 否 | - 修改房间密码时的标识位。<br>- 当修改 <code>UpdateRoomOptions</code> 中的 <code>password</code> 后，需要同步设置 <code>ModifyFlag</code> 的<br><code>PASSWORD</code> 标识位。 |
 
 ### 步骤7：获取房间信息
 
@@ -332,9 +332,10 @@ private fun subscribeCurrentRoomState() {
 ```
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API文档** |
-| --- | --- | --- |
-| **RoomStore** | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预约 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**RoomStore**|房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预约 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html)|
 
 ## 常见问题
 

package/resource/{doc/roomkit/android/features → knowledge/roomkit/core-sdk/android}/schedule-room.md

@@ -14,13 +14,13 @@
 ## 核心概念
 
 在开始集成之前，可通过下表了解 `RoomStore` 的核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| [RoomStatus](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-state/index.html) | `enum class` | 代表当前房间的状态，包含：<br>- `SCHEDULED`（预定状态）。<br>- `RUNNING`（进行中）。 |
-| [ScheduleRoomOptions](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-schedule-room-options/index.html) | `data class` | 代表预定房间的核心数据结构，包含：开始时间，结束时间，预定成员列表等。 |
-| [RoomState](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-state/index.html) | `data class` | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- `scheduledRoomList`存储了当前账号下所有预定的房间列表信息。<br>- `scheduledRoomListCursor` 则代表预定房间列表的分页游标。 |
-| [RoomListener](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/index.html) | `abstract class` | 代表房间动态的实时事件。其中包含预定房间相关的事件。 |
-| [RoomStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html) | `abstract class` | 这是与房间全生命周期相关的核心类。通过它，您可以主动发起预定房间，获取预定房间列表等功能，并通过订阅其 `RoomListener` 来接收与预定房间相关的实时动态事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-status/index.html">RoomStatus</a> | <code>enum class</code> | 代表当前房间的状态，包含：<br>- <code>SCHEDULED</code>（预定状态）。<br>- <code>RUNNING</code>（进行中）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-schedule-room-options/index.html">ScheduleRoomOptions</a> | <code>data class</code> | 代表预定房间的核心数据结构，包含：开始时间，结束时间，预定成员列表等。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-state/index.html">RoomState</a> | <code>data class</code> | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- <code>scheduledRoomList</code>存储了当前账号下所有预定的房间列表信息。<br>- <code>scheduledRoomListCursor</code> 则代表预定房间列表的分页游标。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-listener/index.html">RoomListener</a> | <code>abstract class</code> | 代表房间动态的实时事件。其中包含预定房间相关的事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html">RoomStore</a> | <code>abstract class</code> | 这是与房间全生命周期相关的核心类。通过它，您可以主动发起预定房间，获取预定房间列表等功能，并通过订阅其 <code>RoomListener</code> 来接收与预定房间相关的实时动态事件。 |
 
 ## 实现步骤
 
@@ -79,23 +79,23 @@ fun scheduleRoom() {
 ##### scheduleRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `options` | `ScheduleRoomOptions` | 是 | - 创建房间配置对象。<br>- 详细用法请参考：ScheduleRoomOptions 结构体详细说明。 |
-| `completion` | `CompletionHandler` | 否 | 操作完成回调，用于返回预定房间的结果。若预定失败则会返回错误码和错误信息。 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：ScheduleRoomOptions 结构体详细说明。 |
+| <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回预定房间的结果。若预定失败则会返回错误码和错误信息。 |
 
 ##### ScheduleRoomOptions 结构体详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomName` | `String` | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
-| `password` | `String` | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
-| `scheduleStartTime` | `Long` | 是 | - 预定的房间开始时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于当前时间。<br>- 推荐设置为未来的整分时间。例如：1736164800（代表 2025-01-06 20:00:00）。 |
-| `scheduleEndTime` | `Long` | 是 | - 预定的房间结束时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于 `scheduleStartTime`。<br>- 建议根据预期时长设置。例如：`scheduleStartTime` + 3600（预定 1 小时时长的房间）。 |
-| `reminderSecondsBeforeStart` | `Int` | 否 | - 房间开始前的提醒时间（单位：秒）。用于系统触发开始提醒。<br>- 推荐设置为 300（5分钟）或 900（15分钟），用于在 App 端触发本地通知。 |
-| `scheduleAttendees` | `List<String>` | 否 | - 预定参与者的用户 ID 列表，在预定房间时设置，系统将向这些用户发送预定邀请。<br>- 获取方式请参考 获取指定预定房间的参与成员列表。 |
-| `isAllMicrophoneDisabled` | `Boolean` | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。<br>- true : 禁止。<br>- false ：取消禁止 （默认值）。 |
-| `isAllCameraDisabled` | `Boolean` | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
-| `isAllScreenShareDisabled` | `Boolean` | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
-| `isAllMessageDisabled` | `Boolean` | 否 | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
+| <code>roomName</code> | <code>String</code> | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
+| <code>password</code> | <code>String</code> | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
+| <code>scheduleStartTime</code> | <code>Long</code> | 是 | - 预定的房间开始时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于当前时间。<br>- 推荐设置为未来的整分时间。例如：1736164800（代表 2025-01-06 20:00:00）。 |
+| <code>scheduleEndTime</code> | <code>Long</code> | 是 | - 预定的房间结束时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于 <code>scheduleStartTime</code>。<br>- 建议根据预期时长设置。例如：<code>scheduleStartTime</code> + 3600（预定 1 小时时长的房间）。 |
+| <code>reminderSecondsBeforeStart</code> | <code>Int</code> | 否 | - 房间开始前的提醒时间（单位：秒）。用于系统触发开始提醒。<br>- 推荐设置为 300（5分钟）或 900（15分钟），用于在 App 端触发本地通知。 |
+| <code>scheduleAttendees</code> | <code>List<String></code> | 否 | - 预定参与者的用户 ID 列表，在预定房间时设置，系统将向这些用户发送预定邀请。<br>- 获取方式请参考 获取指定预定房间的参与成员列表。 |
+| <code>isAllMicrophoneDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。<br>- true : 禁止。<br>- false ：取消禁止 （默认值）。 |
+| <code>isAllCameraDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
+| <code>isAllScreenShareDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
+| <code>isAllMessageDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息。<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
 
 #### **2. 取消房间预定**
 
@@ -160,17 +160,17 @@ fun updateScheduledRoom() {
 ##### updateScheduledRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | 字符串类型的房间唯一标识符。<br>限制长度为 0-48 字节。<br>建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `options` | `ScheduleRoomOptions` | 是 | 预定房间配置对象。<br>详细用法请参考：ScheduleRoomOptions 结构体详细说明。 |
-| `modifyFlag` | `ScheduleRoomOptions.ModifyFlag` | 是 | 更新房间属性修改标志位。目前支持更新**房间名称**、**开始时间**、**结束时间。**<br>详细用法请参考：ScheduleRoomOptions.ModifyFlag 详细说明。 |
-| `completion` | `CompletionHandler` | 否 | 操作完成回调，用于返回更新预定房间的结果。若更新失败则会返回错误码和错误信息。 |
+| <code>roomID</code> | <code>String</code> | 是 | 字符串类型的房间唯一标识符。<br>限制长度为 0-48 字节。<br>建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | 预定房间配置对象。<br>详细用法请参考：ScheduleRoomOptions 结构体详细说明。 |
+| <code>modifyFlagList</code> | <code>List<ScheduleRoomOptions.ModifyFlag></code> | 是 | 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>开始时间</strong>、<strong>结束时间。</strong><br>详细用法请参考：ScheduleRoomOptions.ModifyFlag 详细说明。 |
+| <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回更新预定房间的结果。若更新失败则会返回错误码和错误信息。 |
 
 **ScheduleRoomOptions.ModifyFlag 详细说明**
 | 参数名 | 类型 | 说明 |
 | --- | --- | --- |
-| `ROOM_NAME` | `enum` | - 修改预定房间名称时的标识位。<br>- 当修改 `ScheduleRoomOptions` 中的 `roomName` 后，需要同步设置 `ModifyFlag` 的 `ROOM_NAME` 标识位。 |
-| `SCHEDULE_START_TIME` | `enum` | - 修改预定房间开始时间时的标识位。<br>- 当修改 `ScheduleRoomOptions` 中的 `scheduleStartTime` 后，需要同步设置 `ModifyFlag` 的 `SCHEDULE_START_TIME` 标识位。 |
-| `SCHEDULE_END_TIME` | `enum` | - 修改预定房间结束时间时的标识位。<br>- 当修改 `ScheduleRoomOptions` 中的 `scheduleEndTime` 后，需要同步设置 `ModifyFlag` 的 `SCHEDULE_END_TIME` 标识位。 |
+| <code>ROOM_NAME</code> | <code>enum</code> | - 修改预定房间名称时的标识位。<br>- 当修改 <code>ScheduleRoomOptions</code> 中的 <code>roomName</code> 后，需要同步设置 <code>ModifyFlag</code> 的 <code>ROOM_NAME</code> 标识位。 |
+| <code>SCHEDULE_START_TIME</code> | <code>enum</code> | - 修改预定房间开始时间时的标识位。<br>- 当修改 <code>ScheduleRoomOptions</code> 中的 <code>scheduleStartTime</code> 后，需要同步设置 <code>ModifyFlag</code> 的 <code>SCHEDULE_START_TIME</code> 标识位。 |
+| <code>SCHEDULE_END_TIME</code> | <code>enum</code> | - 修改预定房间结束时间时的标识位。<br>- 当修改 <code>ScheduleRoomOptions</code> 中的 <code>scheduleEndTime</code> 后，需要同步设置 <code>ModifyFlag</code> 的 <code>SCHEDULE_END_TIME</code> 标识位。 |
 
 #### **4. 添加、删除参与成员**
 
@@ -310,9 +310,10 @@ private fun subscribeParticipantState() {
 ```
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **RoomStore** | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预定 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**RoomStore**|房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预定 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html)|
 
 ## 常见问题