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

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

@@ -1,7 +1,7 @@
-`LiveListStore` 是 `AtomicXCore` 中负责管理直播房间列表、创建、加入以及维护房间状态的核心模块。通过`LiveListStore`，开发者可以为应用构建完整的直播生命周期管理。
+`LiveListStore` 是 `AtomicXCore` 中负责管理直播房间列表、创建、加入以及维护房间状态的核心模块。通过 `LiveListStore`，您可以为您的应用构建完整的直播生命周期管理。
 
 ## 核心功能
-- **直播列表拉取**：获取当前所有公开的直播间列表，支持分页加载。
+- **获取直播列表**：获取当前所有公开的直播间列表，支持分页加载。
 
 - **直播生命周期管理**：提供从创建、开播、加入、离开到结束直播的全套流程接口。
 
@@ -13,28 +13,25 @@
 
 ## 核心概念
 
-在开始集成之前，下表介绍了 `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`)，负责所有直播房间的创建、加入、信息更新等操作。 |
+在开始集成之前，我们先通过下表了解一下 `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`)，负责所有直播房间的创建、加入、信息更新等操作。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-参考 快速接入 集成 **AtomicXCore**，并完成 构建基础语聊房应用 的功能实现。
-
-### 步骤2：实现观众从直播列表进入直播间
-
-#### 实现方式
-1. 创建一个展示直播列表的页面，该页面使用 `GridView` 来布局直播间卡片。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
-2. 当用户点击某个卡片时，获取该直播间的 `liveID`，并跳转到观众观看页面。
+### 步骤2：观众进入直播间实现
 
-#### 代码示例
+创建一个展示直播列表的页面，该页面使用 `GridView` 来布局直播间卡片。当用户点击某个卡片时，获取该直播间的 `liveID`，并跳转到观众观看页面。
 ``` java
 import 'package:flutter/material.dart';
 import 'package:atomic_x_core/atomicxcore.dart';
@@ -51,12 +48,11 @@ class _LiveListPageState extends State<LiveListPage> {
   final _liveListStore = LiveListStore.shared;
   final ScrollController _scrollController = ScrollController();
   bool _isLoading = false;
-  late final VoidCallback _liveListListener = _onLiveListChanged;
 
   @override
   void initState() {
     super.initState();
-    _liveListStore.liveState.liveList.addListener(_liveListListener);
+    _liveListStore.liveState.liveList.addListener(_onLiveListChanged);
     _scrollController.addListener(_onScroll);
     _fetchLiveList();
   }
@@ -79,7 +75,7 @@ class _LiveListPageState extends State<LiveListPage> {
 
     final result = await _liveListStore.fetchLiveList(cursor: '', count: 20);
     if (!result.isSuccess) {
-      debugPrint('直播列表拉取失败: ${result.message}');
+      debugPrint('获取直播列表失败: ${result.message}');
     }
 
     setState(() => _isLoading = false);
@@ -114,7 +110,7 @@ class _LiveListPageState extends State<LiveListPage> {
 
   @override
   void dispose() {
-    _liveListStore.liveState.liveList.removeListener(_liveListListener);
+    _liveListStore.liveState.liveList.removeListener(_onLiveListChanged);
     _scrollController.dispose();
     super.dispose();
   }
@@ -291,29 +287,27 @@ 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>`|开发者自定义的元数据，用于实现复杂的业务场景。|
 
 ## 功能进阶
 
 ### 场景一：分类展示直播列表
 
-在 App 的直播广场页，顶部设有“热门”、“音乐”、“游戏”等分类标签。用户点击不同的标签后，下方的直播列表会动态筛选，只展示对应分类的直播间，从而帮助用户快速发现感兴趣的内容。
+在 App 的直播广场页，顶部设有"热门"、"音乐"、"游戏"等分类标签。用户点击不同的标签后，下方的直播列表会动态筛选，只展示对应分类的直播间，从而帮助用户快速发现感兴趣的内容。
 
 #### 实现方式
 
-核心是利用 `LiveInfo` 模型中的 `categoryList` 属性。
-1. 当主播开播设置分类后，`fetchLiveList` 返回的 `LiveInfo` 对象中就会包含这些分类信息。
-
-2. 您的 App 在获取到完整的直播列表后，只需在客户端根据用户选择的分类，对这个列表进行一次简单的筛选，然后刷新 UI 即可。
+核心是利用 `LiveInfo` 模型中的 `categoryList` 属性。当主播开播设置分类后，`fetchLiveList` 返回的 `LiveInfo` 对象中就会包含这些分类信息。您的 App 在获取到完整的直播列表后，只需在客户端根据用户选择的分类，对这个列表进行一次简单的筛选，然后刷新 UI 即可。
 
 #### 代码示例
 
@@ -331,11 +325,10 @@ class LiveListManager extends ChangeNotifier {
 
   List<LiveInfo> get filteredLiveList => _filteredLiveList;
   int? get selectedCategoryId => _selectedCategoryId;
-
-  late final VoidCallback _liveListListener = _onLiveListChanged;
+  late final VoidCallback _liveListChangedListener = _onLiveListChanged;
 
   LiveListManager() {
-    _liveListStore.liveState.liveList.addListener(_liveListListener);
+    _liveListStore.liveState.liveList.addListener(_liveListChangedListener);
   }
 
   void _onLiveListChanged() {
@@ -369,7 +362,7 @@ class LiveListManager extends ChangeNotifier {
 
   @override
   void dispose() {
-    _liveListStore.liveState.liveList.removeListener(_liveListListener);
+    _liveListStore.liveState.liveList.removeListener(_liveListChangedListener);
     super.dispose();
   }
 }
@@ -501,14 +494,13 @@ class _CategoryLiveListPageState extends State<CategoryLiveListPage> {
 }
 ```
 
-### 场景二：同步语聊房内自定义状态
+### 场景二：展示电商直播的商品信息
 
-在语聊房中，主播可能需要向所有观众同步一些自定义信息，例如“当前房间话题”、“背景音乐信息”等。`LiveListStore` 的 `MetaData` 功能可以实现这一点。
+在电商直播中，主播正在讲解一款商品。此时，所有观众的直播画面下方都会弹出一张商品卡片，实时展示该商品的图片、名称和价格。当主播切换讲解下一件商品时，所有观众端的卡片都会自动、同步更新。
 
 #### 实现方式
-1. 主播端将自定义信息（建议使用 JSON 格式）通过 `updateLiveMetaData` 接口设置到一个或多个 key 中。`AtomicXCore` 会将这个变更实时同步给所有观众。
 
-2. 观众端只需订阅 `LiveListState.currentLive`，监听 `metaData` 的变化，一旦发现关心的 key 更新，就解析其 value 并刷新业务状态。
+主播端将当前商品的结构化信息（建议使用 **JSON** 格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需订阅 `LiveListState.currentLive`，监听 `metaData` 的变化，一旦发现 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
 
 #### 代码示例
 ``` java
@@ -516,60 +508,69 @@ import 'dart:convert';
 import 'package:flutter/material.dart';
 import 'package:atomic_x_core/atomicxcore.dart';
 
-/// 背景音乐模型
-class MusicModel {
-  final String musicId;
-  final String musicName;
-
-  MusicModel({required this.musicId, required this.musicName});
-
-  factory MusicModel.fromJson(Map<String, dynamic> json) {
-    return MusicModel(
-      musicId: json['musicId'] ?? '',
-      musicName: json['musicName'] ?? '',
+/// 商品信息模型
+class Product {
+  final String id;
+  final String name;
+  final String price;
+  final String imageUrl;
+
+  Product({
+    required this.id,
+    required this.name,
+    required this.price,
+    required this.imageUrl,
+  });
+
+  factory Product.fromJson(Map<String, dynamic> json) {
+    return Product(
+      id: json['id'] ?? '',
+      name: json['name'] ?? '',
+      price: json['price'] ?? '',
+      imageUrl: json['imageUrl'] ?? '',
     );
   }
 
   Map<String, dynamic> toJson() {
     return {
-      'musicId': musicId,
-      'musicName': musicName,
+      'id': id,
+      'name': name,
+      'price': price,
+      'imageUrl': imageUrl,
     };
   }
 }
 
-/// 主播端：推送背景音乐
-class HostMusicController {
+/// 主播端：推送商品信息
+class HostProductController {
   final _liveListStore = LiveListStore.shared;
 
-  Future<void> updateBackgroundMusic(MusicModel music) async {
-    final jsonString = jsonEncode(music.toJson());
-
-    // 将要更新的元数据
-    final metaData = {'music_info': jsonString};
+  Future<void> pushProductInfo(Product product) async {
+    final jsonString = jsonEncode(product.toJson());
+    final metaData = {'product_info': jsonString};
 
     // 使用全局单例的 liveListStore 来更新 metaData
     final result = await _liveListStore.updateLiveMetaData(metaData);
     if (result.isSuccess) {
-      debugPrint('背景音乐 ${music.musicName} 推送成功');
+      debugPrint('商品 ${product.name} 信息推送成功');
     } else {
-      debugPrint('背景音乐推送失败: ${result.message}');
+      debugPrint('商品信息推送失败: ${result.message}');
     }
   }
 }
 
-/// 观众端：订阅并响应背景音乐变化
-class AudienceMusicWidget extends StatefulWidget {
-  const AudienceMusicWidget({super.key});
+/// 观众端：商品卡片组件
+class ProductCardWidget extends StatefulWidget {
+  const ProductCardWidget({super.key});
 
   @override
-  State<AudienceMusicWidget> createState() => _AudienceMusicWidgetState();
+  State<ProductCardWidget> createState() => _ProductCardWidgetState();
 }
 
-class _AudienceMusicWidgetState extends State<AudienceMusicWidget> {
+class _ProductCardWidgetState extends State<ProductCardWidget> {
   final _liveListStore = LiveListStore.shared;
-  MusicModel? _currentMusic;
-  String? _lastMusicInfo;
+  Product? _currentProduct;
+  String? _lastProductInfo;
   late final VoidCallback _currentLiveChangedListener = _onCurrentLiveChanged;
 
   @override
@@ -580,37 +581,30 @@ class _AudienceMusicWidgetState extends State<AudienceMusicWidget> {
 
   void _onCurrentLiveChanged() {
     final currentLive = _liveListStore.liveState.currentLive.value;
-    final musicInfo = currentLive.metaData['music_info'];
+    final productInfo = currentLive.metaData['product_info'];
 
     // 检查是否有变化
-    if (musicInfo != _lastMusicInfo) {
-      _lastMusicInfo = musicInfo;
-      _parseMusicInfo(musicInfo);
+    if (productInfo != _lastProductInfo) {
+      _lastProductInfo = productInfo;
+      _parseProductInfo(productInfo);
     }
   }
 
-  void _parseMusicInfo(String? jsonString) {
+  void _parseProductInfo(String? jsonString) {
     if (jsonString == null || jsonString.isEmpty) {
-      setState(() => _currentMusic = null);
+      setState(() => _currentProduct = null);
       return;
     }
 
     try {
       final json = jsonDecode(jsonString) as Map<String, dynamic>;
-      final music = MusicModel.fromJson(json);
-      setState(() => _currentMusic = music);
-      // 刷新业务状态，播放新的音乐
-      _playMusic(music);
+      final product = Product.fromJson(json);
+      setState(() => _currentProduct = product);
     } catch (e) {
-      debugPrint('解析音乐信息失败: $e');
+      debugPrint('解析商品信息失败: $e');
     }
   }
 
-  void _playMusic(MusicModel music) {
-    // 实现播放音乐的逻辑
-    debugPrint('正在播放: ${music.musicName}');
-  }
-
   @override
   void dispose() {
     _liveListStore.liveState.currentLive.removeListener(_currentLiveChangedListener);
@@ -619,20 +613,83 @@ class _AudienceMusicWidgetState extends State<AudienceMusicWidget> {
 
   @override
   Widget build(BuildContext context) {
+    if (_currentProduct == null) {
+      return const SizedBox.shrink();
+    }
+
     return Container(
-      padding: const EdgeInsets.all(8),
+      margin: const EdgeInsets.all(16),
+      padding: const EdgeInsets.all(12),
       decoration: BoxDecoration(
-        color: Colors.black54,
-        borderRadius: BorderRadius.circular(8),
+        color: Colors.white,
+        borderRadius: BorderRadius.circular(12),
+        boxShadow: [
+          BoxShadow(
+            color: Colors.black.withOpacity(0.1),
+            blurRadius: 8,
+            offset: const Offset(0, 2),
+          ),
+        ],
       ),
       child: Row(
-        mainAxisSize: MainAxisSize.min,
         children: [
-          const Icon(Icons.music_note, color: Colors.white, size: 16),
-          const SizedBox(width: 4),
-          Text(
-            _currentMusic?.musicName ?? '暂无音乐',
-            style: const TextStyle(color: Colors.white, fontSize: 12),
+          // 商品图片
+          ClipRRect(
+            borderRadius: BorderRadius.circular(8),
+            child: Image.network(
+              _currentProduct!.imageUrl,
+              width: 80,
+              height: 80,
+              fit: BoxFit.cover,
+              errorBuilder: (context, error, stackTrace) {
+                return Container(
+                  width: 80,
+                  height: 80,
+                  color: Colors.grey[300],
+                  child: const Icon(Icons.image),
+                );
+              },
+            ),
+          ),
+          const SizedBox(width: 12),
+          // 商品信息
+          Expanded(
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              mainAxisSize: MainAxisSize.min,
+              children: [
+                Text(
+                  _currentProduct!.name,
+                  style: const TextStyle(
+                    fontSize: 14,
+                    fontWeight: FontWeight.bold,
+                  ),
+                  maxLines: 2,
+                  overflow: TextOverflow.ellipsis,
+                ),
+                const SizedBox(height: 4),
+                Text(
+                  '¥${_currentProduct!.price}',
+                  style: const TextStyle(
+                    fontSize: 16,
+                    color: Colors.red,
+                    fontWeight: FontWeight.bold,
+                  ),
+                ),
+              ],
+            ),
+          ),
+          // 购买按钮
+          ElevatedButton(
+            onPressed: () {
+              // 实现购买逻辑
+              debugPrint('购买商品: ${_currentProduct!.name}');
+            },
+            style: ElevatedButton.styleFrom(
+              backgroundColor: Colors.orange,
+              foregroundColor: Colors.white,
+            ),
+            child: const Text('立即购买'),
           ),
         ],
       ),
@@ -643,62 +700,22 @@ class _AudienceMusicWidgetState extends State<AudienceMusicWidget> {
 
 ## 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) 框架的官方 API 文档。本文档使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| LiveListStore | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_list_store/LiveListStore-class.html) |
-
-## 常见问题
-
-### 语聊房的列表和视频直播的列表数据是同一份吗？
-
-它们的数据是同一份，您不需要分开拉取。`LiveListStore` 是一个全局单例，它负责统一管理应用中所有“直播”房间的生命周期，无论是视频直播还是语聊房。
-
-### 直播列表中如何区分语聊房和视频直播？
-
-`LiveListStore` 本身不区分房间的业务类型。您需要在获取列表后，在客户端的应用层（业务逻辑或 UI 层）进行筛选和分类。
-
-我们推荐采用以下两种方式进行区分：
-
-**方式一（推荐）：使用 seatLayoutTemplateID 区分**
+关于 [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 如下：
 
-这是一个用于定义房间布局的模板 ID，关于目前已支持的模板 ID 和效果，请参考文档 开始直播-运行效果。您要在创建房间时指定 ID，然后在获取列表时根据 ID 范围来识别业务场景。
-- **步骤1：创建房间时指定 ID**
+|**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)|
 
-   调用 `LiveListStore.shared.createLive` 时，您需要根据业务场景为 `LiveInfo` 的 `seatLayoutTemplateID` 属性传入指定范围的 ID：
-
-  - 语聊房场景：传入 1-199 范围内的模板 ID。
-
-  - 视频直播场景：传入 200-999 范围内的模板 ID。
-
-- **步骤2：获取列表时筛选**
-
-   客户端在 `liveState.liveList` 中收到列表数据后，通过判断这个 ID 值所属的范围来区分，从而在进入直播间的时候区分两种业务场景。
-
-   > **重要提示：**
-   >
-
-   > 创建房间时，如果传入的 `seatLayoutTemplateID` 范围与您的业务场景（语聊房、视频直播）不匹配，可能会导致麦位布局出现功能异常。
-   >
-
-   **方式二：为 **`liveID`** 添加业务前缀**
-
-   这是一种可选的、纯粹的应用层约定，用于辅助您在客户端快速筛选。
-
-- **步骤1：创建房间时添加前缀**
-
-   在您生成 `liveID` 并调用 `createLive` 时，为不同业务类型的 `liveID` 赋予不同的前缀。例如：视频直播的 ID 以 “Live_” 开头 (例如：Live_12345)，语聊房的 ID 以 “voice_” 开头 (例如：voice_67890)。
-
-- **步骤2：获取列表时检查前缀**
-
-   客户端在拉取到列表后，通过检查 `liveID` 字符串的前缀来进行区分。
+## 常见问题
 
-### 使用 `updateLiveMetaData` 注意事项
+### 使用 `updateLiveMetaData` 时有哪些需要注意的限制和规则？
 
 为了保证系统的稳定和高效，`metaData` 的使用遵循以下规则：
 - **权限**：只有房主和管理员可以调用 `updateLiveMetaData`。普通观众没有权限。
 
-- **数量与大小限制：**
+- **数量与大小限制： **
 
   - 单个房间最多支持 **10** 个 key。
 
@@ -706,4 +723,4 @@ class _AudienceMusicWidgetState extends State<AudienceMusicWidget> {
 
   - 单个房间所有 value 的总大小不超过 **16KB**。
 
-- **冲突解决**：`metaData` 的更新机制是“后来者覆盖”。如果多个管理员在短时间内修改同一个 key，最后一次的修改会生效。建议在业务设计上避免多人同时修改同一个关键信息。
+- **冲突解决**：`metaData` 的更新机制是"后来者覆盖"。如果多个管理员在短时间内修改同一个 key，最后一次的修改会生效。建议在业务设计上避免多人同时修改同一个关键信息。

package/resource/{doc → knowledge}/livekit/core-sdk/voice/ios/voice-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：初始化并获取观众列表
 
@@ -134,7 +136,7 @@ extension AudienceManager {
 ``` swift
 extension AudienceManager {
     func kick(userId: String) {
-        audienceStore.kickUserOutOfRoom(userId: userId) { result in
+        audienceStore.kickUserOutOfRoom(userID: userId) { result in
             switch result {
             case .success:
                 print("成功将用户 \(userId) 踢出房间")
@@ -154,7 +156,7 @@ extension AudienceManager {
 extension AudienceManager {
     /// 将用户设为管理员
     func promoteToAdmin(userId: String) {
-        audienceStore.setAdministrator(userId: userId) { result in
+        audienceStore.setAdministrator(userID: userId) { result in
             if case .success = result {
                 print("成功将用户 \(userId) 设为管理员")
             }
@@ -163,7 +165,7 @@ extension AudienceManager {
 
     /// 撤销用户的管理员身份
     func revokeAdmin(userId: String) {
-        audienceStore.revokeAdministrator(userId: userId) { result in
+        audienceStore.revokeAdministrator(userID: userId) { result in
             if case .success = result {
                 print("成功撤销用户 \(userId) 的管理员身份")
             }
@@ -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)|
 
 ## 常见问题
 
@@ -255,7 +258,7 @@ class LiveRoomManager {
 
   - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
 
-  - **关键点：**在“弹幕风暴”或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
+  - **关键点：**在“弹幕风暴”或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
 
       **这对开发者意味着什么？**