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

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

@@ -2,16 +2,16 @@
 
 ## 准备工作
 
-### 步骤 1. 开通服务
+### 步骤1：开通服务
 
 请参见 开通服务，获取体验版或付费版 SDK。
 
-### 步骤2. 导入 tuikit-atomic-x
-1. **安装组件**：打开 [AtomicXCore SDK](https://ext.dcloud.net.cn/plugin?id=25488) ，单击**下载插件并导入HBuilderX**，选择需要集成的项目并单击**确定**。
+### 步骤2：导入 tuikit-atomic-x
+1. **安装组件**：打开 [AtomicXCore SDK](https://ext.dcloud.net.cn/plugin) ，单击**下载插件并导入 HBuilderX**，选择需要集成的项目并单击**确定**。
 
-2. **配置工程权限:  **请在应用的 manifest.json 文件的app-plus > distribute 节点下，确保添加了以下必要的权限：
+2. **配置工程权限:  **请在应用的 manifest.json 文件的 app-plus > distribute 节点下，确保添加了以下必要的权限：
 
-  - Android 平台（`android`节点）：在 `permissions` 数组中，请确保包含以下权限：
+  - Android 平台（`android` 节点）：在 `permissions` 数组中，请确保包含以下权限：
 
       ``` json
       "<uses-permission android:name=\"android.permission.RECORD_AUDIO\" />"
@@ -28,7 +28,7 @@
       "UIBackgroundModes" : [ "audio" ]
       ```
 
-### 步骤 3. 完成登录
+### 步骤3：完成登录
 
 在您的项目中调用 LoginState 中的 login 方法完成登录，**这是使用 **`AtomicXCore`** 所有功能的关键前提**。
 
@@ -55,9 +55,9 @@ const handleLogin = () => {
 **登录接口参数说明：**
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| sdkAppID | number | 从 [控制台](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)。 |
+| sdkAppID | number | 从 <a href="https://console.cloud.tencent.com/trtc">控制台</a>获取，通常是以 <code>140</code> 或 <code>160</code> 开头的 10 位整数。 |
+| userID | string | 当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。为避免多端登录冲突，<strong>请勿使用</strong><code>1</code>、<code>123</code><strong>等简单 ID</strong>。 |
+| userSig | string | 用于腾讯云鉴权的票据。请注意：<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>。 |
 
 ## 搭建语音聊天室
 
@@ -125,22 +125,23 @@ const startLive = () => {
 ```
 
 `LiveInfo`**参数说明:**
-| **参数名** | **类型** | **属性** | **描述** |
-| --- | --- | --- | --- |
-| `liveID` | `string` | 必填 | 直播间的唯一标识符 |
-| `liveName` | `string` | 选填 | 直播间的标题 |
-| `notice` | `string` | 选填 | 直播间的公告信息 |
-| `isMessageDisable` | `boolean` | 选填 | 是否禁言（`true`：是，`false`：否） |
-| `isPublicVisible` | `boolean` | 选填 | 是否公开可见（`true`：是，`false`：否） |
-| `isSeatEnabled` | `boolean` | 选填 | 是否启用麦位功能（`true`：是，`false`：否） |
-| `keepOwnerOnSeat` | `boolean` | 选填 | 是否保持房主在麦位上 |
-| `maxSeatCount` | `number` | 必填 | 最大麦位数量 |
-| `seatMode` | `string` | 选填 | 上麦模式（`'FREE'`：自由上麦，`'APPLY'`：申请上麦） |
-| `seatLayoutTemplateID` | `number` | 必填 | 麦位布局模板 `ID` |
-| `coverURL` | `string` | 选填 | 直播间的封面图片地址 |
-| `backgroundURL` | `string` | 选填 | 直播间的背景图片地址 |
-| `activityStatus` | `number` | 选填 | 直播活动状态 |
-| `isGiftEnabled` | `boolean` | 选填 | 是否启用礼物功能（`true`：是，`false`：否） |
+
+|**参数名**|**类型**|**属性**|**描述**|
+|---------|---------|---------|---------|
+|`liveID`|`string`|必填|直播间的唯一标识符。|
+|`liveName`|`string`|选填|直播间的标题。|
+|`notice`|`string`|选填|直播间的公告信息。|
+|`isMessageDisable`|`boolean`|选填|是否禁言（`true`：是，`false`：否）。|
+|`isPublicVisible`|`boolean`|选填|是否公开可见（`true`：是，`false`：否）。|
+|`isSeatEnabled`|`boolean`|选填|是否启用麦位功能（`true`：是，`false`：否）。|
+|`keepOwnerOnSeat`|`boolean`|选填|是否保持房主在麦位上。|
+|`maxSeatCount`|`number`|必填|最大麦位数量。|
+|`seatMode`|`string`|选填|上麦模式（`FREE`：自由上麦，`APPLY`：申请上麦）。|
+|`seatLayoutTemplateID`|`number`|必填|麦位布局模板 `ID。`|
+|`coverURL`|`string`|选填|直播间的封面图片地址。|
+|`backgroundURL`|`string`|选填|直播间的背景图片地址。|
+|`activityStatus`|`number`|选填|直播活动状态。|
+|`isGiftEnabled`|`boolean`|选填|是否启用礼物功能（`true`：是，`false`：否）。|
 
 #### **4. 构建麦位 UI 界面**
 
@@ -229,7 +230,7 @@ const handleJoinLive = () => {
 
 #### **3. 构建麦位 UI 界面**
 
-观众构建麦位 UI的流程与主播完全一致，请参考主播 构建麦位 UI 界面
+观众构建麦位 UI 的流程与主播完全一致，请参考主播 构建麦位 UI 界面。
 
 #### **4. 退出语聊房**
 
@@ -268,7 +269,7 @@ const handleLeaveLive = () => {
 
 #### 实现效果
 
-在您构建的麦位 UI 界面中监听 `speakingUsers` 变化，并更新“正在说话”状态，代码示例如下
+在您构建的麦位 UI 界面中监听 `speakingUsers` 变化，并更新“正在说话”状态，代码示例如下：
 ``` typescript
 import { watch } from 'vue';
 import { useLiveSeatState } from '@/uni_modules/tuikit-atomic-x/state/LiveSeatState';
@@ -285,25 +286,31 @@ watch(speakingUsers,(newSpeaker) => {
 ## 丰富语音聊天室场景
 
 当您完成了基础的语音聊天室功能后，您可以参考以下功能指南来为语音聊天室添加丰富的互动玩法。
-| **语音聊天室功能** | **功能介绍** | **功能 State** | **实现指南** |
-| --- | --- | --- | --- |
-| **实现观众音频连麦** | 观众申请上麦，与主播进行实时音频互动。 | [CoGuestState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState) | 实现观众连麦 |
-| **添加弹幕聊天功能** | 观众可以在语音聊天室发送和接收实时文字消息。 | [BarrageState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-BarrageState) | 实现弹幕功能 |
-| **构建礼物赠送系统** | 观众可以向主播赠送虚拟礼物，增加互动和趣味性。 | [GiftState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-GiftState) | 实现礼物功能 |
-| **添加设置音效功能** | 变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。 | [AudioEffectState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-AudioEffectState) | 实现音效功能 |
+
+|**语音聊天室功能**|**功能介绍**|**功能 State**|**实现指南**|
+|---------|---------|---------|---------|
+|**实现观众音频连麦**|观众申请上麦，与主播进行实时音频互动。|[CoGuestState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState)|观众上麦|
+|**添加弹幕聊天功能**|观众可以在语音聊天室发送和接收实时文字消息。|[BarrageState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-BarrageState)|实现弹幕功能|
+|**构建礼物赠送系统**|观众可以向主播赠送虚拟礼物，增加互动和趣味性。|[GiftState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-GiftState)|实现礼物功能|
+|**添加设置音效功能**|变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。|[AudioEffectState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-AudioEffectState)|实现音效功能|
 
 ##  API 文档
-| **State** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **LiveListState** | 语音聊天室全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改语音聊天室信息（名称、公告等），监听语音聊天室状态（如被踢出、结束）。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveListState) |
-| **DeviceState** | 音视频设备控制：麦克风（开关 / 音量），设备状态实时监听。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-DeviceState) |
-| **CoGuestState** | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风），状态同步。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState) |
-| **CoHostState** | 主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoHostState) |
-| **GiftState** | 礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-GiftState) |
-| **BarrageState** | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-BarrageState) |
-| **LikeState** | 点赞互动：发送点赞，监听点赞事件，同步总点赞数。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LikeState) |
-| **LiveAudienceState** | 观众管理：获取实时观众列表（ ID / 名称 / 头像），统计观众数量，监听观众进出事件。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveAudienceState) |
-| **AudioEffectState** | 音频特效：变声（童声 / 男声）、混响（ KTV 等）、耳返调节，实时切换特效。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-AudioEffectState) |
+
+|**State**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**LiveListState**|语音聊天室全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改语音聊天室信息（名称、公告等），监听语音聊天室状态（例如被踢出、结束）。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveListState)|
+|**DeviceState**|音视频设备控制：麦克风（开关 / 音量），设备状态实时监听。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-DeviceState)|
+|**CoGuestState**|观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风），状态同步。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState)|
+|**CoHostState**|主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoHostState)|
+|**GiftState**|礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-GiftState)|
+|**BarrageState**|弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-BarrageState)|
+|**LikeState**|点赞互动：发送点赞，监听点赞事件，同步总点赞数。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LikeState)|
+|**LiveAudienceState**|观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveAudienceState)|
+|**AudioEffectState**|音频特效：变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-AudioEffectState)|
+
+## 简易 Demo
+
+我们在 GitHub 上提供了开播和收听主流程的简易 Demo，详情见 [GitHub](https://github.com/Tencent-RTC/TUIKit_uni-app/tree/main/App/pages/scenes/live)。
 
 ## 常见问题
 
@@ -318,6 +325,6 @@ watch(speakingUsers,(newSpeaker) => {
 
   - 必须打包自定义基座：在开发调试原生插件时，不能使用标准基座，必须通过 `HBuilderX` > 运行 > 运行到手机或模拟器 > 制作自定义基座，然后选择这个自定义基座来运行。
 
-  - 检查权限：如本文档“准备工作”中所述，`manifest.json` manifest.json必须声明相机、麦克风等权限。
+  - 检查权限：如本文档“准备工作”中所述，`manifest.json` 必须声明相机、麦克风等权限。
 
   - 查看原生日志：这是终极调试手段。通过 `Android Studio (Logcat)` 或 `Xcode (Console)` 查看设备的原生日志，通常能发现最直接的错误信息。

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

@@ -1,4 +1,4 @@
-`LiveListState` 是 `AtomicXCore` 中负责管理直播房间列表、创建、加入以及维护房间状态的核心模块。通过`LiveListState`，您可以为您的应用构建完整的直播生命周期管理。
+`LiveListState` 是 `AtomicXCore` 中负责管理直播房间列表、创建、加入以及维护房间状态的核心模块。通过 `LiveListState`，您可以为您的应用构建完整的直播生命周期管理。
 
 ## 核心功能
 - **直播列表拉取**：获取当前所有公开的直播间列表，支持分页加载。
@@ -14,8 +14,9 @@
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 快速接入 集成 **AtomicXCore**，并完成搭建基础语聊房的功能实现。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：实现观众从直播列表进入直播间
 
@@ -142,16 +143,17 @@ const handleJoinLive = (live: any) => {
 ```
 
 **LiveInfo 参数说明**
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `liveID` | `string` | 直播间的唯一标识符 |
-| `liveName` | `string` | 直播间的标题 |
-| `coverURL` | `string` | 直播间的封面图片地址 |
-| `liveOwner` | [LiveUserInfo](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveuserinfo) | 房主的个人信息 |
-| `totalViewerCount` | `number` | 直播间的总观看人数 |
-| `categoryList` | `[number]` | 直播间的分类标签列表 |
-| `notice` | `string` | 直播间的公告信息 |
-| `metaData` | `[string: string]` | 开发者自定义的元数据，用于实现复杂的业务场景 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`liveID`|`string`|直播间的唯一标识符|
+|`liveName`|`string`|直播间的标题|
+|`coverURL`|`string`|直播间的封面图片地址|
+|`liveOwner`|[LiveUserInfo](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveuserinfo)|房主的个人信息|
+|`totalViewerCount`|`number`|直播间的总观看人数|
+|`categoryList`|`[number]`|直播间的分类标签列表|
+|`notice`|`string`|直播间的公告信息|
+|`metaData`|`[string: string]`|开发者自定义的元数据，用于实现复杂的业务场景|
 
 ## 功能进阶
 
@@ -165,7 +167,7 @@ const handleJoinLive = (live: any) => {
 
 #### 代码示例
 
-以下示例展示了如何在直播列表页中增加根据一个`categoryList`来处理数据和筛选逻辑的 `UI`。
+以下示例展示了如何在直播列表页中增加根据一个 `categoryList` 来处理数据和筛选逻辑的 `UI`。
 ``` typescript
 <template>
   <view class="live-list">
@@ -391,14 +393,13 @@ const handleJoinLive = (live: any) => {
 </style>
 ```
 
-### 场景二：实现语聊房内的自定义状态同步
+### 场景二：实现电商直播的商品信息展示
 
-在语聊房中，主播可能需要向所有观众同步一些自定义信息，例如“当前房间话题”、“背景音乐信息”等。`LiveListState` 的 `MetaData` 功能可以实现这一点。
+在电商直播中，主播正在讲解一款商品。此时，所有观众的直播画面下方都会弹出一张商品卡片，实时展示该商品的图片、名称和价格。当主播切换讲解下一件商品时，所有观众端的卡片都会自动、同步更新。
 
 #### 实现方式
-1.  主播端将自定义信息（建议使用 JSON 格式）通过 `updateLiveMetaData` 接口设置到一个或多个 key 中。`AtomicXCore` 会将这个变更实时同步给所有观众。
 
-2. 观众端只需监听`currentLive 中 metaData` 的变化，一旦发现关心的 key 更新，就解析其 value 并刷新业务状态。
+主播端将当前商品的结构化信息（建议使用 **JSON **格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需监听 `currentLive` 的变化，一旦发现 `metaData` 的 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
 
 #### 代码示例
 ``` typescript
@@ -406,53 +407,44 @@ import { useLiveListState } from "@/uni_modules/tuikit-atomic-x/state/LiveListSt
 
 // 状态管理
 const { updateLiveMetaData, currentLive } = useLiveListState();
-// 1. 定义一个背景音乐模型
-const musicModel = ref({ musicId: '', musicName: '', })
+// 1. 定义一个商品信息模型
+const product = ref({
+    id: '',
+    name: '',
+    price: '',
+    imageUrl: '',
+})
 
-// 2. 主播端：在您的主播业务逻辑中，添加推送背景音乐的方法
-const updateBackgroundMusic
- = () => {
+// 2. 主播端：在主播界面中添加推送商品的方法
+const updateProduct = () => {
     updateLiveMetaData({
-      metaData: JSON.stringify(["music_info": musicModel.value]),
+      metaData: JSON.stringify(["product_info": product.value]),
       success: () => {
-        console.log('背景音乐 ${musicModel.value.musicName} 推送成功')
+        console.log('商品 ${product.value.name} 信息推送成功')
       },
-      fail: (error) => {
-        console.log('背景音乐推送失败', error)
+      faile: (error) => {
+        console.log('商品信息推送失败', error)
       }
     })
 }
 
 // 3. 观众端：在观众端监听 currentLive
 watch( currentLive, (newVal, oldVal) => {
-    const newMusic = JSON.parse(newVal).metaData
-    // 在此播放音乐
+    const newProduct = JSON.parse(newVal).metaData
+    // 假设您已经绘制了自己的商品 UI
+    // 在此根据 newProduct 里面的字段来渲染您的商品 UI
 })
 ```
 
 ## API 文档
 
 关于 [LiveListState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveListState) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 AtomicXCore 框架的官方 API 文档。本文档使用到的相关 Store 如下：
-| **State** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| LiveListState | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveListState) |
-
-## 常见问题
-
-### 语聊房的列表和视频直播的列表数据是同一份吗？
 
-它们的数据是同一份，您不需要分开拉取。`LiveListState` 是一个全局单例，它负责统一管理应用中所有“直播”房间的生命周期，无论是视频直播还是语聊房。
+|**State**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|LiveListState|直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveListState)|
 
-### **直播列表中如何区分语聊房和视频直播**
-
-`LiveListState` 本身不区分房间的业务类型。您需要在获取列表后，在客户端的应用层（业务逻辑或 UI 层）进行筛选和分类。
-
-我们推荐采用以下方式进行区分：
-
-**为 **`liveID`** 添加业务前缀。**这是一种可选的、纯粹的应用层约定，用于辅助您在客户端快速筛选。
-  - **步骤1：创建房间时添加前缀 **在您生成 liveID 并调用 createLive 时，为不同业务类型的 liveID 赋予不同的前缀。例如：视频直播的 ID 以 “Live_” 开头 (例如: Live_12345)，语聊房的 ID 以 “voice_” 开头 (例如: voice_67890)。
-
-  - **步骤2：获取列表时检查前缀 **客户端在拉取到列表后，通过检查 liveID 字符串的前缀来进行区分。
+## 常见问题
 
 ### 使用 `updateLiveMetaData` 时有哪些需要注意的限制和规则？