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

package/resource/{doc → knowledge}/livekit/core-sdk/voice/flutter/voice-gift.md

@@ -1,7 +1,8 @@
 `GiftStore` 是 `AtomicXCore` 中专门负责管理直播间礼物功能的模块。通过它，您可以为您的直播应用构建一套完整的礼物系统，实现丰富的营收和互动场景。
-| **礼物面板** | **弹幕礼物** | **全屏礼物** |
-| --- | --- | --- |
-|  |  |  |
+
+|**礼物面板**|**弹幕礼物**|**全屏礼物**|
+|---------|---------|---------|
+||||
 
 ## 核心功能
 - **礼物列表获取**：从服务端拉取礼物面板所需的数据，包括礼物分类和礼物详情。
@@ -13,19 +14,21 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `GiftStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| [Gift](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/Gift-class.html) | `class` | 代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。 |
-| [GiftCategory](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftCategory-class.html) | `class` | 代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift** 列表。 |
-| [GiftState](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftState-class.html) | `class` | 代表礼物模块的当前状态。其核心属性 `usableGifts` 是一个 `ValueListenable<List<GiftCategory>>`，存储了从服务端拉取到的完整礼物列表。 |
-| [GiftListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftListener-class.html) | `class` | 礼物事件监听器，通过 `onReceiveGift` 回调接收礼物赠送事件，当有任何人（包括自己）发送礼物时，房间内所有人都会收到此事件。 |
-| [GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html) | `class` | 这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、发送礼物，并通过 `addGiftListener` 来接收礼物事件。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|[Gift](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/Gift-class.html)|`class`|代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。|
+|[GiftCategory](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftCategory-class.html)|`class`|代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift** 列表。|
+|[GiftState](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftState-class.html)|`class`|代表礼物模块的当前状态。其核心属性 `usableGifts` 是一个 `ValueListenable<List<GiftCategory>>`，存储了从服务端拉取到的完整礼物列表。|
+|[GiftListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftListener-class.html)|`class`|礼物事件监听器，通过 `onReceiveGift` 回调接收礼物赠送事件，当有任何人（包括自己）发送礼物时，房间内所有人都会收到此事件。|
+|[GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html)|`class`|这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、发送礼物，并通过 `addGiftListener` 来接收礼物事件。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 开始直播 集成 **AtomicXCore**，完成接入。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：初始化并监听礼物事件
 
@@ -95,26 +98,26 @@ class GiftManager {
 #### 礼物列表结构体参数
 - `GiftCategory`**参数说明**
 
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `categoryID` | `String` | 礼物分类的唯一 ID。 |
-| `name` | `String` | 礼物分类的显示名称。 |
-| `desc` | `String` | 礼物分类的描述信息。 |
-| `extensionInfo` | `Map<String, String>` | 扩展信息字段。 |
-| `giftList` | `List<Gift>` | 该分类下包含的 Gift 礼物对象数组。 |
+   |**参数**|**类型**|**描述**|
+   |---------|---------|---------|
+   |`categoryID`|`String`|礼物分类的唯一 ID。|
+   |`name`|`String`|礼物分类的显示名称。|
+   |`desc`|`String`|礼物分类的描述信息。|
+   |`extensionInfo`|`Map<String, String>`|扩展信息字段。|
+   |`giftList`|`List<Gift>`|该分类下包含的 Gift 礼物对象数组。|
 
 - `Gift`**参数说明**
 
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `giftID` | `String` | 礼物的唯一 ID。 |
-| `name` | `String` | 礼物的显示名称。 |
-| `desc` | `String` | 礼物的描述信息。 |
-| `iconURL` | `String` | 礼物图标 URL。 |
-| `resourceURL` | `String` | 礼物动画资源 URL。 |
-| `level` | `int` | 礼物等级。 |
-| `coins` | `int` | 礼物价格。 |
-| `extensionInfo` | `Map<String, String>` | 扩展信息字段。 |
+   |**参数**|**类型**|**描述**|
+   |---------|---------|---------|
+   |`giftID`|`String`|礼物的唯一 ID。|
+   |`name`|`String`|礼物的显示名称。|
+   |`desc`|`String`|礼物的描述信息。|
+   |`iconURL`|`String`|礼物图标 URL。|
+   |`resourceURL`|`String`|礼物动画资源 URL。|
+   |`level`|`int`|礼物等级。|
+   |`coins`|`int`|礼物价格。|
+   |`extensionInfo`|`Map<String, String>`|扩展信息字段。|
 
 ### 步骤3：获取礼物列表
 
@@ -172,10 +175,11 @@ extension GiftManagerSend on GiftManager {
 ```
 
 #### `sendGift` 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `giftID` | `String` | 要发送的礼物的唯一 ID。 |
-| `count` | `int` | 发送的数量。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`giftID`|`String`|要发送的礼物的唯一 ID。|
+|`count`|`int`|发送的数量。|
 
 ## 功能进阶
 
@@ -195,23 +199,24 @@ extension GiftManagerSend on GiftManager {
 #### **配置时序图**
 
 #### **涉及 REST API 接口一览**
-| **接口分类** | **接口** | **请求示例** |
-| --- | --- | --- |
-| 礼物管理 | 添加礼物信息 | 请求示例 |
-| 礼物管理 | 删除礼物信息 | 请求示例 |
-| 礼物管理 | 查询礼物信息 | 请求示例 |
-| 礼物分类管理 | 添加礼物分类信息 | 请求示例 |
-| 礼物分类管理 | 删除指定礼物分类信息 | 请求示例 |
-| 礼物分类管理 | 获取指定礼物分类信息 | 请求示例 |
-| 礼物关系管理 | 添加指定礼物分类和礼物间的关系 | 请求示例 |
-| 礼物关系管理 | 删除指定礼物分类和礼物间的关系 | 请求示例 |
-| 礼物关系管理 | 获取指定礼物分类下的礼物关系 | 请求示例 |
-| 礼物多语言管理 | 添加礼物多语言信息 | 请求示例 |
-| 礼物多语言管理 | 删除指定礼物多语言信息 | 请求示例 |
-| 礼物多语言管理 | 获取礼物多语言信息 | 请求示例 |
-| 礼物多语言管理 | 添加礼物分类多语言信息 | 请求示例 |
-| 礼物多语言管理 | 删除指定礼物分类多语言信息 | 请求示例 |
-| 礼物多语言管理 | 获取礼物分类多语言信息 | 请求示例 |
+
+|**接口分类**|**接口**|**请求示例**|
+|---------|---------|---------|
+|礼物管理|添加礼物信息|请求示例|
+|礼物管理|删除礼物信息|请求示例|
+|礼物管理|查询礼物信息|请求示例|
+|礼物分类管理|添加礼物分类信息|请求示例|
+|礼物分类管理|删除指定礼物分类信息|请求示例|
+|礼物分类管理|获取指定礼物分类信息|请求示例|
+|礼物关系管理|添加指定礼物分类和礼物间的关系|请求示例|
+|礼物关系管理|删除指定礼物分类和礼物间的关系|请求示例|
+|礼物关系管理|获取指定礼物分类下的礼物关系|请求示例|
+|礼物多语言管理|添加礼物多语言信息|请求示例|
+|礼物多语言管理|删除指定礼物多语言信息|请求示例|
+|礼物多语言管理|获取礼物多语言信息|请求示例|
+|礼物多语言管理|添加礼物分类多语言信息|请求示例|
+|礼物多语言管理|删除指定礼物分类多语言信息|请求示例|
+|礼物多语言管理|获取礼物分类多语言信息|请求示例|
 
 ### 计费与送礼扣费流程
 
@@ -229,9 +234,10 @@ extension GiftManagerSend on GiftManager {
 #### 调用流程图
 
 #### 涉及 REST API 接口一览
-| **接口** | **说明** | **请求示例** |
-| --- | --- | --- |
-| 回调配置 - 发送礼物之前回调 | 客户后台可以通过该回调决定是否通过送礼前校验等场景 | 调用示例 |
+
+|**接口**|**说明**|**请求示例**|
+|---------|---------|---------|
+|回调配置 - 发送礼物之前回调|客户后台可以通过该回调决定是否通过送礼前校验等场景|调用示例|
 
 ### 播放全屏礼物动画
 
@@ -240,13 +246,14 @@ extension GiftManagerSend on GiftManager {
 #### 实现方式
 
 `AtomicXCore` 本身不包含礼物动画播放器，您需要根据业务需求选择并集成第三方库。以下是两种方案的对比：
-| **对比项** | **基础方案 (svgaplayer_flutter)** | **高级方案 (TCEffectPlayerKit)** |
-| --- | --- | --- |
-| 计费 | 免费 (开源库) | 付费 (需购买 License)，请参见 [付费指引](https://cloud.tencent.com/document/product/616/116461) |
-| 集成方式 | 需手动集成 [svgaplayer_flutter](https://pub.dev/packages/svgaplayer_flutter) 库 | 需额外集成 [flutter_effect_player](https://github.com/Tencent-RTC/EffectPlayer_Flutter)库并进行鉴权 |
-| 动画格式支持 | 仅支持 SVGA | SVGA、PAG、WebP、Lottie、MP4 等多种格式 |
-| 性能 | 建议 SVGA 文件 ≤ 10MB | 支持更大的动画文件，复杂特效/多动画并发/低端机表现更优 |
-| 推荐场景 | 礼物动画格式统一为 SVGA，且文件大小可控 | 需要支持多种动画格式，或对动画性能/设备兼容性有更高要求 |
+
+|**对比项**|**基础方案 (svgaplayer_flutter)**|**高级方案 (TCEffectPlayerKit)**|
+|---------|---------|---------|
+|计费|免费 (开源库)。|付费 (需购买 License)，请参见 [付费指引](https://cloud.tencent.com/document/product/616/116461)。|
+|集成方式|需手动集成 [svgaplayer_flutter](https://pub.dev/packages/svgaplayer_flutter) 库。|需额外集成 [flutter_effect_player](https://github.com/Tencent-RTC/EffectPlayer_Flutter) 库并进行鉴权。|
+|动画格式支持|仅支持 SVGA。|SVGA、PAG、WebP、Lottie、MP4 等多种格式。|
+|性能|建议 SVGA 文件 ≤ 10MB。|支持更大的动画文件，复杂特效/多动画并发/低端机表现更优。|
+|推荐场景|礼物动画格式统一为 SVGA，且文件大小可控。|需要支持多种动画格式，或对动画性能/设备兼容性有更高要求。|
 
 本章节主要演示基础方案的集成。如果您选择高级方案，请参考 [EffectPlayer Flutter 集成指引](https://cloud.tencent.com/document/product/616/123945)。
 
@@ -385,10 +392,11 @@ void _setupGiftToBarrageFlow() {
 ## API 文档
 
 关于 [GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **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) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**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)|
 
 ## 常见问题
 
@@ -403,7 +411,8 @@ void _setupGiftToBarrageFlow() {
 ### 我调用 sendGift 发送了礼物，礼物动画为什么重复播放了两次？
 
 `onReceiveGift` 事件是对房间内所有成员的广播（包括发送者自己）。如果您在 `sendGift` 的成功回调里执行了一次 UI 操作，同时又在 `onReceiveGift` 回调中执行了相同的 UI 操作，就会造成重复。
-- **最佳实践**：UI 的更新（例如播放动画、弹幕提示）只在 `onReceiveGift` 事件的回调中处理。`sendGift` 的返回结果仅用于处理发送失败的逻辑（例如提示用户“发送失败”或“余额不足”）。
+
+**实践**：UI 的更新（例如播放动画、弹幕提示）只在 `onReceiveGift` 事件的回调中处理。`sendGift` 的返回结果仅用于处理发送失败的逻辑（例如提示用户“发送失败”或“余额不足”）。
 
 ### 礼物扣费逻辑在哪里实现？
 

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

@@ -3,12 +3,12 @@
 ## 核心概念
 
 在开始集成之前，请先通过下表了解一下 `LiveSeatStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| [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`（摄像头状态）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatStore-class.html">LiveSeatStore</a> | <code>class</code> | 麦位管理核心，负责管理房间内的所有麦位信息和麦位相关操作。<br>通过 <code>liveSeatState.seatList</code> 暴露实时的麦位列表数据流。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatState-class.html">LiveSeatState</a> | <code>class</code> | 代表麦位的当前状态。<br>- <code>seatList</code> 是一个 <code>ValueListenable<List<SeatInfo>></code> 类型，存储了麦位列表的实时状态；<br>- <code>speakingUsers</code> 则代表当前正在说话的人和对应的音量。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/SeatInfo-class.html">SeatInfo</a> | <code>class</code> | 单个麦位的数据模型。<code>LiveSeatStore</code> 所推送的麦位列表（<code>seatList</code>）就是由多个 <code>SeatInfo</code> 对象组成的。关键字段：<br>- <code>index</code>（麦位的索引）。<br>- <code>isLocked</code>（麦位是否被锁定）。<br>- <code>userInfo</code>（麦位上的用户信息，如果麦位为空，此字段也为空对象）。 |
+| <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/SeatUserInfo-class.html">SeatUserInfo</a> | <code>class</code> | 麦上用户的详细数据模型。当一个用户成功上麦后，<code>SeatInfo</code> 中的 <code>userInfo</code> 字段就会被填充为此用户。关键字段：<br>- <code>userID</code>（用户的唯一 ID）<br>- <code>userName</code>（用户的昵称）<br>- <code>avatarURL</code>（用户的头像 URL）<br>- <code>microphoneStatus</code>（麦克风状态）<br>- <code>cameraStatus</code>（摄像头状态）。 |
 
 ## 准备工作
 
@@ -21,7 +21,7 @@
 
    ``` yaml
    dependencies:
-     atomic_x_core: ^3.6.0
+     atomic_x_core: ^4.0.1
    ```
 2. **配置工程权限：**Android 和 iOS 工程都需要配置权限。
 
@@ -93,11 +93,11 @@ void main() async {
 ```
 
 **登录接口参数说明：**
-| **参数** | **类型** | **说明** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>说明</strong> |
 | --- | --- | --- |
-| `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)。 |
+| <code>sdkAppID</code> | <code>int</code> | 从 <a href="https://console.cloud.tencent.com/trtc">控制台</a> 获取，通常是以 <code>140</code> 或 <code>160</code> 开头的 10 位整数。 |
+| <code>userID</code> | <code>String</code> | 当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。为避免多端登录冲突，<strong>请勿使用</strong><code>1</code>、<code>123</code><strong>等简单 ID</strong>。 |
+| <code>userSig</code> | <code>String</code> | 用于腾讯云鉴权的票据。请注意：<br>- 开发环境：您可以采用本地 <code>GenerateTestUserSig.genTestSig</code> 函数生成 userSig 或者通过 <a href="https://console.cloud.tencent.com/im/tool-usersig">UserSig 辅助工具</a> 生成临时的 UserSig。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 UserSig 的方式。详细信息请参考 <a href="https://cloud.tencent.com/document/product/647/17275">服务端生成 UserSig</a>。<br>更多信息请参见 <a href="https://cloud.tencent.com/document/product/647/17275">如何计算及使用 UserSig</a>。 |
 
 ## 构建基础语聊房应用
 
@@ -223,20 +223,21 @@ class _YourAnchorPageState extends State<YourAnchorPage> {
 ```
 
 **LiveInfo 参数说明：**
-| **参数名** | **类型** | **属性** | **描述** |
-| --- | --- | --- | --- |
-| `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`：否）。 |
+
+|**参数名**|**类型**|**属性**|**描述**|
+|---------|---------|---------|---------|
+|`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 界面
 
@@ -524,27 +525,29 @@ class YourSpeakingIndicatorWidget extends StatelessWidget {
 ## 丰富语聊房场景
 
 当您完成了基础的语聊房功能后，您可以参考以下功能指南来为语聊房添加丰富的互动玩法。
-| **功能** | **功能介绍** | **功能 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) | 实现礼物功能 |
+
+|**功能**|**功能介绍**|**功能 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 文档
-| **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) |
+
+|**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)|
 
 ## 常见问题