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

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

@@ -1,56 +1,27 @@
 `RoomParticipantStore` 是 `AtomicXCore` 中专用于房间参与者管理的模块。该模块为多人房间场景提供了核心能力，支持构建完整的成员管理体系。
 
-## 房间模式说明
-
-在开始使用成员管理功能之前，需要了解 `AtomicXCore` 中房间模块支持的两种房间模式，不同模式下的成员管理功能有所区别：
-| **标准房间模式（Standard Room）** | **网络研讨会房间模式（Webinar Room）** |
-| --- | --- |
-| - **适用场景：**小型会议、团队协作、朋友聊天等。<br>- **成员特点：**所有成员都是参与者，可以自由开启/关闭音视频设备。<br>- **管理特点：**扁平化管理，房主可设置管理员进行协助管理。 | - **适用场景**：网络研讨会、在线培训等。<br>- **成员特点**：<br>- **嘉宾（Participants）**：可以开启音视频设备，参与互动。<br>- **观众（Audience）**：只能观看，无法开启音视频设备。<br>- **管理特点**：分层管理，支持观众与嘉宾身份转换。 |
-
 ## 核心功能
-- **获取参与者列表**：获取并展示当前房间内所有参与者信息（网络研讨会房间模式下，获取到的是嘉宾列表，嘉宾可以开启麦克风与其他嘉宾互动）。
-
-- **获取观众列表：**网络研讨会房间模式下，获取观众列表信息。
-
-- **搜索房间内成员：**搜索所在房间内的指定用户。
+- **获取参与者列表**：获取并展示当前房间内所有参与者信息。
 
-- **将观众提升为嘉宾：**网络研讨会房间模式下，可以将观众提升为嘉宾，提升为嘉宾的用户可以开启麦克风与其他房间内的嘉宾互动。
-
-- **将嘉宾降级为观众：**网络研讨会房间模式下，可以将嘉宾降级为观众， 降级为观众的用户无法与房间内的嘉宾进行语音互动。
-
-- **转移房主身份**：房主可以将房主身份转移给房间内任意一名参与者。
+- **房主转移**：房主可以将房主身份转移给房间内任意一名参与者。
 
 - **设置/撤销管理员**：房主可以设置参与者为管理员，同时也可撤销房间内的管理员。
 
-- **将参与者移出房间**：房主或者管理员可以将房间内任意一名参与者移出房间。
+- **将参与者移除房间**：房主或者管理员可以将房间内任意一名参与者移出房间。
 
 - **更新参与者信息**：房间内所有人都可以更新自己的参与者信息。
 
 - **音视频设备管理**：支持申请/邀请打开摄像头、麦克风，关闭远端摄像头、麦克风，以及房主和管理员设置全体静音，全体禁用摄像头功能。
 
-## 功能对比
-| **功能** | **标准房间模式** | **网络研讨会房间模式** |
-| --- | --- | --- |
-| 获取参与者列表 | 获取所有房间成员 | 获取嘉宾列表 |
-| 获取观众列表 | 不适用 | 获取观众列表 |
-| 搜索房间内成员 | 支持 | 支持 |
-| 将观众提升为嘉宾 | 不适用 | 支持 |
-| 将嘉宾降级为观众 | 不适用 | 支持 |
-| 转移房主身份 | 支持 | 支持 |
-| 设置/撤销管理员 | 支持 | 支持 |
-| 移出房间 | 支持 | 支持 |
-| 更新参与者信息 | 支持 | 支持 |
-| 音视频设备管理 | 支持 | 支持 |
-
 ## 核心概念
 
-在开始集成之前，需要通过下表了解一下`RoomParticipantStore`相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+在开始集成之前，需要通过下表了解一下 `RoomParticipantStore` 相关的几个核心概念：
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| [RoomParticipant](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipant) | `struct` | 代表参与者的核心数据模型，封装了参与者的完整信息和状态管理能力。<br>**标准房间模式：**代表房间内的所有成员。<br>**网络研讨会房间模式：**代表嘉宾，可以开启/关闭麦克风。<br>核心功能包括：参与者基本信息管理（用户 ID 、用户名称、用户头像、房间内角色身份）、参与者设备状态管理（麦克风状态，摄像头状态，屏幕分享状态，消息状态）。 |
-| [RoomParticipantState](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantstate) | `struct` | 代表参与者状态管理的核心数据结构，负责维护房间内与参与者相关的状态信息。<br>核心属性：<br>- `participantList`**标准房间模式**存储所有房间成员，**网络研讨会房间模式**存储嘉宾列表。<br>- `participantListCursor`**标准房间模式**代表房间内所有成员列表的分页游标，**网络研讨会房间模式**代表房间内嘉宾列表的分页游标。<br>- `localParticipant`则代表自身所在房间内的参与者信息。 |
-| [RoomParticipantEvent](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantevent) | `enum` | 代表房间内和参与者相关的实时事件。主要事件分为三大类：参与者进退房事件、 参与者身份改变事件，参与者设备控制事件。 |
-| [RoomParticipantStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantstore) | `class` | 这是参与者控制相关的核心类。功能包含：控制房间内参与者音视频状态、执行参与者管理操作，并通过订阅其 `participantEventPublisher` 来接收实时事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipant">RoomParticipant</a> | <code>struct</code> | 代表参与者的核心数据模型，封装了参与者的完整信息和状态管理能力。<br>核心功能包括：参与者基本信息管理（用户 ID 、用户名称、用户头像、房间内角色身份）、参与者设备状态管理（麦克风状态，摄像头状态，屏幕分享状态，消息状态）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantstate">RoomParticipantState</a> | <code>struct</code> | 代表参与者状态管理的核心数据结构，负责维护房间内与参与者相关的状态信息。<br>核心属性：<br>- <code>participantList</code> 存储了当前所在房间的所有参与者信息集合。<br>- <code>participantListCursor</code> 则代表房间内参与者列表的分页快照。<br>- <code>localParticipant</code> 则代表自身所在房间内的参与者信息。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantevent">RoomParticipantEvent</a> | <code>enum</code> | 代表房间内和参与者相关的实时事件。主要事件分为三大类：参与者进退房事件、 参与者身份改变事件，参与者设备控制事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantstore">RoomParticipantStore</a> | <code>class</code> | 这是参与者控制相关的核心类。功能包含：控制房间内参与者音视频状态、执行参与者管理操作，并通过订阅其 <code>participantEventPublisher</code> 来接收实时事件。 |
 
 ## 实现步骤
 
@@ -60,66 +31,34 @@
 
 ### 步骤2：获取参与者列表
 
-在加入房间后，调用RoomParticipantStore的getParticipantList接口获取房间内参与者列表。
-- **标准房间模式：**获取房间内所有成员列表。
-
-- **网络研讨会房间模式：**获取房间内嘉宾列表。
-
-   ``` swift
-   import Foundation
-   import AtomicXCore
-
-   func getParticipantList() {
-       // 1. 业务逻辑说明
-       // 前提：需要先完成进房操作,通过进房的roomID创建RoomParticipantStore实例
-       let participantStore = RoomParticipantStore.create(roomID: "your_room_id")
-
-       // 2. 首次获取参与者列表（从头开始）
-       // 支持分页加载，可以通过 cursor 参数实现增量获取
-       let initialCursor: String? = nil  // nil 表示从第一页开始获取
-
-       participantStore.getParticipantList(cursor: initialCursor) { result in
-           switch result {
-           case .success(let participantInfo):
-               print("成功获取参与者列表，数量: \(participantInfo.0.count)")
-           case .failure(let error):
-               print("获取参与者列表失败 [错误码: \(error.code)]: \(error.message)")
-           }
-       }
-   }
-   ```
-
-### 步骤3：获取观众列表
-
-网络研讨会房间模式下，可以通过调用`RoomParticipantStore`的`getAudienceList`接口获取房间内的观众列表。
+在加入房间后，调用 `RoomParticipantStore` 的 `getParticipantList` 接口获取到房间内参与者列表。
 ``` swift
 import Foundation
 import AtomicXCore
 
-func getAudienceList() {
-    // 前提：需要先完成进房操作, 并且进房时 roomType 设置为 webinar 类型。
+func getParticipantList() {
     // 1. 业务逻辑说明
-    // 通过进房的roomID创建RoomParticipantStore实例
+    // 前提：需要先完成进房操作,通过进房的roomID创建RoomParticipantStore实例
     let participantStore = RoomParticipantStore.create(roomID: "your_room_id")
 
-    // 2. 首次获取观众列表（从头开始）
+    // 2. 首次获取参与者列表（从头开始）
     // 支持分页加载，可以通过 cursor 参数实现增量获取
     let initialCursor: String? = nil  // nil 表示从第一页开始获取
 
-    participantStore.getAudienceList(cursor: initialCursor) { result in
+    participantStore.getParticipantList(cursor: initialCursor) { result in
         switch result {
-        case .success(let audienceInfo):
-            print("获取观众列表成功，观众数量: \(audienceInfo.0.count)")
+        case .success(let participantInfo):
+            print("成功获取参与者列表，数量: \(participantInfo.0.count)")
         case .failure(let error):
-            print("获取观众列表失败 [错误码: \(error.code)]: \(error.message)")
+            print("获取参与者列表失败 [错误码: \(error.code)]: \(error.message)")
         }
     }
 }
 ```
 
-### 步骤4：搜索房间内成员
+### 步骤3：搜索房间内成员
 
-进入房间成功后，可以通过调用`RoomParticipantStore`的`searchUsers`接口搜索房间内的成员。
+进入房间成功后，可以通过调用 `RoomParticipantStore` 的 `searchUsers` 接口搜索房间内的成员。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -144,117 +83,9 @@ func searchUsers() {
 }
 ```
 
-### 步骤5：将**观众提升为嘉宾**
-
-网络研讨会房间模式下，作为房主或管理员，调用`RoomParticipantStore`的`promoteAudienceToParticipant`接口可以将房间内的观众提升为嘉宾。
-``` swift
-import Foundation
-import AtomicXCore
-
-func promoteAudienceToParticipant(userID: String) {
-    // 前提：需要先完成进房操作。
-    // 1. 业务逻辑说明
-    // 通过进房的 roomID 创建 RoomParticipantStore 实例
-    let participantStore = RoomParticipantStore.create(roomID: "your_room_id")
-
-    // 2. 调用 RoomParticipantStore 提升观众为参与者接口
-    // 注意：只有房主或管理员才有权限执行此操作。
-    participantStore.promoteAudienceToParticipant(userID: userID) { result in
-        switch result {
-        case .success():
-            print("提升为参与者成功")
-        case .failure(let error):
-            print("提升为参与者失败 [错误码: \(error.code)]: \(error.message)")
-        }
-    }
-}
-```
-
-作为房间内成员订阅`RoomParticipantStore`的`participantEventPublisher`中的`onAudiencePromotedToParticipant`事件，被动接收观众提升为参与者的变化通知。
-``` swift
-import Foundation
-import AtomicXCore
-import Combine
-
-private var cancellableSet = Set<AnyCancellable>()
-
-private func subscribeParticipantEvent() {
-    // 1. 业务逻辑说明
-    // 前提：需要先完成进房操作,通过进房的 roomID 创建 RoomParticipantStore 实例
-    let participantStore = RoomParticipantStore.create(roomID: "your_room_id")
-
-    // 2. 订阅参与者事件
-    // participantEventPublisher 会推送所有参与者相关的事件
-    participantStore.participantEventPublisher
-        .receive(on: DispatchQueue.main) // 确保在主线程处理 UI 逻辑
-        .sink { event in
-            switch event {
-            case .onAudiencePromotedToParticipant(userInfo: let userInfo):
-                print("观众被提升为参与者，userInfo: \(userInfo)")
-            default: break
-            }
-        }
-        .store(in: &cancellableSet)
-}
-```
-
-### 步骤6：将**嘉宾降级为观众**
-
-网络研讨会房间模式下，作为房主或管理员，调用`RoomParticipantStore`的`demoteParticipantToAudience`接口可以将房间内的嘉宾降级为观众。
-``` swift
-import Foundation
-import AtomicXCore
-
-func demoteParticipantToAudience(userID: String) {
-    // 前提：需要先完成进房操作。
-    // 1. 业务逻辑说明
-    // 通过进房的 roomID 创建 RoomParticipantStore 实例
-    let participantStore = RoomParticipantStore.create(roomID: "your_room_id")
-
-    // 2. 调用 RoomParticipantStore 降级参与者为观众接口
-    // 注意：只有房主或管理员才有权限执行此操作。
-    participantStore.demoteParticipantToAudience(userID: userID) { result in
-        switch result {
-        case .success():
-            print("降级为观众成功")
-        case .failure(let error):
-            print("降级为观众失败 [错误码: \(error.code)]: \(error.message)")
-        }
-    }
-}
-```
-
-作为房间内成员订阅`RoomParticipantStore`的`participantEventPublisher`中的`onParticipantDemotedToAudience`事件，被动接收参与者降级为观众的变化通知。
-``` swift
-import Foundation
-import AtomicXCore
-import Combine
-
-private var cancellableSet = Set<AnyCancellable>()
-
-private func subscribeParticipantEvent() {
-    // 1. 业务逻辑说明
-    // 前提：需要先完成进房操作,通过进房的roomID创建RoomParticipantStore实例
-    let participantStore = RoomParticipantStore.create(roomID: "your_room_id")
-
-    // 1. 订阅参与者事件
-    // participantEventPublisher 会推送所有参与者相关的事件
-    participantStore.participantEventPublisher
-        .receive(on: DispatchQueue.main) // 确保在主线程处理 UI 逻辑
-        .sink { event in
-            switch event {
-            case .onParticipantDemotedToAudience(userInfo: let userInfo):
-                print("参与者被降级为观众，userInfo: \(userInfo)")
-            default: break
-            }
-        }
-        .store(in: &cancellableSet)
-}
-```
-
-### 步骤7：转移房主身份
+### 步骤4：转移房主身份
 
-作为房主调用`RoomParticipantStore`的`transferOwner`接口可以将房主身份直接转移给房间内任意一位参与者，转移后原房主身份将变为普通参与者，一个房间内有且仅有一名房主。
+作为房主调用 `RoomParticipantStore` 的 `transferOwner` 接口可以将房主身份直接转移给房间内任意一位参与者，转移后原房主身份将变为普通参与者，一个房间内有且仅有一名房主。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -277,7 +108,7 @@ func transferOwner(to userID: String) {
 }
 ```
 
-作为参与者订阅`RoomParticipantStore`的`participantEventPublisher`中的`onOwnerChanged`事件，被动接收房主变化通知。
+作为参与者订阅 `RoomParticipantStore` 的 `participantEventPublisher` 中的 `onOwnerChanged` 事件，被动接收房主变化通知。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -305,9 +136,9 @@ private func subscribeParticipantEvent() {
 }
 ```
 
-### 步骤8：设置/撤销管理员
+### 步骤5：设置/撤销管理员
 
-作为房主调用`RoomParticipantStore`的`setAdmin`接口，指定房间内任意一位参与者成为管理员，也可以将管理员身份撤销。
+作为房主调用 `RoomParticipantStore` 的 `setAdmin` 接口，指定房间内任意一位参与者成为管理员，也可以将管理员身份撤销。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -341,7 +172,7 @@ func revokeUserAdmin(userID: String) {
 }
 ```
 
-作为参与者订阅`RoomParticipantStore`的`participantEventPublisher`中的`onAdminSet`和`onAdminRevoked`事件，被动接收参与者身份变化通知。
+作为参与者订阅 `RoomParticipantStore` 的 `participantEventPublisher` 中的 `onAdminSet` 和 `onAdminRevoked` 事件，被动接收参与者身份变化通知。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -368,9 +199,9 @@ private func subscribeParticipantEvents() {
 }
 ```
 
-### 步骤9：**将参与者移出房间**
+### 步骤6：**将参与者移出房间**
 
-作为房主和管理员调用`RoomParticipantStore`的`kickUser`可以将房间内参与者移出房间。
+作为房主和管理员调用 `RoomParticipantStore` 的 `kickUser` 可以将房间内参与者移出房间。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -397,7 +228,7 @@ func kickUser(userID: String) {
 }
 ```
 
-作为参与者订阅`RoomParticipantStore`的`participantEventPublisher`中的`onKickedFromRoom`事件，被动接收参与者被移出房间通知。
+作为参与者订阅 `RoomParticipantStore` 的 `participantEventPublisher` 中的 `onKickedFromRoom` 事件，被动接收参与者被移出房间通知。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -424,9 +255,9 @@ private func subscribeParticipantEvent() {
 }
 ```
 
-### 步骤10：更新参与者信息
+### 步骤7：更新参与者信息
 
-在加入房间后，调用`RoomParticipantStore`的`updateParticipantNameCard`、`updateParticipantMetaData`更新您在房间里的参与者信息，包含：参与者名片信息，参与者自定义信息。
+在加入房间后，调用 `RoomParticipantStore` 的 `updateParticipantNameCard`、`updateParticipantMetaData` 更新您在房间里的参与者信息，包含：参与者名片信息，参与者自定义信息。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -455,7 +286,7 @@ func updateParticipantNameCard(userID: String, nameCard: String) {
 func updateParticipantMetaData(userID: String, metaData: [String: String]) {
     // 1. 业务逻辑说明
     // updateParticipantMetaData 接口用于更新指定参与者的自定义信息
-    // 存储自定义的业务数据，如用户标签、扩展属性等
+    // 存储自定义的业务数据，例如用户标签、扩展属性等
     // 注意：自定义信息的键值对数量和大小有限制，键长度不能超过 50 字节，值长度不超过 200 字节
 
     // 2. 调用 RoomParticipantStore 更新自定义信息接口
@@ -470,9 +301,9 @@ func updateParticipantMetaData(userID: String, metaData: [String: String]) {
 }
 ```
 
-### 步骤11：邀请参与者打开其设备
+### 步骤8：邀请参与者打开其设备
 
-作为房主和管理员调用`RoomParticipantStore`的`inviteToOpenDevice`接口，邀请房间内参与者打开摄像头、麦克风。
+作为房主和管理员调用 `RoomParticipantStore` 的 `inviteToOpenDevice` 接口，邀请房间内参与者打开摄像头、麦克风。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -501,9 +332,9 @@ func inviteUserToOpenDevice(userID: String, device: DeviceType, timeout: Int = 3
 ```
 
 作为参与者：
-- 订阅`RoomParticipantStore`的`participantEventPublisher`中的`onDeviceInvitationReceived`事件，被动接收邀请打开设备通知。
+- 订阅 `RoomParticipantStore` 的 `participantEventPublisher` 中的 `onDeviceInvitationReceived` 事件，被动接收邀请打开设备通知。
 
-- 接收到邀请打开设备通知后调用`RoomParticipantStore`的`acceptOpenDeviceInvitation`或者`declineOpenDeviceInvitation`接口接受或拒绝邀请。
+- 接收到邀请打开设备通知后调用 `RoomParticipantStore` 的 `acceptOpenDeviceInvitation` 或者 `declineOpenDeviceInvitation` 接口接受或拒绝邀请。
 
    ``` swift
    import Foundation
@@ -555,9 +386,9 @@ func inviteUserToOpenDevice(userID: String, device: DeviceType, timeout: Int = 3
    }
    ```
 
-### 步骤12：关闭远端参与者设备
+### 步骤9：关闭远端参与者设备
 
-作为房主和管理员调用`RoomParticipantStore`的`closeParticipantDevice`可以主动关闭远端参与者的摄像头、麦克风。
+作为房主和管理员调用 `RoomParticipantStore` 的 `closeParticipantDevice` 可以主动关闭远端参与者的摄像头、麦克风。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -583,7 +414,7 @@ func closeParticipantDevice(userID: String, device: DeviceType) {
 }
 ```
 
-作为参与者订阅`RoomParticipantStore`的`participantEventPublisher`中的`onParticipantDeviceClosed`事件，被动接收设备被关闭通知，并在UI上做出提示。
+作为参与者订阅 `RoomParticipantStore` 的 `participantEventPublisher` 中的 `onParticipantDeviceClosed` 事件，被动接收设备被关闭通知，并在 UI 上做出提示。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -611,9 +442,9 @@ private func subscribeDeviceClosedEvent() {
 }
 ```
 
-### 步骤13：参与者申请打开自己的设备
+### 步骤10：参与者申请打开自己的设备
 
-作为参与者调用`RoomParticipantStore`的`requestToOpenDevice`接口，可以在房间被房主或管理员设置全体静音，全体禁用摄像头的场景下，主动申请打开摄像头、麦克风。
+作为参与者调用 `RoomParticipantStore` 的 `requestToOpenDevice` 接口，可以在房间被房主或管理员设置全体静音，全体禁用摄像头的场景下，主动申请打开摄像头、麦克风。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -641,9 +472,9 @@ func requestToOpenDevice(device: DeviceType, timeout: Int = 30) {
 ```
 
 作为房主和管理员：
-- 订阅`RoomParticipantStore`的`participantEventPublisher`中的`onDeviceRequestReceived`事件，被动接收申请打开设备通知。
+- 订阅 `RoomParticipantStore` 的 `participantEventPublisher` 中的 `onDeviceRequestReceived` 事件，被动接收申请打开设备通知。
 
-- 接收到申请打开设备通知后，调用`RoomParticipantStore`的`approveOpenDeviceRequest`或者`rejectOpenDeviceRequest`接口，批准或者拒绝申请。
+- 接收到申请打开设备通知后，调用 `RoomParticipantStore` 的 `approveOpenDeviceRequest` 或者 `rejectOpenDeviceRequest` 接口，批准或者拒绝申请。
 
    ``` swift
    import Foundation
@@ -696,9 +527,9 @@ func requestToOpenDevice(device: DeviceType, timeout: Int = 30) {
    }
    ```
 
-### 步骤14：全体禁用麦克风及摄像头
+### 步骤11：全体禁用麦克风及摄像头
 
-作为房主和管理员调用`RoomParticipantStore`的`disableAllDevices`接口设置全员静音与全员禁用摄像头。开启后，房间内参与者的音视频开启权限将被限制，无法自主打开麦克风或摄像头设备。
+作为房主和管理员调用 `RoomParticipantStore` 的 `disableAllDevices` 接口设置全员静音与全员禁用摄像头。开启后，房间内参与者的音视频开启权限将被限制，无法自主打开麦克风或摄像头设备。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -727,7 +558,7 @@ func disableAllDevices(device: DeviceType, disable: Bool) {
 }
 ```
 
-作为参与者订阅 `RoomParticipantStore`的`participantEventPublisher`中的`onAllDevicesDisabled`事件，可以监听全员静音或禁用摄像头指令，并在 UI 界面同步受控状态。受限状态下，摄像头与麦克风的主动开启功能将被锁定，参与者需发起开启申请，待房主或管理员核准授权后方可使用。
+作为参与者订阅 `RoomParticipantStore` 的 `participantEventPublisher` 中的 `onAllDevicesDisabled` 事件，可以监听全员静音或禁用摄像头指令，并在 UI 界面同步受控状态。受限状态下，摄像头与麦克风的主动开启功能将被锁定，参与者需发起开启申请，待房主或管理员核准授权后方可使用。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -755,9 +586,9 @@ private func subscribeAllDevicesDisabledEvent() {
 }
 ```
 
-### 步骤15：监听参与者事件
+### 步骤12：监听参与者事件
 
-订阅`RoomParticipantEvent`参与者相关的被动事件。以订阅参与者加入房间、离开房间为例，示例代码如下：
+订阅 `RoomParticipantEvent` 参与者相关的被动事件。以订阅参与者加入房间、离开房间为例，示例代码如下：
 ``` swift
 import Foundation
 import AtomicXCore
@@ -816,6 +647,6 @@ private func subscribeParticipantState() {
 ```
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API文档** |
+| <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API 文档</strong> |
 | --- | --- | --- |
-| **RoomParticipantStore** | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantstore) |
+| <strong>RoomParticipantStore</strong> | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantstore">API 文档</a> |

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

@@ -1,4 +1,4 @@
-`RoomStore`  专职负责  `AtomicXCore`  中的房间事务管理，提供从房间创建到解散的完整流程控制接口。通过 `RoomStore` 提供的接口（如获取及更新房间信息），可高效开发出一套成熟的房间管理体系。
+`RoomStore` 专职负责 `AtomicXCore` 中的房间事务管理，提供从房间创建到解散的完整流程控制接口。通过 `RoomStore` 提供的接口（例如获取及更新房间信息），可高效开发出一套成熟的房间管理体系。
 
 ## 核心功能
 - **创建并加入房间**：房主通过调用该接口可以直接创建并进入房间。
@@ -15,13 +15,13 @@
 
 ## 核心概念
 
-在开始集成之前，需要通过下表了解一下`RoomStore`相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+在开始集成之前，需要通过下表了解一下 `RoomStore` 相关的几个核心概念：
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| [RoomInfo](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roominfo) | `struct` | 代表房间信息的核心数据模型，封装了房间的完整信息和状态管理能力。<br>核心功能包括：<br>- 房间基本信息管理（房间 ID、名称、创建者）。<br>- 实时状态跟踪（参与者数量、房间状态、创建时间）。<br>- 房间调度功能（预约时间、参会者列表、提醒设置）。<br>- 权限控制（密码保护、设备管控、消息管理）。 |
-| [RoomState](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstate) | `struct` | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- `scheduledRoomList`存储了当前账号下所有预约的房间列表信息。<br>- `scheduledRoomListCursor` 则代表预约房间列表的分页快照。<br>- `currentRoom`则代表当前所在房间的状态信息。 |
-| [RoomEvent](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent) | `enum` | 代表房间动态的实时事件。主要事件分为三大类：预约房间事件，房间结束事件，房间呼叫事件。 |
-| [RoomStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstore) | `class` | 这是与房间全生命周期相关的核心类。功能包含：获取预约房间列表快照、执行房间管理操作，并通过订阅其 `roomEventPublisher` 来接收实时动态事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roominfo">RoomInfo</a> | <code>struct</code> | 代表房间信息的核心数据模型，封装了房间的完整信息和状态管理能力。<br>核心功能包括：<br>- 房间基本信息管理（房间 ID、名称、创建者）。<br>- 实时状态跟踪（参与者数量、房间状态、创建时间）。<br>- 房间调度功能（预约时间、参会者列表、提醒设置）。<br>- 权限控制（密码保护、设备管控、消息管理）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstate">RoomState</a> | <code>struct</code> | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- <code>scheduledRoomList</code> 存储了当前账号下所有预约的房间列表信息。<br>- <code>scheduledRoomListCursor</code> 则代表预约房间列表的分页快照。<br>- <code>currentRoom</code> 则代表当前所在房间的状态信息。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent">RoomEvent</a> | <code>enum</code> | 代表房间动态的实时事件。主要事件分为三大类：预约房间事件，房间结束事件，房间呼叫事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstore">RoomStore</a> | <code>class</code> | 这是与房间全生命周期相关的核心类。功能包含：获取预约房间列表快照、执行房间管理操作，并通过订阅其 <code>roomEventPublisher</code> 来接收实时动态事件。 |
 
 ## 实现步骤
 
@@ -32,11 +32,11 @@
 ### 步骤2：**创建并加入房间**
 
 ##### 实现方式：
-1. **配置房间初始化参数：**初始化`CreateRoomOptions`来设置房间名称，房间密码。
+1. **配置房间初始化参数：**初始化 `CreateRoomOptions` 来设置房间名称，房间密码。
 
 2. **房间权限预设：**设置房间内全场成员权限，例如全体静音，全体禁画等。
 
-3. **创建并加入房间：**调用`RoomStore`的`createAndJoinRoom`接口执行核心操作。
+3. **创建并加入房间：**调用 `RoomStore` 的 `createAndJoinRoom` 接口执行核心操作。
 
 ##### 示例代码：
 ``` swift
@@ -72,20 +72,20 @@ func createAndJoinRoom() {
 ##### createAndJoinRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `roomType` | `RoomType` | 是 | 房间类型。<br>- standard：标准房间，所有成员可自由音视频互动。<br>- webinar：大型研讨会房间，区分嘉宾和观众角色，观众默认无上麦权限。 |
-| `options` | `CreateRoomOptions` | 是 | - 创建房间配置对象。<br>- 详细用法请参考：CreateRoomOptions 结构体详细说明。 |
-| `completion` | `CompletionClosure` | 否 | 操作完成回调，用于返回创建和加入房间的结果。若创建失败则会返回错误码和错误信息。 |
+| <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>CompletionClosure</code> | 否 | 操作完成回调，用于返回创建和加入房间的结果。若创建失败则会返回错误码和错误信息。 |
 
 ##### CreateRoomOptions 结构体详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomName` | `String` | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
-| `password` | `String` | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
-| `isAllMicrophoneDisabled` | `Bool` | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。<br>- true：禁止。<br>- false：取消禁止 （默认值）。 |
-| `isAllCameraDisabled` | `Bool` | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
-| `isAllScreenShareDisabled` | `Bool` | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
-| `isAllMessageDisabled` | `Bool` | 否 | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息。<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>Bool</code> | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风：<br>- true：禁止。<br>- false：取消禁止 （默认值）。 |
+| <code>isAllCameraDisabled</code> | <code>Bool</code> | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头：<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
+| <code>isAllScreenShareDisabled</code> | <code>Bool</code> | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享：<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
+| <code>isAllMessageDisabled</code> | <code>Bool</code> | 否 | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息：<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
 
 ### 步骤3：**加入房间**
 
@@ -115,10 +115,10 @@ func joinRoom() {
 ##### joinRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `roomType` | `RoomType` | 是 | 房间类型<br>- standard：标准房间，所有成员可自由音视频互动。<br>- webinar：大型研讨会房间，区分嘉宾和观众角色，观众默认无上麦权限。 |
-| `password` | `String` | 是 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
-| `completion` | `CompletionClosure` | 否 | 操作完成回调，用于返回加入房间的结果。若创建失败则会返回错误码和错误信息。 |
+| <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>CompletionClosure</code> | 否 | 操作完成回调，用于返回加入房间的结果。若创建失败则会返回错误码和错误信息。 |
 
 ### **步骤4：离开房间**
 
@@ -204,26 +204,26 @@ func updateRoomInfo() {
 ##### updateRoomInfo 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `options` | `UpdateRoomOptions` | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：UpdateRoomOptions 结构体详细说明 |
-| `modifyFlag` | `UpdateRoomOptions.ModifyFlag` | 是 | - 更新房间属性修改标志位。目前支持更新**房间名称**、**房间密码**。<br>- 详细用法请参考：UpdateRoomOptions.ModifyFlag 详细说明。 |
-| `completion` | `CompletionClosure` | 否 | 操作完成回调，用于返回更新房间信息的结果。若更新失败则会返回错误码和错误信息。 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：UpdateRoomOptions 结构体详细说明。 |
+| <code>modifyFlag</code> | <code>UpdateRoomOptions.ModifyFlag</code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法请参考：UpdateRoomOptions.ModifyFlag 详细说明。 |
+| <code>completion</code> | <code>CompletionClosure</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 详细说明**
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomName` | `UInt` | 否 | - 修改房间名称时的标识位。<br>- 当修改`UpdateRoomOptions`中的`roomName`后，需要同步设置`ModifyFlag`的`roomName`标识位。 |
-| `password` | `UInt` | 否 | - 修改房间密码时的标识位。<br>- 当修改`UpdateRoomOptions`中的`password`后，需要同步设置`ModifyFlag`的`password`标识位。 |
+| <code>roomName</code> | <code>UInt</code> | 否 | - 修改房间名称时的标识位。<br>- 当修改 <code>UpdateRoomOptions</code> 中的 <code>roomName</code> 后，需要同步设置 <code>ModifyFlag</code> 的 <code>roomName</code> 标识位。 |
+| <code>password</code> | <code>UInt</code> | 否 | - 修改房间密码时的标识位。<br>- 当修改 <code>UpdateRoomOptions</code> 中的 <code>password</code> 后，需要同步设置 <code>ModifyFlag</code> 的 <code>password</code> 标识位。 |
 
 ### 步骤7：获取房间信息
 
-进入房间成功后调用`RoomStore`的`getRoomInfo`接口即可获取到房间详细信息。
+进入房间成功后调用 `RoomStore` 的 `getRoomInfo` 接口即可获取到房间详细信息。
 ``` swift
 import Foundation
 import AtomicXCore
@@ -248,7 +248,7 @@ func getRoomInfo() {
 
 ### 步骤8：监听房间实时事件及状态变化
 
-订阅`RoomEvent`房间内的被动事件。以订阅房间结束事件为例，示例代码如下：
+订阅 `RoomEvent` 房间内的被动事件。以订阅房间结束事件为例，示例代码如下：
 ``` swift
 import Foundation
 import AtomicXCore
@@ -271,7 +271,7 @@ private func subscribeRoomEvent() {
 }
 ```
 
-订阅`RoomState`房间属性状态变化。以订阅当前所在房间信息变化为例，示例代码如下：
+订阅 `RoomState` 房间属性状态变化。以订阅当前所在房间信息变化为例，示例代码如下：
 ``` swift
 import Foundation
 import AtomicXCore
@@ -294,16 +294,16 @@ private func subscribeRoomState() {
 ```
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API文档** |
+| <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API 文档</strong> |
 | --- | --- | --- |
-| **RoomStore** | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预定 / 呼叫房间外成员 / 监听房间内被动事件（如房间解散，房间信息更新等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstore) |
+| <strong>RoomStore</strong> | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预定 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstore">API 文档</a> |
 
 ## 常见问题
 
 ### `RoomInfo` 中的参与人数（`participantCount`）是如何更新的？时机和频率是怎样的？
 
 `participantCount` 的更新并非总是实时的，其机制如下：
-- **主动进出房间**：当用户主动加入或正常退出房间时，参与人数的变更通知会即时触发。您会很快在 `RoomState` 中的`currentRoom`观察到 `participantCount` 的变化。
+- **主动进出房间**：当用户主动加入或正常退出房间时，参与人数的变更通知会即时触发。您会很快在 `RoomState` 中的 `currentRoom` 观察到 `participantCount` 的变化。
 
 - **异常掉线**：当用户因网络问题、应用崩溃等原因异常掉线时，系统需要通过心跳机制来判断其真实状态。只有当该用户连续 90 秒没有心跳后，系统才会判定其为离线，并触发人数变更通知。