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

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

@@ -17,7 +17,7 @@
 
    ``` yaml
    dependencies:
-     atomic_x_core: ^3.6.0
+     atomic_x_core: ^4.0.1
    ```
 2. **配置工程权限：**Android 和 iOS 工程都需要配置权限。
 
@@ -91,11 +91,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>。 |
 
 ## 搭建基础直播间
 
@@ -231,20 +231,20 @@ void main() async {
 
    **LiveInfo 参数说明：**
 
-| **参数名** | **类型** | **属性** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>属性</strong> | <strong>描述</strong> |
 | --- | --- | --- | --- |
-| `liveID` | `String` | 必填 | 直播间的唯一标识符。 |
-| `liveName` | `String` | 选填 | 直播间的标题。 |
-| `notice` | `String` | 选填 | 直播间的公告信息。 |
-| `isMessageDisable` | `Boolean` | 选填 | 是否禁言（`true`：是，`false`：否）。 |
-| `isPublicVisible` | `Boolean` | 选填 | 是否公开可见（`true`：是，`false`：否）。 |
-| `seatMode` | `TakeSeatMode` | 选填 | 上麦模式（`FREE`：自由上麦，`APPLY`：申请上麦）。 |
-| `seatTemplate` | `SeatLayoutTemplate` | 必填 | 麦位布局模板。 |
-| `coverURL` | `String` | 选填 | 直播间的封面图片地址。 |
-| `backgroundURL` | `String` | 选填 | 直播间的背景图片地址。 |
-| `categoryList` | `List<Int>` | 选填 | 直播间的分类标签列表。 |
-| `activityStatus` | `Int` | 选填 | 直播活动状态。 |
-| `isGiftEnabled` | `Boolean` | 选填 | 是否启用礼物功能（`true`：是，`false`：否）。 |
+| <code>liveID</code> | <code>String</code> | 必填 | 直播间的唯一标识符。 |
+| <code>liveName</code> | <code>String</code> | 选填 | 直播间的标题。 |
+| <code>notice</code> | <code>String</code> | 选填 | 直播间的公告信息。 |
+| <code>isMessageDisable</code> | <code>Boolean</code> | 选填 | 是否禁言（<code>true</code>：是，<code>false</code>：否）。 |
+| <code>isPublicVisible</code> | <code>Boolean</code> | 选填 | 是否公开可见（<code>true</code>：是，<code>false</code>：否）。 |
+| <code>seatMode</code> | <code>TakeSeatMode</code> | 选填 | 上麦模式（<code>FREE</code>：自由上麦，<code>APPLY</code>：申请上麦）。 |
+| <code>seatTemplate</code> | <code>SeatLayoutTemplate</code> | 必填 | 麦位布局模板。 |
+| <code>coverURL</code> | <code>String</code> | 选填 | 直播间的封面图片地址。 |
+| <code>backgroundURL</code> | <code>String</code> | 选填 | 直播间的背景图片地址。 |
+| <code>categoryList</code> | <code>List<Int></code> | 选填 | 直播间的分类标签列表。 |
+| <code>activityStatus</code> | <code>Int</code> | 选填 | 直播活动状态。 |
+| <code>isGiftEnabled</code> | <code>Boolean</code> | 选填 | 是否启用礼物功能（<code>true</code>：是，<code>false</code>：否）。 |
 
 5. **结束直播。**
 
@@ -448,7 +448,7 @@ void main() async {
      @override
      void initState() {
        super.initState();
-       _controller = LiveCoreController.create();
+       _controller = LiveCoreController.create(CoreViewType.playView);
        _controller.setLiveID(widget.liveId);
        // 进入直播间
        _joinLive();
@@ -543,7 +543,7 @@ class _YourAudiencePageState extends State<YourAudiencePage> {
   @override
   void initState() {
     super.initState();
-    _controller = LiveCoreController.create();
+    _controller = LiveCoreController.create(CoreViewType.playView);
     _controller.setLiveID(widget.liveId);
     // 2. 监听直播事件
     _setupLiveEventListener();
@@ -611,37 +611,40 @@ class _YourAudiencePageState extends State<YourAudiencePage> {
 ### 运行效果
 
 集成 **LiveCoreWidget** 后，您将得到一个纯净的视频渲染视图，它已具备完整的直播业务能力，但没有任何交互 UI。您可以参考下一章节 丰富直播场景 来完善直播场景。
-| **布局类型** | **动态宫格布局** | **浮动小窗布局** | **固定宫格布局** | **固定小窗布局** |
-| --- | --- | --- | --- | --- |
-| **模板 ID** | 600 | 601 | 800 | 801 |
-| **描述** | 默认布局，可根据连麦人数动态调整宫格大小。 | 连麦嘉宾以浮动小窗形式显示。 | 连麦人数固定，每个嘉宾占据一个固定宫格。 | 连麦人数固定，嘉宾以固定小窗形式显示。 |
+
+|**布局类型**|**动态宫格布局**|**浮动小窗布局**|**固定宫格布局**|**固定小窗布局**|
+|---------|---------|---------|---------|---------|
+|**模板 ID**|600|601|800|801|
+|**描述**|默认布局，可根据连麦人数动态调整宫格大小。|连麦嘉宾以浮动小窗形式显示。|连麦人数固定，每个嘉宾占据一个固定宫格。|连麦人数固定，嘉宾以固定小窗形式显示。|
 
 ## 丰富直播场景
 
 当您完成了基础的直播功能后，您可以参考以下功能指南来为直播添加丰富的互动玩法。
-| **直播功能** | **功能介绍** | **功能 Stores** | **实现指南** |
-| --- | --- | --- | --- |
-| **实现观众音视频连线** | 观众申请上麦，与主播进行实时视频互动。 | [CoGuestStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html) | 实现观众连线 |
-| **实现主播跨房连线 PK** | 两个不同房间的主播进行连线，实现互动或 PK。 | [CoHostStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_host_store/CoHostStore-class.html) / [BattleStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_battle_store/BattleStore-class.html) | 实现主播连线 PK |
-| **添加弹幕聊天功能** | 观众可以在直播间发送和接收实时文字消息。 | [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)|实现观众连线|
+|**实现主播跨房连线 PK**|两个不同房间的主播进行连线，实现互动或 PK。|[CoHostStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_host_store/CoHostStore-class.html) / [BattleStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_battle_store/BattleStore-class.html)|实现主播连线 PK|
+|**添加弹幕聊天功能**|观众可以在直播间发送和接收实时文字消息。|[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 文档** |
-| --- | --- | --- |
-| **LiveCoreWidget** | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreWidget-class.html) |
-| **LiveCoreController** | LiveCoreWidget 的控制器：用于设置直播 ID、控制预览等操作。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreController-class.html) |
-| **LiveListStore** | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-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 文档**|
+|---------|---------|---------|
+|**LiveCoreWidget**|直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreWidget-class.html)|
+|**LiveCoreController**|LiveCoreWidget 的控制器：用于设置直播 ID、控制预览等操作。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreController-class.html)|
+|**LiveListStore**|直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-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)|
 
 ## 常见问题
 

package/resource/{doc → knowledge}/livekit/core-sdk/live/flutter/live-live-list.md

@@ -1,4 +1,4 @@
-`LiveListStore` 是 `AtomicXCore` 中负责管理直播房间列表、创建、加入以及维护房间状态的核心模块。通过`LiveListStore`，您可以为您的应用构建完整的直播生命周期管理。
+`LiveListStore` 是 `AtomicXCore` 中负责管理直播房间列表、创建、加入以及维护房间状态的核心模块。通过 `LiveListStore`，您可以为您的应用构建完整的直播生命周期管理。
 
 ## 核心功能
 - **获取直播列表**：获取当前所有公开的直播间列表，支持分页加载。
@@ -14,18 +14,20 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `LiveListStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| [LiveInfo](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveInfo-class.html) | `class` | 代表一个直播间的所有信息模型。包含了直播ID (`liveID`)、名称 (`liveName`)、房主信息 (`liveOwner`) 以及自定义元数据 (`metaData`) 等。 |
-| [LiveListState](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListState-class.html) | `class` | 代表直播列表模块的当前状态。其核心属性 `liveList` 是一个 `ValueListenable<List<LiveInfo>>` 类型，存储了拉取到的直播列表；`currentLive` 则代表用户当前所在的直播间信息。 |
-| [LiveListListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListListener-class.html) | `class` | 代表直播房间的全局事件监听器。包含 `onLiveEnded` (直播结束) 和 `onKickedOutOfLive` (被踢出直播) 两种回调，用于处理关键的房间状态变更。 |
-| [LiveListStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-class.html) | `class` | 这是与直播列表和房间生命周期交互的核心管理类。它是一个全局单例 (`shared`)，负责所有直播房间的创建、加入、信息更新等操作。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|[LiveInfo](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveInfo-class.html)|`class`|代表一个直播间的所有信息模型。包含了直播 ID (`liveID`)、名称 (`liveName`)、房主信息 (`liveOwner`) 以及自定义元数据 (`metaData`) 等。|
+|[LiveListState](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListState-class.html)|`class`|代表直播列表模块的当前状态。其核心属性 `liveList` 是一个 `ValueListenable<List<LiveInfo>>` 类型，存储了拉取到的直播列表；`currentLive` 则代表用户当前所在的直播间信息。|
+|[LiveListListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListListener-class.html)|`class`|代表直播房间的全局事件监听器。包含 `onLiveEnded` (直播结束) 和 `onKickedOutOfLive` (被踢出直播) 两种回调，用于处理关键的房间状态变更。|
+|[LiveListStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-class.html)|`class`|这是与直播列表和房间生命周期交互的核心管理类。它是一个全局单例 (`shared`)，负责所有直播房间的创建、加入、信息更新等操作。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 开始直播 集成 **AtomicXCore**，并完成 主播开播 和 观众观看 的功能实现。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：观众进入直播间实现
 
@@ -285,16 +287,17 @@ class YourAudiencePage extends StatelessWidget {
 ```
 
 **LiveInfo 参数说明**
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `liveID` | `String` | 直播间的唯一标识符 |
-| `liveName` | `String` | 直播间的标题 |
-| `coverURL` | `String` | 直播间的封面图片地址 |
-| `liveOwner` | `LiveUserInfo` | 房主的个人信息 |
-| `totalViewerCount` | `int` | 直播间的总观看人数 |
-| `categoryList` | `List<int>` | 直播间的分类标签列表 |
-| `notice` | `String` | 直播间的公告信息 |
-| `metaData` | `Map<String, String>` | 开发者自定义的元数据，用于实现复杂的业务场景 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`liveID`|`String`|直播间的唯一标识符。|
+|`liveName`|`String`|直播间的标题。|
+|`coverURL`|`String`|直播间的封面图片地址。|
+|`liveOwner`|`LiveUserInfo`|房主的个人信息。|
+|`totalViewerCount`|`int`|直播间的总观看人数。|
+|`categoryList`|`List<int>`|直播间的分类标签列表。|
+|`notice`|`String`|直播间的公告信息。|
+|`metaData`|`Map<String, String>`|开发者自定义的元数据，用于实现复杂的业务场景。|
 
 ## 功能进阶
 
@@ -698,11 +701,12 @@ class _ProductCardWidgetState extends State<ProductCardWidget> {
 ## API 文档
 
 关于 [LiveListStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-class.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter/index.html) 框架的官方 API 文档。本文档使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **LiveCoreWidget** | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreWidget-class.html) |
-| **LiveCoreController** | LiveCoreWidget 的控制器：用于设置直播 ID、控制预览等操作。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreController-class.html) |
-| **LiveListStore** | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-class.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**LiveCoreWidget**|直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreWidget-class.html)|
+|**LiveCoreController**|LiveCoreWidget 的控制器：用于设置直播 ID、控制预览等操作。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreController-class.html)|
+|**LiveListStore**|直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-class.html)|
 
 ## 常见问题
 

package/resource/{doc → knowledge}/livekit/core-sdk/live/ios/live-audience-list.md

@@ -14,18 +14,20 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 LiveAudienceStore 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| `LiveUserInfo` | struct | 代表一个观众（用户）的基础信息模型。它包含了用户的唯一标识 (`userID`)、昵称 (`userName`) 和头像地址 (`avatarURL`)。 |
-| `LiveAudienceState` | struct | 代表观众模块的当前状态。其核心属性 `audienceList` 是一个 `[LiveUserInfo] `数组，存储了观众列表的快照；`audienceCount` 则代表当前观众总数。 |
-| `LiveAudienceEvent` | enum | 代表观众动态的实时事件。分为 `.onAudienceJoined`（观众加入） 和 `.onAudienceLeft`（观众离开）两种，用于实现对观众列表的增量更新。 |
-| `LiveAudienceStore` | class | 这是与观众列表功能交互的核心管理类。通过它，您可以获取观众列表快照、执行管理操作，并通过订阅其 `liveAudienceEventPublisher` 来接收实时动态。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|`LiveUserInfo`|struct|代表一个观众（用户）的基础信息模型。它包含了用户的唯一标识 (`userID`)、昵称 (`userName`) 和头像地址 (`avatarURL`)。|
+|`LiveAudienceState`|struct|代表观众模块的当前状态。其核心属性 `audienceList` 是一个 `[LiveUserInfo] `数组，存储了观众列表的快照；`audienceCount` 则代表当前观众总数。|
+|`LiveAudienceEvent`|enum|代表观众动态的实时事件。分为 `.onAudienceJoined`（观众加入） 和 `.onAudienceLeft`（观众离开）两种，用于实现对观众列表的增量更新。|
+|`LiveAudienceStore`|class|这是与观众列表功能交互的核心管理类。通过它，您可以获取观众列表快照、执行管理操作，并通过订阅其 `liveAudienceEventPublisher` 来接收实时动态。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 开始直播 集成 **AtomicXCore**，完成接入。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：初始化并获取观众列表
 
@@ -234,11 +236,12 @@ class LiveRoomManager {
 ## API 文档
 
 关于 [LiveAudienceStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。本文档使用到的相关 Store 如下：
-| Store/Component | 功能描述 | API 文档 |
-| --- | --- | --- |
-| LiveCoreView | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview) |
-| LiveAudienceStore | 观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore) |
-| BarrageStore | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) |
+
+|Store/Component|功能描述|API 文档|
+|---------|---------|---------|
+|LiveCoreView|直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview)|
+|LiveAudienceStore|观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore)|
+|BarrageStore|弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)|
 
 ## 常见问题
 

package/resource/{doc → knowledge}/livekit/core-sdk/live/ios/live-audio-effect.md

@@ -1,4 +1,4 @@
-本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的  `AudioEffectStore` 和 `DeviceStore` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
+本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的 `AudioEffectStore` 和 `DeviceStore` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
 
 ## 核心功能
 
@@ -12,24 +12,24 @@
 - **混响效果**：模拟不同环境的声场效果，例如 KTV、金属声、低沉、洪亮等。
 
 ## 概念说明
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| `AudioChangerType` | `enum` | 变声效果枚举，例如，“小孩”，“男人”等。 |
-| `AudioReverbType` | `enum` | 混响效果枚举，例如，“ktv”，“礼堂”等。 |
-| `AudioEffectState` | `struct` | 代表音效模块的当前状态，通常用于UI渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。 |
-| `AudioEffectStore` | `class` | 代表音效模块**单例数据管理类**。通过它您可以调用修改音效接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个state响应式数据来接收和监听状态更新。 |
-| `DeviceState` | `struct` | 代表设备模块的当前状态，通常用于UI渲染。核心属性包括摄像头、麦克风的设备状态。 |
-| `DeviceStore` | `class` | 代表设备模块**单例数据管理类**。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个state响应式数据来接收和监听状态更新。 |
+| <code>AudioChangerType</code> | <code>enum</code> | 变声效果枚举，例如，“小孩”，“男人”等。 |
+| <code>AudioReverbType</code> | <code>enum</code> | 混响效果枚举，例如，“ktv”，“礼堂”等。 |
+| <code>AudioEffectState</code> | <code>struct</code> | 代表音效模块的当前状态，通常用于 UI 渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。 |
+| <code>AudioEffectStore</code> | <code>class</code> | 代表音效模块<strong>单例数据管理类</strong>。通过它您可以调用修改音效接口，当您调用接口后，相应的 <code>state</code> 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
+| <code>DeviceState</code> | <code>struct</code> | 代表设备模块的当前状态，通常用于 UI 渲染。核心属性包括摄像头、麦克风的设备状态。 |
+| <code>DeviceStore</code> | <code>class</code> | 代表设备模块<strong>单例数据管理类</strong>。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的 <code>state</code> 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 快速接入 集成 **AtomicXCore。**
+请参考 开播与收听 集成 **AtomicXCore。**
 
 ### 步骤2：获取 Store 实例
 
-`AudioEffectStore` 和 `DeviceStore`是单例对象，您可以直接通过 shared 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源UI demo项目中的 [AudioEffectView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Component/AudioEffect/AudioEffectView.swift) 文件来了解完整的实现逻辑。
+`AudioEffectStore` 和 `DeviceStore` 是单例对象，您可以直接通过 shared 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源 UI Demo 项目中的 [AudioEffectView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Component/AudioEffect/AudioEffectView.swift) 文件来了解完整的实现逻辑。
 ``` swift
 import UIKit
 import AtomicXCore
@@ -50,9 +50,9 @@ let deviceStore = DeviceStore.shared
 >
 
 #### 实现方式:
-1. **开关耳返**：您可以使用`UISwitch`控件实现开关耳返功能。
+1. **开关耳返**：您可以使用 `UISwitch`  控件实现开关耳返功能。
 
-2. **设置耳返音量值**：您可以使用 `UISlider` 控件实现左右拖动滑块来调节音量的功能，并将 `UISlider` 的值映射成音量值，调用`setOutputVolume(_ volume:)。`请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
+2. **设置耳返音量值**：您可以使用 `UISlider` 控件实现左右拖动滑块来调节音量的功能，并将 `UISlider` 的值映射成音量值，调用 `setOutputVolume(_ volume:)`。请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
 
 3. **监听状态更新 UI**：您可以订阅实时的耳返状态值更新 UI。
 
@@ -79,21 +79,21 @@ audioEffectStore.state
 ```
 
 #### setVoiceEarMonitorEnable 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `enable` | `Bool` | 是否开启耳返。<br>- true：开启<br>- false：关闭 |
+| <code>enable</code> | <code>Bool</code> | 是否开启耳返。<br>- true：开启<br>- false：关闭 |
 
 #### setVoiceEarMonitorVolume 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `volume` | `Int` | 耳返音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
+| <code>volume</code> | <code>Int</code> | 耳返音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
 
 ### 步骤4：实现人声音量调节
 
-当主播希望调节自己的上行采集音量大小时，调用`DeviceStore`的`setCaptureVolume(volume: )`方法传入音量值即可。
+当主播希望调节自己的上行采集音量大小时，调用 `DeviceStore` 的 `setCaptureVolume(volume: )` 方法传入音量值即可。
 
 #### 实现方式:
-1. **设置采集音量值**：您可以使用 `UISlider` 控件实现左右拖动滑块来调节音量的功能，并将 `UISlider` 的值映射成音量值后调用`setCaptureVolume(volume: 80)。`请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
+1. **设置采集音量值**：您可以使用 `UISlider` 控件实现左右拖动滑块来调节音量的功能，并将 `UISlider` 的值映射成音量值后调用 `setCaptureVolume(volume: 80)`。请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
 
 2. **监听状态更新 UI**：您可以订阅实时的音量状态值更新 UI。
 
@@ -114,13 +114,13 @@ deviceStore.state
 ```
 
 #### setCaptureVolume 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `volume` | `Int` | 采集音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
+| <code>volume</code> | <code>Int</code> | 采集音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
 
 ### 步骤5：实现变声效果
 
-当主播希望改变自己的声音时，您可以调用 `setAudioChangerType(type:)`方法，传入相应的Type 枚举值即可切换效果。
+当主播希望改变自己的声音时，您可以调用 `setAudioChangerType(type:)` 方法，传入相应的 Type 枚举值即可切换效果。
 
 #### 示例代码：
 ``` swift
@@ -131,13 +131,14 @@ audioEffectStore.setAudioChangerType(type: .none)
 ```
 
 #### setAudioChangerType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `type` | `AudioChangerType` | 变声效果枚举。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`type`|`AudioChangerType`|变声效果枚举。|
 
 ### 步骤6：实现混响效果
 
-当主播希望给自己的声音添加混响效果时，您可以调用`setAudioReverbType(type:)` 方法，传入相应的Type 枚举值即可切换效果。
+当主播希望给自己的声音添加混响效果时，您可以调用 `setAudioReverbType(type:)` 方法，传入相应的 Type 枚举值即可切换效果。
 ``` swift
 // 示例：设置为“KTV”混响效果
 audioEffectStore.setAudioReverbType(type: .ktv)
@@ -146,22 +147,23 @@ audioEffectStore.setAudioReverbType(type: .none)
 ```
 
 #### setAudioReverbType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `type` | `AudioReverbType` | 混响效果枚举。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`type`|`AudioReverbType`|混响效果枚举。|
 
 ### 步骤7：重置音效设置
 
 > **重要：**
 >
 
-> AudioEffectStore和DeviceStore是单例，这意味着音效和设备设置是全局生效的，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
+> `AudioEffectStore` 和 `DeviceStore` 是单例，这意味着音效和设备设置是全局生效的，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
 >
 
 以下两种情况您可能需要重置音效设置：
 1. 当前直播间结束时，需要重置音效设置。
 
-2. 您需要提供“一键恢复”的功能，可以通过调用 store的`reset()` 方法实现。
+2. 您需要提供“一键恢复”的功能，可以通过调用 store 的 `reset()` 方法实现。
 
    ``` swift
    class YourMainViewController: UIViewController {
@@ -175,16 +177,17 @@ audioEffectStore.setAudioReverbType(type: .none)
 ## API 文档
 
 关于 [AudioEffectStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore) 和 [DeviceStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore) 及其相关类的所有公开接口、属性的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| AudioEffectStore | 音效管理：进行音效设置，并获取实时音效状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore/) |
-| DeviceStore | 设备管理：进行摄像头、麦克风操作，并获取实时设备状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|AudioEffectStore|音效管理：进行音效设置，并获取实时音效状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore/)|
+|DeviceStore |设备管理：进行摄像头、麦克风操作，并获取实时设备状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore)|
 
 ## 常见问题
 
 ### 音效和设备接口的调用时机有没有要求？
 
-没有限制。`AudioEffectStore`和`DeviceStore` 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。
+没有限制。`AudioEffectStore` 和 `DeviceStore` 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。
 
 ### **“人声音量” 和“耳返音量” 有什么区别？**
 
@@ -195,7 +198,7 @@ audioEffectStore.setAudioReverbType(type: .none)
 
 ### **新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？**
 
-`AudioEffectStore`和`DeviceStore`是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用`reset()`方法重置。
+`AudioEffectStore` 和 `DeviceStore` 是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用 `reset()` 方法重置。
 
 ### **为什么我开启了“耳返”，但是听不到自己的声音？**