npm - @tencentcloud/sdk-mcp - Versions diffs - 1.3.9 → 1.4.0 - Mend

@tencentcloud/sdk-mcp 1.3.9 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (510) hide show

package/resource/doc/livekit/{voice → core-sdk/voice}/flutter/voice-integration.md RENAMED Viewed

@@ -3,54 +3,18 @@
 ## 核心概念
 在开始集成之前，请先通过下表了解一下 `LiveSeatStore` 相关的几个核心概念：
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**核心概念**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**核心职责与描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >[LiveSeatStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatStore-class.html)</td>
-<td rowspan="1" colSpan="1" >`class`</td>
-<td rowspan="1" colSpan="1" >麦位管理核心，负责管理房间内的所有麦位信息和麦位相关操作。<br>通过 `liveSeatState.seatList` 暴露实时的麦位列表数据流。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >[LiveSeatState](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatState-class.html)</td>
-<td rowspan="1" colSpan="1" >`class`</td>
-<td rowspan="1" colSpan="1" >代表麦位的当前状态。<br>- `seatList` 是一个 `ValueListenable<List<SeatInfo>>` 类型，存储了麦位列表的实时状态；<br>- `speakingUsers` 则代表当前正在说话的人和对应的音量。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >[SeatInfo](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/SeatInfo-class.html)</td>
-<td rowspan="1" colSpan="1" >`class`</td>
-<td rowspan="1" colSpan="1" >单个麦位的数据模型。`LiveSeatStore` 所推送的麦位列表（`seatList`）就是由多个 `SeatInfo` 对象组成的。关键字段：<br>- `index`（麦位的索引）。<br>- `isLocked`（麦位是否被锁定）。<br>- `userInfo`（麦位上的用户信息，如果麦位为空，此字段也为空对象）。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >[SeatUserInfo](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/SeatUserInfo-class.html)</td>
-<td rowspan="1" colSpan="1" >`class`</td>
-<td rowspan="1" colSpan="1" >麦上用户的详细数据模型。当一个用户成功上麦后，`SeatInfo` 中的 `userInfo` 字段就会被填充为此用户。关键字段：<br>- `userID`（用户的唯一 ID）<br>- `userName`（用户的昵称）<br>- `avatarURL`（用户的头像 URL）<br>- `microphoneStatus`（麦克风状态）<br>- `cameraStatus`（摄像头状态）。</td>
-</tr>
-</table>
+| **核心概念** | **类型** | **核心职责与描述** |
+| --- | --- | --- |
+| [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatStore-class.html) | `class` | 麦位管理核心，负责管理房间内的所有麦位信息和麦位相关操作。<br>通过 `liveSeatState.seatList` 暴露实时的麦位列表数据流。 |
+| [LiveSeatState](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatState-class.html) | `class` | 代表麦位的当前状态。<br>- `seatList` 是一个 `ValueListenable<List<SeatInfo>>` 类型，存储了麦位列表的实时状态；<br>- `speakingUsers` 则代表当前正在说话的人和对应的音量。 |
+| [SeatInfo](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/SeatInfo-class.html) | `class` | 单个麦位的数据模型。`LiveSeatStore` 所推送的麦位列表（`seatList`）就是由多个 `SeatInfo` 对象组成的。关键字段：<br>- `index`（麦位的索引）。<br>- `isLocked`（麦位是否被锁定）。<br>- `userInfo`（麦位上的用户信息，如果麦位为空，此字段也为空对象）。 |
+| [SeatUserInfo](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/SeatUserInfo-class.html) | `class` | 麦上用户的详细数据模型。当一个用户成功上麦后，`SeatInfo` 中的 `userInfo` 字段就会被填充为此用户。关键字段：<br>- `userID`（用户的唯一 ID）<br>- `userName`（用户的昵称）<br>- `avatarURL`（用户的头像 URL）<br>- `microphoneStatus`（麦克风状态）<br>- `cameraStatus`（摄像头状态）。 |
 ## 准备工作
 ### 步骤1：开通服务
-请参见 [开通服务](https://write.woa.com/document/141302177829593088)，获取体验版或付费版 `SDK`。
+请参见 开通服务，获取体验版或付费版 `SDK`。
 ### 步骤2：在当前项目中导入 AtomicXCore
 1. **安装组件**：请在您的 `pubspec.yaml` 文件中添加 `atomic_x_core` 依赖，然后执行 `flutter pub get`。
@@ -61,9 +25,6 @@
    ```
 2. **配置工程权限：**Android 和 iOS 工程都需要配置权限。
 【Android】
 在 `android/app/src/main/AndroidManifest.xml` 文件中添加麦克风的使用权限说明。
@@ -96,16 +57,15 @@ end
 <string>TUILiveKit需要访问您的麦克风权限，开启后录制的视频才会有声音</string>
 ```
 ### 步骤3：实现登录逻辑
 在项目中调用 `LoginStore.shared.login` 完成登录，**这是使用 **`AtomicXCore`** 所有功能的关键前提**。
 > **重要：**
->
+>
 > 推荐在您 App 自身的用户账户登录成功后，再调用 LoginStore.shared.login，以确保登录业务逻辑的清晰和一致。
->
+>
 ``` java
 import 'package:flutter/material.dart';
@@ -133,40 +93,11 @@ void main() async {
 ```
 **登录接口参数说明：**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**说明**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`sdkAppID`</td>
-<td rowspan="1" colSpan="1" >`int`</td>
-<td rowspan="1" colSpan="1" >从 [控制台](https://console.cloud.tencent.com/trtc) 获取，通常是以 `140` 或 `160` 开头的 10 位整数。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`userID`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。为避免多端登录冲突，**请勿使用**`1`、`123`**等简单 ID**。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`userSig`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >用于腾讯云鉴权的票据。请注意：<br>- 开发环境：您可以采用本地 `GenerateTestUserSig.genTestSig` 函数生成 userSig 或者通过 [UserSig 辅助工具](https://console.cloud.tencent.com/im/tool-usersig) 生成临时的 UserSig。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 UserSig 的方式。详细信息请参考 [服务端生成 UserSig](https://cloud.tencent.com/document/product/647/17275)。<br>更多信息请参见 [如何计算及使用 UserSig](https://cloud.tencent.com/document/product/647/17275)。</td>
-</tr>
-</table>
+| **参数** | **类型** | **说明** |
+| --- | --- | --- |
+| `sdkAppID` | `int` | 从 [控制台](https://console.cloud.tencent.com/trtc) 获取，通常是以 `140` 或 `160` 开头的 10 位整数。 |
+| `userID` | `String` | 当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。为避免多端登录冲突，**请勿使用**`1`、`123`**等简单 ID**。 |
+| `userSig` | `String` | 用于腾讯云鉴权的票据。请注意：<br>- 开发环境：您可以采用本地 `GenerateTestUserSig.genTestSig` 函数生成 userSig 或者通过 [UserSig 辅助工具](https://console.cloud.tencent.com/im/tool-usersig) 生成临时的 UserSig。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 UserSig 的方式。详细信息请参考 [服务端生成 UserSig](https://cloud.tencent.com/document/product/647/17275)。<br>更多信息请参见 [如何计算及使用 UserSig](https://cloud.tencent.com/document/product/647/17275)。 |
 ## 构建基础语聊房应用
@@ -268,20 +199,13 @@ class _YourAnchorPageState extends State<YourAnchorPage> {
     // 1. 准备 LiveInfo 对象
     final liveInfo = LiveInfo(
       // 2. 设置房间 id
-      liveID: _liveID,
+      liveID: '',
       // 3. 设置房间名称
       liveName: "test 语聊房",
-      // 4. 配置为语聊房（启用麦位）
-      isSeatEnabled: true,
-      // 5. 房主默认上麦
-      keepOwnerOnSeat: true,
-      // 6. 设置麦位布局模板（例如 70 为 10 麦位模板）
-      // 重要：请根据产品规范传入正确的 ID
-      seatLayoutTemplateID: 70,
-      // 7. 设置上麦模式，例如申请上麦
+      // 4. 设置语聊房布局模板（传入 9 即代表有 9 个麦位）（启用麦位）
+      seatTemplate: AudioSalon(9),
+      // 5. 设置上麦模式，例如申请上麦
       seatMode: TakeSeatMode.apply,
-      // 8. 设置最大麦位数
-      maxSeatCount: 10,
     );
     // 9. 调用 createLive 开始直播
@@ -299,177 +223,28 @@ class _YourAnchorPageState extends State<YourAnchorPage> {
 ```
 **LiveInfo 参数说明：**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数名**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**属性**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`liveID`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >必填</td>
-<td rowspan="1" colSpan="1" >直播间的唯一标识符</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`liveName`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >直播间的标题</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`notice`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >直播间的公告信息</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`isMessageDisable`</td>
-<td rowspan="1" colSpan="1" >`bool`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >是否禁言（`true`：是，`false`：否）</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`isPublicVisible`</td>
-<td rowspan="1" colSpan="1" >`bool`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >是否公开可见（`true`：是，`false`：否）</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`isSeatEnabled`</td>
-<td rowspan="1" colSpan="1" >`bool`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >是否启用麦位功能（`true`：是，`false`：否）</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`keepOwnerOnSeat`</td>
-<td rowspan="1" colSpan="1" >`bool`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >是否保持房主在麦位上</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`maxSeatCount`</td>
-<td rowspan="1" colSpan="1" >`int`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >最大麦位数量</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`seatMode`</td>
-<td rowspan="1" colSpan="1" >`TakeSeatMode`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >上麦模式（`free`：自由上麦，`apply`：申请上麦）</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`seatLayoutTemplateID`</td>
-<td rowspan="1" colSpan="1" >`int`</td>
-<td rowspan="1" colSpan="1" >必填</td>
-<td rowspan="1" colSpan="1" >麦位布局模板 `ID`</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`coverURL`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >直播间的封面图片地址</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`backgroundURL`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >直播间的背景图片地址</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`categoryList`</td>
-<td rowspan="1" colSpan="1" >`List<int>`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >直播间的分类标签列表</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`activityStatus`</td>
-<td rowspan="1" colSpan="1" >`int`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >直播活动状态</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`isGiftEnabled`</td>
-<td rowspan="1" colSpan="1" >`bool`</td>
-<td rowspan="1" colSpan="1" >选填</td>
-<td rowspan="1" colSpan="1" >是否启用礼物功能（`true`：是，`false`：否）</td>
-</tr>
-</table>
+| **参数名** | **类型** | **属性** | **描述** |
+| --- | --- | --- | --- |
+| `liveID` | `String` | 必填 | 直播间的唯一标识符。 |
+| `liveName` | `String` | 选填 | 直播间的标题。 |
+| `notice` | `String` | 选填 | 直播间的公告信息。 |
+| `isMessageDisable` | `bool` | 选填 | 是否禁言（`true`：是，`false`：否）。 |
+| `isPublicVisible` | `bool` | 选填 | 是否公开可见（`true`：是，`false`：否）。 |
+| `seatMode` | `TakeSeatMode` | 选填 | 上麦模式（`free`：自由上麦，`apply`：申请上麦）。 |
+| `seatTemplate` | `SeatLayoutTemplate` | 必填 | 麦位布局模板。 |
+| `coverURL` | `String` | 选填 | 直播间的封面图片地址。 |
+| `backgroundURL` | `String` | 选填 | 直播间的背景图片地址。 |
+| `categoryList` | `List<int>` | 选填 | 直播间的分类标签列表。 |
+| `activityStatus` | `int` | 选填 | 直播活动状态。 |
+| `isGiftEnabled` | `bool` | 选填 | 是否启用礼物功能（`true`：是，`false`：否）。 |
 #### 4. 构建麦位 UI 界面
 > **提示：**
->
+>
 > 麦位 `UI` 效果的业务代码，可参考 `TUILiveKit` 开源项目中的 [seat_grid_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/seat_grid_widget/seat_grid_widget.dart) 文件来了解完整的实现逻辑。
->
+>
 通过 `LiveSeatStore` 实例，监听 `liveSeatState.seatList` 的变化，以实时获取麦位数据来渲染您的 UI。您可以在页面中（例如 `YourAnchorPage` 或 `YourAudiencePage`）通过以下方式监听数据：
 ``` java
@@ -646,7 +421,7 @@ class _YourAudiencePageState extends State<YourAudiencePage> {
 #### 3. 构建麦位 UI 界面
-观众构建麦位 UI 界面的流程与主播完全一致，请参考[构建麦位 UI 界面](https://write.woa.com/#4.-.E6.9E.84.E5.BB.BA.E9.BA.A6.E4.BD.8D-ui-.E7.95.8C.E9.9D.A2)。
+观众构建麦位 UI 界面的流程与主播完全一致，请参考构建麦位 UI 界面。
 #### 4. 退出语聊房
@@ -669,10 +444,7 @@ class _YourAudiencePageState extends State<YourAudiencePage> {
 ### 运行效果
-完成上述步骤后，即可完成一个最基础的语聊直播场景。您可以参考 [丰富语聊房场景](https://write.woa.com/#.E4.B8.B0.E5.AF.8C.E8.AF.AD.E8.81.8A.E6.88.BF.E5.9C.BA.E6.99.AF) 来完善语聊场景。
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100032457995/9b1930a4df3011f0a38652540044a08e.png)
+完成上述步骤后，即可完成一个最基础的语聊直播场景。您可以参考 丰富语聊房场景 来完善语聊场景。
 ## 功能进阶
@@ -680,17 +452,13 @@ class _YourAudiencePageState extends State<YourAudiencePage> {
 在语聊房场景中，一个常见的需求是当麦上用户说话时，在其头像上显示一个波浪动画，以提示全房间用户"谁在说话"，`LiveSeatStore` 提供了 `speakingUsers` 数据流，专门用于实现此功能。
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100032457995/af03283cdf3011f0a4f35254007c27c5.png)
 #### 实现方式
 > **提示：**
->
+>
 > 麦上用户说话时展示波浪动画效果，可参考 `TUILiveKit` 开源项目中的 [seat_grid_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/seat_grid_widget/seat_grid_widget.dart) 文件来了解完整的实现逻辑。
->
+>
 在 `YourAnchorPage` 或 `YourAudiencePage` 中监听 `speakingUsers` 变化，并更新"正在说话"状态，代码示例如下：
 ``` java
@@ -756,156 +524,27 @@ class YourSpeakingIndicatorWidget extends StatelessWidget {
 ## 丰富语聊房场景
 当您完成了基础的语聊房功能后，您可以参考以下功能指南来为语聊房添加丰富的互动玩法。
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**功能**</td>
-<td rowspan="1" colSpan="1" >**功能介绍**</td>
-<td rowspan="1" colSpan="1" >**功能 Stores**</td>
-<td rowspan="1" colSpan="1" >**实现指南**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**实现听众上麦**</td>
-<td rowspan="1" colSpan="1" >听众申请上麦，与房主进行实时语音互动。</td>
-<td rowspan="1" colSpan="1" >[CoGuestStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html)</td>
-<td rowspan="1" colSpan="1" >[观众上麦](https://write.woa.com/document/197477898206908416)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**添加弹幕聊天功能**</td>
-<td rowspan="1" colSpan="1" >房间内成员可以发送和接收实时文字消息。</td>
-<td rowspan="1" colSpan="1" >[BarrageStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageStore-class.html)</td>
-<td rowspan="1" colSpan="1" >[实现弹幕功能](https://write.woa.com/document/200285441364750336)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**构建礼物赠送系统**</td>
-<td rowspan="1" colSpan="1" >观众可以向主播赠送虚拟礼物，增加互动和趣味性。</td>
-<td rowspan="1" colSpan="1" >[GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html)</td>
-<td rowspan="1" colSpan="1" >[实现礼物功能](https://write.woa.com/document/200285576402239488)</td>
-</tr>
-</table>
+| **功能** | **功能介绍** | **功能 Stores** | **实现指南** |
+| --- | --- | --- | --- |
+| **实现听众上麦** | 听众申请上麦，与房主进行实时语音互动。 | [CoGuestStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html) | 观众上麦 |
+| **添加弹幕聊天功能** | 房间内成员可以发送和接收实时文字消息。 | [BarrageStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageStore-class.html) | 实现弹幕功能 |
+| **构建礼物赠送系统** | 观众可以向主播赠送虚拟礼物，增加互动和趣味性。 | [GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html) | 实现礼物功能 |
 ## API 文档
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Store/Component**</td>
-<td rowspan="1" colSpan="1" >**功能描述**</td>
-<td rowspan="1" colSpan="1" >**API 文档**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**LiveListStore**</td>
-<td rowspan="1" colSpan="1" >直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（如被踢出、结束）。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**LiveSeatStore**</td>
-<td rowspan="1" colSpan="1" >麦位管理核心：管理麦位列表、麦上用户状态、麦位相关操作（上麦、下麦、踢人、锁麦、开关麦克风/摄像头等），监听麦位事件。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**DeviceStore**</td>
-<td rowspan="1" colSpan="1" >音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**CoGuestStore**</td>
-<td rowspan="1" colSpan="1" >观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**CoHostStore**</td>
-<td rowspan="1" colSpan="1" >主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_host_store/CoHostStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**BattleStore**</td>
-<td rowspan="1" colSpan="1" >主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_battle_store/BattleStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**GiftStore**</td>
-<td rowspan="1" colSpan="1" >礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**BarrageStore**</td>
-<td rowspan="1" colSpan="1" >弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**LikeStore**</td>
-<td rowspan="1" colSpan="1" >点赞互动：发送点赞，监听点赞事件，同步总点赞数。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_like_store/LikeStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**LiveAudienceStore**</td>
-<td rowspan="1" colSpan="1" >观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_audience_store/LiveAudienceStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**AudioEffectStore**</td>
-<td rowspan="1" colSpan="1" >音频特效：变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectStore-class.html)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**BaseBeautyStore**</td>
-<td rowspan="1" colSpan="1" >基础美颜：调节磨皮 / 美白 / 红润（0-100 级），重置美颜状态，同步效果参数。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_base_beauty_store/BaseBeautyStore-class.html)</td>
-</tr>
-</table>
+| **Store/Component** | **功能描述** | **API 文档** |
+| --- | --- | --- |
+| **LiveListStore** | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-class.html) |
+| **LiveSeatStore** | 麦位管理核心：管理麦位列表、麦上用户状态、麦位相关操作（上麦、下麦、踢人、锁麦、开关麦克风/摄像头等），监听麦位事件。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatStore-class.html) |
+| **DeviceStore** | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html) |
+| **CoGuestStore** | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html) |
+| **CoHostStore** | 主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_host_store/CoHostStore-class.html) |
+| **BattleStore** | 主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_battle_store/BattleStore-class.html) |
+| **GiftStore** | 礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html) |
+| **BarrageStore** | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageStore-class.html) |
+| **LikeStore** | 点赞互动：发送点赞，监听点赞事件，同步总点赞数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_like_store/LikeStore-class.html) |
+| **LiveAudienceStore** | 观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_audience_store/LiveAudienceStore-class.html) |
+| **AudioEffectStore** | 音频特效：变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectStore-class.html) |
+| **BaseBeautyStore** | 基础美颜：调节磨皮 / 美白 / 红润（0-100 级），重置美颜状态，同步效果参数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_base_beauty_store/BaseBeautyStore-class.html) |
 ## 常见问题
@@ -916,7 +555,6 @@ class YourSpeakingIndicatorWidget extends StatelessWidget {
 - **检查网络**：请检查设备网络连接是否正常。
 ### 麦位列表未显示或更新
 - **检查 Store 初始化**：请确保您在 `createLive` 或 `joinLive` 之前，已经使用相同的 `liveID` 正确创建了 `LiveSeatStore` 实例（`LiveSeatStore.create(liveID)`）。