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

package/resource/knowledge/roomkit/core-sdk/flutter/call-user-to-room.md

@@ -0,0 +1,230 @@
+`RoomStore` 是 `AtomicXCore` 中专职房间事务管理的模块，深度集成了会中呼叫能力。本章节旨在指导如何利用 `RoomStore` 高效完成会中呼叫相关功能的开发与接入。
+
+## 核心功能
+- **会中呼叫**：房间内任意参与者均可呼叫房间外任意成员加入房间。
+
+- **获取会中呼叫用户列表**：可以获取指定房间的会中呼叫的用户列表。
+
+## 核心概念
+
+在开始集成之前，需要通过下表了解一下 `RoomStore` 中与会中呼叫相关的几个核心概念：
+| <strong>核心概念</strong> | <strong>核心职责与描述</strong> |
+| --- | --- |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomCallStatus.html">RoomCallStatus</a> | 代表会中呼叫的状态，包含：<br>- <code>none</code>（默认态）。<br>- <code>calling</code>（呼叫中）。<br>- <code>timeout</code>（呼叫超时）。<br>- <code>rejected</code>（呼叫被拒绝）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomCallResult.html">RoomCallResult</a> | 代表会中呼叫的结果，包含：<br>- <code>success</code>（呼叫成功）。<br>- <code>alreadyInCalling</code>（已在呼叫中）。<br>- <code>alreadyInRoom</code>（已在房间中）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/CallRejectionReason.html">CallRejectionReason</a> | 代表呼叫被拒绝的原因，目前仅支持：<br>- <code>rejected</code>（主动拒绝）。<br>- <code>inOtherRoom</code>（在其他房间中）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomCall-class.html">RoomCall</a> | 代表会中呼叫业务的核心数据结构。负责存储呼叫者信息、被呼叫者信息、以及当前呼叫状态。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener-class.html">RoomListener</a> | 代表房间动态的实时事件。其中包含会中呼叫相关的事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html">RoomStore</a> | 这是与房间全生命周期相关的核心类。功能包含：发起会中呼叫，响应会中呼叫，获取房间的会中呼叫列表，并通过订阅其 <code>RoomListener</code> 来接收与会中呼叫相关的实时动态事件。 |
+
+## 实现步骤
+
+### 步骤1：组件集成
+
+请参考 接入概览 集成 **AtomicXCore SDK**，并已完成 实现登录逻辑 部分接入。
+
+### 步骤2：呼叫方功能
+
+#### **1. 发起呼叫**
+
+作为呼叫方调用 `RoomStore` 的 `callUserToRoom` 接口，可以批量呼叫用户进房。
+``` java
+import 'package:atomic_x_core/atomicxcore.dart';
+
+Future<void> callUserToRoom({
+  required List<String> userIDList,
+  int timeout = 30,
+  String? extensionInfo,
+}) async {
+  final result = await RoomStore.shared.callUserToRoom(
+    roomID: "roomID",
+    userIDList: userIDList,
+    timeout: timeout,
+    extensionInfo: extensionInfo,
+  );
+
+  if (result.isSuccess) {
+    print("呼叫用户请求发送成功");
+  } else {
+    print("呼叫用户失败: [错误码: ${result.errorCode}]: ${result.errorMessage}");
+  }
+}
+```
+
+#### **2. 取消呼叫**
+
+作为呼叫方调用 `RoomStore` 的 `cancelCall` 接口，可以批量取消正在呼叫的申请。
+``` java
+import 'package:atomic_x_core/atomicxcore.dart';
+
+Future<void> cancelCall(List<String> userIDList) async {
+  final result = await RoomStore.shared.cancelCall(
+    roomID: "roomID",
+    userIDList: userIDList,
+  );
+
+  if (result.isSuccess) {
+    print("取消呼叫成功");
+  } else {
+    print("取消呼叫失败: [错误码: ${result.errorCode}]: ${result.errorMessage}");
+  }
+}
+```
+
+#### **3. 获取呼叫列表信息**
+
+进入房间后，调用 `RoomStore` 的 `getPendingCalls` 接口，可以分页查询当前房间正在呼叫的用户列表信息。
+``` java
+import 'package:atomic_x_core/atomicxcore.dart';
+
+Future<void> getPendingCalls(String roomID, String? cursor) async {
+  // cursor 为分页游标，首次调用时传入 null，获取第一页数据，后续调用时传入上次返回的 cursor 值。
+  final result = await RoomStore.shared.getPendingCalls(
+    roomID: roomID,
+    cursor: cursor,
+  );
+
+  if (result.isSuccess) {
+    print("获取呼叫列表成功，列表信息: ${result.data}, 分页游标: ${result.cursor}");
+  } else {
+    print("获取呼叫列表失败: [错误码: ${result.errorCode}]: ${result.errorMessage}");
+  }
+}
+```
+
+#### **4. 订阅会中呼叫事件**
+
+作为呼叫方订阅 `RoomStore` 的 `RoomListener` 能够实时获取呼叫的生命周期事件。通过监听以下回调，可以精准捕捉呼叫的最终结果并据此更新 UI 状态或执行后续业务逻辑。
+``` java
+import 'package:atomic_x_core/atomicxcore.dart';
+
+late RoomListener _listener;
+
+/// 订阅会中呼叫相关事件
+void addRoomCallListener() {
+  _listener = RoomListener(
+    onCallTimeout: (roomInfo, call) {
+      print("呼叫超时 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}");
+    },
+    onCallAccepted: (roomInfo, call) {
+      print("呼叫已被接受 房间信息: ${roomInfo.roomID}, 被呼叫者: ${call.callee.userID}");
+    },
+    onCallRejected: (roomInfo, call, reason) {
+      print("呼叫被拒绝 房间信息: ${roomInfo.roomID}, 被呼叫者: ${call.callee.userID}, 拒绝原因: $reason");
+    },
+  );
+
+  RoomStore.shared.addRoomListener(_listener);
+}
+
+void removeRoomCallListener() {
+  RoomStore.shared.removeRoomListener(_listener);
+}
+```
+
+**呼叫事件函数详细说明**
+
+|事件函数|触发时机与说明|
+|---------|---------|
+|[onCallTimeout](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener/onCallTimeout.html)|呼叫超时。当呼叫请求在预设的时间内（由调用 callUserToRoom 时指定）未得到被呼叫方的响应时触发。此时，呼叫自动结束，呼叫方通常需要提示“对方无人接听”。|
+|[onCallAccepted](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener/onCallAccepted.html)|呼叫被接受。被呼叫方主动点击了“接听”或“接受”按钮。收到此回调后，表示被呼叫者即将进入房间，呼叫方应更新 UI 状态，例如将该用户从“呼叫中”列表移除，并等待后续的成员进房通知来刷新成员列表。|
+|[onCallRejected](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener/onCallRejected.html)|呼叫被拒绝。被呼叫方主动拒绝了通话请求，或者因为被呼叫方当前正处于其他房间中而自动拒绝。回调中通常包含拒绝原因（如主动拒绝或在其他房间中）。|
+
+### 步骤3：被呼叫方功能
+
+#### **1. 订阅会中呼叫事件**
+
+作为被呼叫方订阅 `RoomStore` 的 `RoomListener` 可以实时监听并响应来自呼叫方的呼叫行为。以下是构建呼叫提醒界面以及维护呼叫链路状态的关键事件。
+``` java
+import 'package:atomic_x_core/atomicxcore.dart';
+
+late RoomListener _listener;
+
+/// 订阅会中呼叫相关事件
+void addRoomCallListener() {
+  _listener = RoomListener(
+    onCallReceived: (roomInfo, call, extensionInfo) {
+      print("收到房间呼叫 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}, 扩展信息: $extensionInfo");
+    },
+    onCallCancelled: (roomInfo, call) {
+      print("呼叫被取消 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}");
+    },
+    onCallRevokedByAdmin: (roomInfo, call, operatorUser) {
+      print("呼叫被管理员移除 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}, 移除操作者: ${operatorUser.userID}");
+    },
+    onCallHandledByOtherDevice: (roomInfo, isAccepted) {
+      print("呼叫已被其他设备处理 房间信息: ${roomInfo.roomID}, 处理结果: $isAccepted");
+    },
+  );
+
+  RoomStore.shared.addRoomListener(_listener);
+}
+
+void removeRoomCallListener() {
+  RoomStore.shared.removeRoomListener(_listener);
+}
+```
+
+**事件函数详细说明**
+
+|事件函数|触发时机与说明|
+|---------|---------|
+|[onCallReceived](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener/onCallReceived.html)|收到呼叫邀请。当有其他用户向您发起入会邀请时触发。收到此回调后，被呼叫方通常应立即弹出“呼叫提醒”界面，展示呼叫者信息、房间信息，并提供“接听”和“拒绝”按钮。|
+|[onCallCancelled](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener/onCallCancelled.html)|呼叫被发起方取消。呼叫方在您未做出响应前，主动撤回了呼叫请求。收到此回调后，被呼叫方应立即关闭当前的来电界面，并提示“对方已取消呼叫”，以恢复应用正常操作流程。|
+|[onCallRevokedByAdmin](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener/onCallRevokedByAdmin.html)|呼叫被管理员撤销。房间管理员或后台系统因权限变更、房间解散等原因强行终止了该笔呼叫邀请。收到此通知后，被呼叫方需立即停止呼叫流程并隐藏相关 UI，处理逻辑通常类似于呼叫被取消。|
+|[onCallHandledByOtherDevice](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener/onCallHandledByOtherDevice.html)|呼叫已在其他设备处理。当用户在多个设备（例如手机和 iPad）同时登录时，如果呼叫已在其中一台设备上被处理（接受或拒绝），当前设备会收到此通知，用于同步 UI 状态并自动消除呼叫界面。|
+
+#### **2. 接受呼叫、拒绝呼叫**
+
+作为被呼叫方调用 `RoomStore` 的 `acceptCall` 或者 `rejectCall` 接口，处理接受或者拒绝呼叫邀请。
+``` java
+import 'package:atomic_x_core/atomicxcore.dart';
+
+late RoomListener _listener;
+
+/// 订阅会中呼叫相关事件
+void addRoomCallListener() {
+  _listener = RoomListener(
+    onCallReceived: (roomInfo, call, extensionInfo) {
+      print("收到房间呼叫 房间信息: ${roomInfo.roomID}, 呼叫者: ${call.caller.userID}, 扩展信息: $extensionInfo");
+      // 接受、拒绝呼叫邀请操作
+    },
+  );
+
+  RoomStore.shared.addRoomListener(_listener);
+}
+
+void removeRoomCallListener() {
+  RoomStore.shared.removeRoomListener(_listener);
+}
+
+// 接受呼叫邀请
+Future<void> acceptCall(String roomID) async {
+  final result = await RoomStore.shared.acceptCall(roomID);
+
+  if (result.isSuccess) {
+    print("接受呼叫成功，房间ID: $roomID");
+  } else {
+    print("接受呼叫失败: [错误码: ${result.errorCode}] ${result.errorMessage}");
+  }
+}
+
+// 拒绝呼叫邀请
+Future<void> rejectCall(String roomID, {CallRejectionReason reason = CallRejectionReason.rejected}) async {
+  final result = await RoomStore.shared.rejectCall(
+    roomID: roomID,
+    reason: reason,
+  );
+
+  if (result.isSuccess) {
+    print("拒绝呼叫成功，房间ID: $roomID");
+  } else {
+    print("拒绝呼叫失败: [错误码: ${result.errorCode}] ${result.errorMessage}");
+  }
+}
+```
+
+## API 文档
+| <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API 文档</strong> |
+| --- | --- | --- |
+| <strong>RoomStore</strong> | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 预定房间 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html">API 文档</a> |

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

@@ -3,9 +3,9 @@
 ## 房间模式说明
 
 在开始使用成员管理功能之前，需要了解 `AtomicXCore` 中房间模块支持的两种房间模式，不同模式下的成员管理功能有所区别：
-| **标准房间模式（Standard Room）** | **网络研讨会房间模式（Webinar Room）** |
+| <strong>标准房间模式（Standard Room）</strong> | <strong>网络研讨会房间模式（Webinar Room）</strong> |
 | --- | --- |
-| - **适用场景：**小型会议、团队协作、朋友聊天等。<br>- **成员特点：**所有成员都是参与者，可以自由开启/关闭音视频设备。<br>- **管理特点：**扁平化管理，房主可设置管理员进行协助管理。 | - **适用场景**：网络研讨会、在线培训等。<br>- **成员特点**：<br>- **嘉宾（Participants）**：可以开启音视频设备，参与互动。<br>- **观众（Audience）**：只能观看，无法开启音视频设备。<br>- **管理特点**：分层管理，支持观众与嘉宾身份转换。 |
+| - <strong>适用场景：</strong>小型会议、团队协作、朋友聊天等。<br>- <strong>成员特点：</strong>所有成员都是参与者，可以自由开启/关闭音视频设备。<br>- <strong>管理特点：</strong>扁平化管理，房主可设置管理员进行协助管理。 | - <strong>适用场景</strong>：网络研讨会、在线培训等。<br>- <strong>成员特点</strong>：<br>- <strong>嘉宾（Participants）</strong>：可以开启音视频设备，参与互动。<br>- <strong>观众（Audience）</strong>：只能观看，无法开启音视频设备。<br>- <strong>管理特点</strong>：分层管理，支持观众与嘉宾身份转换。 |
 
 ## 核心功能
 - **获取参与者列表**：获取并展示当前房间内所有参与者信息。
@@ -29,28 +29,29 @@
 - **音视频设备管理**：支持申请/邀请打开摄像头、麦克风，关闭远端摄像头、麦克风，以及房主和管理员设置全体静音，全体禁用摄像头功能。
 
 ## 功能对比
-| **功能** | **标准房间模式** | **网络研讨会房间模式** |
-| --- | --- | --- |
-| 获取参与者列表 | 获取所有房间成员 | 获取嘉宾列表 |
-| 获取观众列表 | 不适用 | 获取观众列表 |
-| 搜索房间内成员 | 支持 | 支持 |
-| 将观众提升为嘉宾 | 不适用 | 支持 |
-| 将嘉宾降级为观众 | 不适用 | 支持 |
-| 转移房主身份 | 支持 | 支持 |
-| 设置/撤销管理员 | 支持 | 支持 |
-| 移出房间 | 支持 | 支持 |
-| 更新参与者信息 | 支持 | 支持 |
-| 音视频设备管理 | 支持 | 支持 |
+
+|**功能**|**标准房间模式**|**网络研讨会房间模式**|
+|---------|---------|---------|
+|获取参与者列表|获取所有房间成员|获取嘉宾列表|
+|获取观众列表|不适用|获取观众列表|
+|搜索房间内成员|支持|支持|
+|将观众提升为嘉宾|不适用|支持|
+|将嘉宾降级为观众|不适用|支持|
+|转移房主身份|支持|支持|
+|设置/撤销管理员|支持|支持|
+|移出房间|支持|支持|
+|更新参与者信息|支持|支持|
+|音视频设备管理|支持|支持|
 
 ## 核心概念
 
 在开始集成之前，需要通过下表了解 `RoomParticipantStore` 相关的核心概念：
-| **核心概念** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>核心职责与描述</strong> |
 | --- | --- |
-| [RoomParticipant](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipant-class.html) | 代表参与者的核心数据模型，封装了参与者的完整信息和状态管理能力。<br>核心功能包括：<br>- 参与者基本信息管理（用户 ID、用户名称、用户头像、房间内角色身份）。<br>- 参与者设备状态管理（麦克风状态，摄像头状态，屏幕分享状态，消息状态）。 |
-| [RoomParticipantState](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantState-class.html) | 代表参与者状态管理的核心数据结构，负责维护房间内与参与者相关状态信息。<br>核心属性：<br>- `participantList` 存储了当前所在房间的所有参与者信息集合。<br>- `participantListCursor` 代表房间内参与者列表的分页快照。<br>- `localParticipant`代表自身所在房间内的参与者信息。 |
-| [RoomParticipantListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantListener-class.html) | 代表房间内和参与者相关的实时事件。主要事件分为三大类：参与者进退房事件、 参与者身份改变事件，参与者设备控制事件。 |
-| [RoomParticipantStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantStore-class.html) | 这是参与者控制相关的核心类。功能包含：控制房间内参与者音视频状态、执行参与者管理操作，并通过 `addRoomParticipantListener` 方法来接收实时事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipant-class.html">RoomParticipant</a> | 代表参与者的核心数据模型，封装了参与者的完整信息和状态管理能力。<br>核心功能包括：<br>- 参与者基本信息管理（用户 ID、用户名称、用户头像、房间内角色身份）。<br>- 参与者设备状态管理（麦克风状态，摄像头状态，屏幕分享状态，消息状态）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantState-class.html">RoomParticipantState</a> | 代表参与者状态管理的核心数据结构，负责维护房间内与参与者相关状态信息。<br>核心属性：<br>- <code>participantList</code> 存储了当前所在房间的所有参与者信息集合。<br>- <code>participantListCursor</code> 代表房间内参与者列表的分页快照。<br>- <code>localParticipant</code>代表自身所在房间内的参与者信息。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantListener-class.html">RoomParticipantListener</a> | 代表房间内和参与者相关的实时事件。主要事件分为三大类：参与者进退房事件、 参与者身份改变事件，参与者设备控制事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantStore-class.html">RoomParticipantStore</a> | 这是参与者控制相关的核心类。功能包含：控制房间内参与者音视频状态、执行参与者管理操作，并通过 <code>addRoomParticipantListener</code> 方法来接收实时事件。 |
 
 ## 实现步骤
 
@@ -791,6 +792,6 @@ Widget buildSpeakingUsersWidget() {
 ```
 
 ## API 文档
-| **Store** | **功能描述** | **API文档** |
+| <strong>Store</strong> | <strong>功能描述</strong> | <strong>API文档</strong> |
 | --- | --- | --- |
-| **RoomParticipantStore** | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantStore-class.html) |
+| <strong>RoomParticipantStore</strong> | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantStore-class.html">API 文档</a> |

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

@@ -16,12 +16,12 @@
 ## 核心概念
 
 在开始集成之前，需要通过下表了解一下`RoomStore`相关的几个核心概念：
-| **核心概念** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>核心职责与描述</strong> |
 | --- | --- |
-| [RoomInfo](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomInfo-class.html) | 代表房间信息的核心数据模型，封装了房间的完整信息和状态管理能力。<br>核心功能包括：<br>- 房间基本信息管理（房间 ID、名称、创建者）。<br>- 实时状态跟踪（参与者数量、房间状态、创建时间）。<br>- 房间调度功能（预约时间、参会者列表、提醒设置）。<br>- 全面的权限控制（密码保护、设备管控、消息管理）。 |
-| [RoomState](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomState-class.html) | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- `scheduledRoomList` 存储了当前账号下所有预约的房间列表信息。<br>- `scheduledRoomListCursor`  则代表预约房间列表的分页快照。<br>- `currentRoom` 则代表当前所在房间的状态信息。 |
-| [RoomListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener-class.html) | 代表房间动态的实时事件。主要事件分为两大类：预约房间事件和房间结束事件。 |
-| [RoomStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html) | 这是与房间全生命周期相关的核心类。功能包含：获取预约房间列表快照、执行房间管理操作，并通过 `addRoomListener` 方法来接收实时动态事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomInfo-class.html">RoomInfo</a> | 代表房间信息的核心数据模型，封装了房间的完整信息和状态管理能力。<br>核心功能包括：<br>- 房间基本信息管理（房间 ID、名称、创建者）。<br>- 实时状态跟踪（参与者数量、房间状态、创建时间）。<br>- 房间调度功能（预约时间、参会者列表、提醒设置）。<br>- 全面的权限控制（密码保护、设备管控、消息管理）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomState-class.html">RoomState</a> | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- <code>scheduledRoomList</code> 存储了当前账号下所有预约的房间列表信息。<br>- <code>scheduledRoomListCursor</code>  则代表预约房间列表的分页快照。<br>- <code>currentRoom</code> 则代表当前所在房间的状态信息。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener-class.html">RoomListener</a> | 代表房间动态的实时事件。主要事件分为两大类：预约房间事件和房间结束事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html">RoomStore</a> | 这是与房间全生命周期相关的核心类。功能包含：获取预约房间列表快照、执行房间管理操作，并通过 <code>addRoomListener</code> 方法来接收实时动态事件。 |
 
 ## 实现步骤
 
@@ -74,19 +74,20 @@ void createAndJoinRoom() async {
 ##### createAndJoinRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `roomType` | `String` | 是 | 房间类型<br>- standard：标准房间，所有成员可自由音视频互动。<br>- webinar：大型研讨会房间，区分嘉宾和观众角色，观众默认无上麦权限。 |
-| `options` | [CreateRoomOptions](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/CreateRoomOptions-class.html) | 是 | 房间创建选项配置对象。 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>roomType</code> | <code>String</code> | 是 | 房间类型<br>- standard：标准房间，所有成员可自由音视频互动。<br>- webinar：大型研讨会房间，区分嘉宾和观众角色，观众默认无上麦权限。 |
+| <code>options</code> | <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/CreateRoomOptions-class.html">CreateRoomOptions</a> | 是 | 房间创建选项配置对象。 |
 
 ##### CreateRoomOptions 结构体详细说明
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-| --- | --- | --- | --- | --- |
-| roomName | String | 否 | "" | 房间名称。若不设置，系统可能会使用默认名称。 |
-| password | String | 否 | "" | 房间密码。设置后，其他用户加入房间时需输入密码。 |
-| isAllMicrophoneDisabled | bool | 否 | false | 是否全员禁止开启麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。 |
-| isAllCameraDisabled | bool | 否 | false | 是否全员禁止开启摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。 |
-| isAllScreenShareDisabled | bool | 否 | false | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。 |
-| isAllMessageDisabled | bool | 否 | false | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息。 |
+
+|参数名|类型|必填|默认值|说明|
+|---------|---------|---------|---------|---------|
+|roomName|String|否|""|房间名称。若不设置，系统可能会使用默认名称。|
+|password|String|否|""|房间密码。设置后，其他用户加入房间时需输入密码。|
+|isAllMicrophoneDisabled|bool|否|false|是否全员禁止开启麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。|
+|isAllCameraDisabled|bool|否|false|是否全员禁止开启摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。|
+|isAllScreenShareDisabled|bool|否|false|是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。|
+|isAllMessageDisabled|bool|否|false|是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息。|
 
 ### 步骤3：加入房间
 
@@ -114,9 +115,9 @@ Future<void> joinRoom() async {
 ##### joinRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `roomType` | `RoomType` | 是 | 房间类型<br>- standard：标准房间，所有成员可自由音视频互动。<br>- webinar：大型研讨会房间，区分嘉宾和观众角色，观众默认无上麦权限。 |
-| `password` | `String` | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>roomType</code> | <code>RoomType</code> | 是 | 房间类型<br>- standard：标准房间，所有成员可自由音视频互动。<br>- webinar：大型研讨会房间，区分嘉宾和观众角色，观众默认无上麦权限。 |
+| <code>password</code> | <code>String</code> | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
 
 ### 步骤4：离开房间
 
@@ -205,21 +206,21 @@ Future<void> updateRoomInfo() async {
 ##### updateRoomInfo 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `options` | `UpdateRoomOptions` | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：UpdateRoomOptions 结构体详细说明 |
-| `modifyFlag` | `UpdateRoomOptionsModifyFlag` | 是 | - 更新房间属性修改标志位。目前支持更新**房间名称**、**房间密码**。<br>- 详细用法请参考：UpdateRoomOptionsModifyFlag 详细说明。 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：UpdateRoomOptions 结构体详细说明 |
+| <code>modifyFlag</code> | <code>UpdateRoomOptionsModifyFlag</code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法请参考：UpdateRoomOptionsModifyFlag 详细说明。 |
 
 **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 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
 
 **UpdateRoomOptionsModifyFlag 详细说明**
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomName` | `int` | 否 | - 修改房间名称时的标识位。<br>- 当修改`UpdateRoomOptions`中的`roomName`后，需要同步向`modifyFlagList`中加入`roomName`标识位。 |
-| `password` | `int` | 否 | - 修改房间密码时的标识位。<br>- 当修改`UpdateRoomOptions`中的`password`后，需要同步向`modifyFlagList`中加入`password`标识位。 |
+| <code>roomName</code> | <code>int</code> | 否 | - 修改房间名称时的标识位。<br>- 当修改<code>UpdateRoomOptions</code>中的<code>roomName</code>后，需要同步向<code>modifyFlagList</code>中加入<code>roomName</code>标识位。 |
+| <code>password</code> | <code>int</code> | 否 | - 修改房间密码时的标识位。<br>- 当修改<code>UpdateRoomOptions</code>中的<code>password</code>后，需要同步向<code>modifyFlagList</code>中加入<code>password</code>标识位。 |
 
 ### 步骤7：获取房间信息
 
@@ -298,9 +299,9 @@ ValueListenableBuilder(
 ```
 
 ## API 文档
-| **Store** | **功能描述** | **API文档** |
+| <strong>Store</strong> | <strong>功能描述</strong> | <strong>API文档</strong> |
 | --- | --- | --- |
-| **RoomStore** | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预约 / 呼叫房间外成员 / 监听房间内被动事件（如房间解散，房间信息更新等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html) |
+| <strong>RoomStore</strong> | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预约 / 呼叫房间外成员 / 监听房间内被动事件（如房间解散，房间信息更新等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html">API 文档</a> |
 
 ## 常见问题
 

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

@@ -14,13 +14,13 @@
 ## 核心概念
 
 在开始集成之前，您可能需要通过下表了解一下`RoomStore`中与预定房间相关的几个核心概念：
-| **核心概念** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>核心职责与描述</strong> |
 | --- | --- |
-| [RoomStatus](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStatus.html) | 代表当前房间的状态，包含：`scheduled`（预定状态），`running`（进行中）。 |
-| [ScheduleRoomOptions](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/ScheduleRoomOptions-class.html) | 代表预定房间的核心数据结构，包含：开始时间，结束时间，预定成员列表等。 |
-| [RoomState](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomState-class.html) | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- `scheduledRoomList` 存储了当前账号下所有预定的房间列表信息。<br>- `scheduledRoomListCursor` 则代表预定房间列表的分页游标。 |
-| [RoomListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener-class.html) | 代表房间动态的实时事件。其中包含预定房间相关的事件。 |
-| [RoomStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html) | 这是与房间全生命周期相关的核心类。通过它，您可以主动发起预定房间，获取预定房间列表等功能，并通过 `addRoomListener` 方法来接收与预定房间相关的实时动态事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStatus.html">RoomStatus</a> | 代表当前房间的状态，包含：<code>scheduled</code>（预定状态），<code>running</code>（进行中）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/ScheduleRoomOptions-class.html">ScheduleRoomOptions</a> | 代表预定房间的核心数据结构，包含：开始时间，结束时间，预定成员列表等。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomState-class.html">RoomState</a> | 代表房间状态管理的核心数据结构，负责维护用户的房间相关状态信息。<br>核心属性：<br>- <code>scheduledRoomList</code> 存储了当前账号下所有预定的房间列表信息。<br>- <code>scheduledRoomListCursor</code> 则代表预定房间列表的分页游标。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomListener-class.html">RoomListener</a> | 代表房间动态的实时事件。其中包含预定房间相关的事件。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html">RoomStore</a> | 这是与房间全生命周期相关的核心类。通过它，您可以主动发起预定房间，获取预定房间列表等功能，并通过 <code>addRoomListener</code> 方法来接收与预定房间相关的实时动态事件。 |
 
 ## 实现步骤
 
@@ -78,14 +78,14 @@ Future<void> scheduleRoom() async {
 ##### scheduleRoom 接口参数详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomID` | `String` | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `options` | `ScheduleRoomOptions` | 是 | - 创建房间配置对象。<br>- 详细用法请参考：ScheduleRoomOptions 结构体详细说明 |
+| <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：ScheduleRoomOptions 结构体详细说明 |
 
 ##### ScheduleRoomOptions 结构体详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | roomName | String | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
-| password | String | 否 | - 房间密码，空字符串 `""` 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
+| password | String | 否 | - 房间密码，空字符串 <code>""</code> 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
 | scheduleStartTime | int | 是 | - 预定的房间开始时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于当前时间。<br>- 推荐设置为未来的整分时间。例如：1736164800（代表 2025-01-06 20:00:00）。 |
 | scheduleEndTime | int | 是 | - 预定的房间结束时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于 scheduleStartTime。<br>- 建议根据预期时长设置。例如：scheduleStartTime + 3600（预定 1 小时时长的房间）。 |
 | reminderSecondsBeforeStart | int | 否 | - 房间开始前的提醒时间（单位：秒）。用于系统触发开始提醒。<br>- 推荐设置为 300（5分钟）或 900（15分钟），用于在 App 端触发本地通知。 |
@@ -153,14 +153,14 @@ Future<void> scheduleRoom() async {
 | --- | --- | --- | --- |
 | roomID | String | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
 | options | ScheduleRoomOptions | 是 | - 预定房间配置对象。<br>- 详细用法请参考：ScheduleRoomOptions 结构体详细说明 |
-| modifyFlagList | List<ScheduleRoomOptionsModifyFlag> | 是 | - 更新房间属性修改标志位。目前支持更新**房间名称**、**开始时间**、**结束时间。**<br>- 详细用法请参考：ScheduleRoomOptionsModifyFlag 详细说明。 |
+| modifyFlagList | List<ScheduleRoomOptionsModifyFlag> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>开始时间</strong>、<strong>结束时间。</strong><br>- 详细用法请参考：ScheduleRoomOptionsModifyFlag 详细说明。 |
 
 **ScheduleRoomOptionsModifyFlag 详细说明**
 | 参数名 | 说明 |
 | --- | --- |
-| `roomName` | - 修改预定房间名称时的标识位。<br>- 当修改`ScheduleRoomOptions`中的`roomName`后，需要同步向`modifyFlagList`中添加`roomName`标识位。 |
-| `scheduleStartTime` | - 修改预定房间开始时间时的标识位。<br>- 当修改`ScheduleRoomOptions`中的`scheduleStartTime`后，需要同步向`modifyFlagList`中添加`scheduleStartTime`标识位。 |
-| `scheduleEndTime` | - 修改预定房间结束时间时的标识位。<br>- 当修改`ScheduleRoomOptions`中的`scheduleEndTime`后，需要同步向`modifyFlagList`中添加`scheduleEndTime`标识位。 |
+| <code>roomName</code> | - 修改预定房间名称时的标识位。<br>- 当修改<code>ScheduleRoomOptions</code>中的<code>roomName</code>后，需要同步向<code>modifyFlagList</code>中添加<code>roomName</code>标识位。 |
+| <code>scheduleStartTime</code> | - 修改预定房间开始时间时的标识位。<br>- 当修改<code>ScheduleRoomOptions</code>中的<code>scheduleStartTime</code>后，需要同步向<code>modifyFlagList</code>中添加<code>scheduleStartTime</code>标识位。 |
+| <code>scheduleEndTime</code> | - 修改预定房间结束时间时的标识位。<br>- 当修改<code>ScheduleRoomOptions</code>中的<code>scheduleEndTime</code>后，需要同步向<code>modifyFlagList</code>中添加<code>scheduleEndTime</code>标识位。 |
 
 #### **四、添加、删除参与成员**
 - **预定房间者：**调用 `RoomStore` 的 `addScheduledAttendees` 或者 `removeScheduledAttendees` 接口，可以为已预定的房间内批量添加或移除预定参与者。
@@ -298,9 +298,10 @@ Future<void> scheduleRoom() async {
    ```
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API文档** |
-| --- | --- | --- |
-| **RoomStore** | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预定 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html) |
+
+|**Store/Component**|**功能描述**|**API文档**|
+|---------|---------|---------|
+|**RoomStore**|房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预定 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html)|
 
 ## 常见问题
 

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

@@ -8,14 +8,14 @@
 ## 核心概念
 
 在开始集成之前，需要通过下表了解一下`RoomStore`中与会中呼叫相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| [RoomCallStatus](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomcallstatus) | `enum` | 代表会中呼叫的状态，包含：<br>- `none`（默认态）。<br>- `calling`（呼叫中）。<br>- `timeout`（呼叫超时）。<br>- `rejected`（呼叫被拒绝）。 |
-| [RoomCallResult](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomcallresult) | `enum` | 代表会中呼叫的结果，包含：<br>- `success`（呼叫成功）。<br>- `alreadyInCalling`（已在呼叫中）。<br>- `alreadyInRoom`（已在房间中）。 |
-| [CallRejectionReason](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callrejectionreason) | `enum` | 代表呼叫被拒绝的原因，目前仅支持：<br>- `rejected`（主动拒绝）。<br>- `inOtherRoom`（在其他房间中）。 |
-| [RoomCall](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomcall) | `struct` | 代表会中呼叫业务的核心数据结构。负责存储呼叫者信息、被呼叫者信息、以及当前呼叫状态。 |
-| [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/roomcallstatus">RoomCallStatus</a> | <code>enum</code> | 代表会中呼叫的状态，包含：<br>- <code>none</code>（默认态）。<br>- <code>calling</code>（呼叫中）。<br>- <code>timeout</code>（呼叫超时）。<br>- <code>rejected</code>（呼叫被拒绝）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomcallresult">RoomCallResult</a> | <code>enum</code> | 代表会中呼叫的结果，包含：<br>- <code>success</code>（呼叫成功）。<br>- <code>alreadyInCalling</code>（已在呼叫中）。<br>- <code>alreadyInRoom</code>（已在房间中）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/callrejectionreason">CallRejectionReason</a> | <code>enum</code> | 代表呼叫被拒绝的原因，目前仅支持：<br>- <code>rejected</code>（主动拒绝）。<br>- <code>inOtherRoom</code>（在其他房间中）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomcall">RoomCall</a> | <code>struct</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> 来接收与会中呼叫相关的实时动态事件。 |
 
 ## 实现步骤
 
@@ -120,12 +120,13 @@ private func subscribeRoomCallEvents() {
 ```
 
 **呼叫事件函数详细说明**
-| 事件函数 | 触发时机与说明 |
-| --- | --- |
-| [onCallTimeout](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncalltimeout(roominfo:call:)) | 呼叫超时。当呼叫请求在预设的时间内（由调用 callUserToRoom 时指定）未得到被呼叫方的响应时触发。此时，呼叫自动结束，呼叫方通常需要提示“对方无人接听”。 |
-| [onCallAccepted](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallaccepted(roominfo:call:)) | 呼叫被接受。被呼叫方主动点击了“接听”或“接受”按钮。收到此回调后，表示双方已达成呼叫意图，呼叫方通常应立即执行进入房间或开始推流的操作。 |
-| [onCallRejected](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallrejected(roominfo:call:reason:)) | 呼叫被拒绝。被呼叫方主动拒绝了通话请求，或者因为被呼叫方当前正处于其他房间中而自动拒绝。回调中通常包含拒绝原因（如主动拒绝或在其他房间中）。 |
-| [onCallHandledByOtherDevice](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallhandledbyotherdevice(roominfo:isaccepted:)) | 呼叫已在其他设备处理。当用户在多个设备（例如手机和 iPad）同时登录时，如果呼叫已在其中一台设备上被处理（接受或拒绝），当前设备会收到此通知，用于同步 UI 状态并自动消除呼叫界面。 |
+
+|事件函数|触发时机与说明|
+|---------|---------|
+|[onCallTimeout](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncalltimeout(roominfo:call:))|呼叫超时。当呼叫请求在预设的时间内（由调用 callUserToRoom 时指定）未得到被呼叫方的响应时触发。此时，呼叫自动结束，呼叫方通常需要提示“对方无人接听”。|
+|[onCallAccepted](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallaccepted(roominfo:call:))|呼叫被接受。被呼叫方主动点击了“接听”或“接受”按钮。收到此回调后，表示双方已达成呼叫意图，呼叫方通常应立即执行进入房间或开始推流的操作。|
+|[onCallRejected](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallrejected(roominfo:call:reason:))|呼叫被拒绝。被呼叫方主动拒绝了通话请求，或者因为被呼叫方当前正处于其他房间中而自动拒绝。回调中通常包含拒绝原因（如主动拒绝或在其他房间中）。|
+|[onCallHandledByOtherDevice](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallhandledbyotherdevice(roominfo:isaccepted:))|呼叫已在其他设备处理。当用户在多个设备（例如手机和 iPad）同时登录时，如果呼叫已在其中一台设备上被处理（接受或拒绝），当前设备会收到此通知，用于同步 UI 状态并自动消除呼叫界面。|
 
 ### 步骤3：被呼叫方功能
 
@@ -162,11 +163,12 @@ private func subscribeRoomCallEvents() {
 ```
 
 **事件函数详细说明**
-| 事件函数 | 触发时机与说明 |
-| --- | --- |
-| [onCallReceived](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallreceived(roominfo:call:extensioninfo:)) | 收到呼叫邀请。当有其他用户向您发起入会邀请时触发。收到此回调后，被呼叫方通常应立即弹出“呼叫提醒”界面，展示呼叫者信息、房间信息，并提供“接听”和“拒绝”按钮。 |
-| [onCallCancelled](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallcancelled(roominfo:call:)) | 呼叫被发起方取消。呼叫方在您未做出响应前，主动撤回了呼叫请求。收到此回调后，被呼叫方应立即关闭当前的来电界面，并提示“对方已取消呼叫”，以恢复应用正常操作流程。 |
-| [onCallRevokedByAdmin](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallrevokedbyadmin(roominfo:call:operator:)) | 呼叫被管理员撤销。房间管理员或后台系统因权限变更、房间解散等原因强行终止了该笔呼叫邀请。收到此通知后，被呼叫方需立即停止呼叫流程并隐藏相关 UI，处理逻辑通常类似于呼叫被取消。 |
+
+|事件函数|触发时机与说明|
+|---------|---------|
+|[onCallReceived](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallreceived(roominfo:call:extensioninfo:))|收到呼叫邀请。当有其他用户向您发起入会邀请时触发。收到此回调后，被呼叫方通常应立即弹出“呼叫提醒”界面，展示呼叫者信息、房间信息，并提供“接听”和“拒绝”按钮。|
+|[onCallCancelled](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallcancelled(roominfo:call:))|呼叫被发起方取消。呼叫方在您未做出响应前，主动撤回了呼叫请求。收到此回调后，被呼叫方应立即关闭当前的来电界面，并提示“对方已取消呼叫”，以恢复应用正常操作流程。|
+|[onCallRevokedByAdmin](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomevent/oncallrevokedbyadmin(roominfo:call:operator:))|呼叫被管理员撤销。房间管理员或后台系统因权限变更、房间解散等原因强行终止了该笔呼叫邀请。收到此通知后，被呼叫方需立即停止呼叫流程并隐藏相关 UI，处理逻辑通常类似于呼叫被取消。|
 
 #### **2. 接受呼叫、拒绝呼叫**
 
@@ -221,6 +223,6 @@ func rejectCall(roomID: String, reason: CallRejectionReason = .rejected) {
 ```
 
 ## 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> |