@tencentcloud/sdk-mcp 1.3.9 → 1.4.0

package/resource/doc/livekit/{voice → core-sdk/voice}/uni-app/voice-co-guest-interaction.md

@@ -1,8 +1,5 @@
 **AtomicXCore** 提供了 [CoGuestState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState) 和 [LiveSeatState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveSeatState) 模块，用于管理观众连麦的完整业务流程。您无需关心复杂的状态同步和信令交互，只需调用几个简单的方法，即可为您的直播添加强大的观众与主播音视频互动功能。本文档将指导您如何使用 `CoGuestState `和 `LiveSeatState`在您的应用中快速实现语音连麦功能。
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100028028022/e508b7a6ba1c11f0a6c652540044a08e.png)
-
-
 ## 核心场景
 
 `CoGuestState`和 `LiveSeatState`支持以下几个主流的场景：
@@ -12,12 +9,11 @@
 
 - **主播管理麦位**：主播可以对麦位上的用户进行踢人、闭麦、锁麦等操作。
 
-
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 [快速接入](https://write.woa.com/document/191656297444069376) 集成 **AtomicXCore**。
+请参考 快速接入 集成 **AtomicXCore**。
 
 ### 步骤2：实现观众申请上麦
 
@@ -26,32 +22,30 @@
 作为观众，您的核心任务是**发起申请、接收结果**和**主动下麦**。
 1. **发起连麦申请**
 
-
    当用户点击界面上的“申请连麦”按钮时，调用 `applyForSeat` 方法。
 
    ``` typescript
    import { useCoGuestState } from "@/uni_modules/tuikit-atomic-x/state/CoGuestState";
-   
+
    // 先获取要加入的语聊房 ID（liveID）。通常有以下几种方式：
    // 通过房间列表选择（可从 LiveListState 的 liveList 数据中获取）
-    
+
    const liveID = "xxx" // 您当前加入语聊房的 liveID
-   
+
    //通过 liveID 获取 CoGuestState 的实例
    const { applyForSeat } = useCoGuestState(liveID);
-   
+
    // 用户点击“申请连麦”
    const handleRequestToConnect = () => {
-       applyForSeat({ 
+       applyForSeat({
          liveID,
          seatIndex: -1, // 申请的麦位，申请上麦传 -1, 随机分配麦位
          timeout: 30, // 请求超时时间，例如 30s
        })
-   } 
+   }
    ```
 2. **监听主播的处理结果**
 
-
    通过  `addCoGuestGuestListener` 订阅`'onGuestApplicationResponded'` 事件，您可以接收到主播的处理结果。
 
    ``` typescript
@@ -61,12 +55,12 @@
    const liveID = "xxx" // 您当前加入语聊房的 liveID
    const { addCoGuestGuestListener } = useCoGuestState(liveID);
    const { openLocalMicrophone } = useDeviceState(liveID);
-     
+
    // 在页面初始化时订阅事件
    onMounted(() => {
        addCoGuestGuestListener(liveID, 'onGuestApplicationResponded', handleGuestApplicationResponded)
    })
-    
+
    const handleGuestApplicationResponded = {
        callback: (event) => {
          const res = JSON.parse(event)
@@ -84,14 +78,13 @@
    ```
 3. **主动下麦**
 
-
    当连麦观众想结束互动时，调用 `disConnect` 方法即可返回普通观众状态。
 
    ``` typescript
    import { useCoGuestState } from "@/uni_modules/tuikit-atomic-x/state/CoGuestState";
    const liveID = "xxx" // 您当前加入语聊房的 liveID
    const { disconnect } = useCoGuestState(liveID);
-   
+
    // 用户点击“下麦”按钮
    const leaveSeat = () => {
        disconnect({
@@ -107,14 +100,13 @@
    ```
 4. **(可选) 取消申请**
 
-
    如果观众在主播处理前想撤回申请，可以调用 `cancelApplication` 。
 
    ``` typescript
    import { useCoGuestState } from "@/uni_modules/tuikit-atomic-x/state/CoGuestState";
    const liveID = "xxx" // 您当前加入的语聊房的 liveID
    const { cancelApplication } = useCoGuestState(liveID);
-   
+
    // 用户在等待时，点击“取消申请”
    const handelCancelRequest = () => {
        cancelApplication({
@@ -134,7 +126,6 @@
 作为主播，您的核心任务是**接收申请、展示申请列表**和**处理申请**。
 1. **监听新的连麦申请**
 
-
    通过 `CoGuestHostListener` 订阅 `'onGuestApplicationReceived'` 事件您可以在有新观众申请时立即收到通知，并给出提示。
 
    ``` typescript
@@ -142,12 +133,12 @@
    import { useCoGuestState } from "@/uni_modules/tuikit-atomic-x/state/CoGuestState";
    const liveID = "xxx" // 您当前语聊房的 liveID
    const { addCoGuestHostListener } = useCoGuestState(liveID);
-   
+
    // 在页面初始化时订阅事件
    onMounted(() => {
        addCoGuestHostListener(liveID, 'onGuestApplicationReceived', handleGuestApplicationReceived)
    })
-    
+
    const handleGuestApplicationReceived =  {
        callback: (event) => {
          const res = JSON.parse(event)
@@ -158,7 +149,6 @@
    ```
 2. **展示申请列表**
 
-
    `CoGuestState` 会实时维护当前的申请者列表，数据本身是响应式数据，您可以直接在 UI 上使用。
 
    ``` typescript
@@ -177,14 +167,13 @@
    ```
 3. **处理连麦申请**
 
-
    当您在列表中选择一位观众并点击“同意”或“拒绝”时，调用相应的方法。
 
    ``` typescript
    import { useCoGuestState } from "@/uni_modules/tuikit-atomic-x/state/CoGuestState";
    const liveID = "xxx" // 您当前语聊房的 liveID
    const { acceptApplication, rejectApplication } = useCoGuestState(liveID);
-   
+
    // 主播点击“同意”按钮，传入申请者的 userID
    const handleAccept = (userID: string) => {
        acceptApplication({
@@ -196,10 +185,10 @@
          fail: (error) => {
            console.log('同意${userID}的上麦申请失败', error)
          }
-   
+
        })
    }
-   
+
    // 主播点击“拒绝”按钮，传入申请者的 userID
    const handleReject = (userID: string) => {
        rejectApplication({
@@ -220,14 +209,13 @@
 #### 主播端实现
 1. **向观众发起邀请**
 
-
    当主播在观众列表中选择某人并点击“邀请连麦”时，调用 `inviteToSeat` 方法。
 
    ``` typescript
    import { useCoGuestState } from "@/uni_modules/tuikit-atomic-x/state/CoGuestState";
    const liveID = "xxx" // 您当前语聊房的 liveID
    const { inviteToSeat } = useCoGuestState(liveID);
-   
+
    // 主播选择观众并发起邀请
    const handleInviteToSeat = (userID: string) => {
        inviteToSeat({
@@ -246,7 +234,6 @@
    ```
 2. **监听观众的回应**
 
-
    通过 `CoGuestHostListener` 订阅 `'onHostInvitationResponded'` 事件。
 
    ``` typescript
@@ -254,12 +241,12 @@
    import { useCoGuestState } from "@/uni_modules/tuikit-atomic-x/state/CoGuestState";
    const liveID = "xxx" // 您当前语聊房的 liveID
    const { addCoGuestHostListener } = useCoGuestState(liveID);
-   
-   // 在页面初始化时订阅事件 
+
+   // 在页面初始化时订阅事件
    onMounted(() => {
        addCoGuestHostListener(liveID, 'onHostInvitationResponded', handleHostInvitationResponded)
    })
-    
+
    const handleHostInvitationResponded =  {
        callback: (event) => {
          const res = JSON.parse(event)
@@ -275,7 +262,6 @@
 #### 观众端实现
 1. **接收主播的邀请**
 
-
    通过 `addCoGuestGuestListener` 订阅 `'onHostInvitationReceived'` 事件。
 
    ``` typescript
@@ -283,12 +269,12 @@
    import { useCoGuestState } from "@/uni_modules/tuikit-atomic-x/state/CoGuestState";
    const liveID = "xxx" // 您当前加入语聊房的 liveID
    const { addCoGuestGuestListener } = useCoGuestState(liveID);
-   
+
    // 在页面初始化时订阅事件
    onMounted(() => {
        addCoGuestGuestListener(liveID, 'onHostInvitationReceived', handleHostInvitationReceived)
    })
-    
+
    const handleHostInvitationReceived =  {
        callback: (event) => {
          // 在此弹出一个对话框，让用户选择“接受”或“拒绝”
@@ -297,7 +283,6 @@
    ```
 2. **响应邀请**
 
-
    当用户在弹出的对话框中做出选择后，调用相应的方法。
 
    ``` typescript
@@ -306,9 +291,9 @@
    const liveID = "xxx" // 您当前加入的语聊房的 liveID
    const { acceptInvitation, rejectInvitation } = useCoGuestState(liveID);
    const { openLocalMicrophone, openLocalCamera } = useDeviceState(liveID);
-   
+
    const inviterID = "发起邀请的主播ID" // 从 onHostInvitationReceived 事件中获取
-   
+
    // 用户点击“接受”，
    const handleAccept = () => {
        acceptInvitation({
@@ -338,7 +323,6 @@
 
 2. **解除静音**：调用 `unmuteMicrophone(success: fail:) `方法。
 
-
 #### 示例代码：
 ``` typescript
 import { useLiveSeatState } from "@/uni_modules/tuikit-atomic-x/state/LiveSeatState";
@@ -365,32 +349,10 @@ const unmuteMic = () => {
 ```
 
 #### unmuteMicrophone 接口参数：
-<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" >`success`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >解除静音的回调</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`fail`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >解除静音失败的回调。</td>
-</tr>
-</table>
-
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `success` | `Function` | 解除静音的回调 |
+| `fail` | `Function` | 解除静音失败的回调。 |
 
 ### 主播远程控制麦上用户开麦或关麦
 
@@ -403,7 +365,6 @@ const unmuteMic = () => {
 
 3. **用户自行开麦**：用户在收到“解除锁定”的通知后，必须主动调用 `LiveSeatState` 的 `unmuteMicrophone()`方法解除静音，才能让房间内其他人听到自己的声音。
 
-
 #### 示例代码：
 
 ##### 主播端：
@@ -470,92 +431,20 @@ onMounted(() => {
 ```
 
 #### closeRemoteMicrophone 接口参数：
-<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" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >当前语聊房的`liveID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`userID`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >被操作的用户`userID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`success`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >静音成功的回调。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`fail`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >静音失败的回调。</td>
-</tr>
-</table>
-
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `liveID` | `string` | 当前语聊房的`liveID`。 |
+| `userID` | `string` | 被操作的用户`userID`。 |
+| `success` | `Function` | 静音成功的回调。 |
+| `fail` | `Function` | 静音失败的回调。 |
 
 #### openRemoteMicrophone 接口参数：
-<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" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >当前语聊房的`liveID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`userID`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >被操作的用户`userID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`success`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >解除静音成功的回调。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`fail`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >解除静音失败的回调。</td>
-</tr>
-</table>
-
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `liveID` | `string` | 当前语聊房的`liveID`。 |
+| `userID` | `string` | 被操作的用户`userID`。 |
+| `success` | `Function` | 解除静音成功的回调。 |
+| `fail` | `Function` | 解除静音失败的回调。 |
 
 ### 主播将麦上用户踢下麦位
 
@@ -564,7 +453,6 @@ onMounted(() => {
 
 2. **监听事件通知**：被踢下麦的用户会收到 `'onKickedOffSeat'` 事件通知。
 
-
 #### 示例代码：
 ``` typescript
 import { onMounted } from 'vue';
@@ -601,48 +489,12 @@ onMounted(() => {
 ```
 
 #### kickUserOutOfSeat 接口参数：
-<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" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >当前语聊房的`liveID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`userID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >被踢下麦的用户`userID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`success`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >踢下麦成功的回调。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`fail`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >踢下麦失败的回调。</td>
-</tr>
-</table>
-
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `liveID` | `string` | 当前语聊房的`liveID`。 |
+| `userID` | `String` | 被踢下麦的用户`userID`。 |
+| `success` | `Function` | 踢下麦成功的回调。 |
+| `fail` | `Function` | 踢下麦失败的回调。 |
 
 ### 主播锁定和解锁麦位
 
@@ -653,7 +505,6 @@ onMounted(() => {
 
 2. **解锁麦位**：调用 `unlockSeat` 可以解锁麦位，解锁后该麦位可以再次被占用。
 
-
 #### 示例代码：
 ``` typescript
 import { useLiveSeatState } from "@/uni_modules/tuikit-atomic-x/state/LiveSeatState";
@@ -661,7 +512,6 @@ import { useLiveSeatState } from "@/uni_modules/tuikit-atomic-x/state/LiveSeatSt
 //通过 liveID 获取 LiveSeatState 的实例
 const { lockSeat, unlockSeat } = useLiveSeatState(liveID);
 
-
 // 锁定2号麦位
 const lock = () => {
     lockSeat({
@@ -692,92 +542,20 @@ const unlock = () => {
 ```
 
 #### lockSeat 接口参数：
-<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" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >当前语聊房的`liveID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`seatIndex`</td>
-
-<td rowspan="1" colSpan="1" >`number`</td>
-
-<td rowspan="1" colSpan="1" >需要锁定的麦位索引。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`success`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >锁麦成功的回调。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`fail`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >锁麦失败的回调。</td>
-</tr>
-</table>
-
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `liveID` | `string` | 当前语聊房的`liveID`。 |
+| `seatIndex` | `number` | 需要锁定的麦位索引。 |
+| `success` | `Function` | 锁麦成功的回调。 |
+| `fail` | `Function` | 锁麦失败的回调。 |
 
 #### unlockSeat 接口参数：
-<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" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >当前语聊房的`liveID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`seatIndex`</td>
-
-<td rowspan="1" colSpan="1" >`number`</td>
-
-<td rowspan="1" colSpan="1" >需要解锁的麦位索引。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`success`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >解锁麦位成功的回调。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`fail`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >解锁麦位失败的回调。</td>
-</tr>
-</table>
-
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `liveID` | `string` | 当前语聊房的`liveID`。 |
+| `seatIndex` | `number` | 需要解锁的麦位索引。 |
+| `success` | `Function` | 解锁麦位成功的回调。 |
+| `fail` | `Function` | 解锁麦位失败的回调。 |
 
 ### 移动麦位
 
@@ -788,7 +566,6 @@ const unlock = () => {
 
 2. **普通上麦用户移动自己麦位**：普通上麦用户也可以调用此接口来移动自己。此时 `userID` 必须传入用户自己的 ID，`targetIndex` 传入想去的新麦位索引，此时`policy` 参数无效，如果目标麦位有人时会报错并停止移动。
 
-
 #### 示例代码：
 ``` typescript
 import { useLiveSeatState } from "@/uni_modules/tuikit-atomic-x/state/LiveSeatState";
@@ -813,86 +590,21 @@ const moveSeat = () => {
 ```
 
 #### moveUserToSeat 接口参数：
-<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" >`userID`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >需要移麦的用户`userID`。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`targetIndex`</td>
-
-<td rowspan="1" colSpan="1" >`number`</td>
-
-<td rowspan="1" colSpan="1" >目标麦位索引。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`policy`</td>
-
-<td rowspan="1" colSpan="1" >`string`</td>
-
-<td rowspan="1" colSpan="1" >目标麦位有人时的移动策略枚举：<br>- `'ABORT_WHEN_OCCUPIED'`：目标麦位有人时放弃移动（默认策略）​​<br>- `'FORCE_REPLACE'`：强制替换目标麦位上的用户​​，被替换的用户将会被踢下麦<br>- `'SWAP_POSITION'`：与目标麦位用户交换位置​​。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`success`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >移动麦位成功的回调。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`fail`</td>
-
-<td rowspan="1" colSpan="1" >`Function`</td>
-
-<td rowspan="1" colSpan="1" >移动麦位失败的回调。</td>
-</tr>
-</table>
-
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `userID` | `string` | 需要移麦的用户`userID`。 |
+| `targetIndex` | `number` | 目标麦位索引。 |
+| `policy` | `string` | 目标麦位有人时的移动策略枚举：<br>- `'ABORT_WHEN_OCCUPIED'`：目标麦位有人时放弃移动（默认策略）​​<br>- `'FORCE_REPLACE'`：强制替换目标麦位上的用户​​，被替换的用户将会被踢下麦<br>- `'SWAP_POSITION'`：与目标麦位用户交换位置​​。 |
+| `success` | `Function` | 移动麦位成功的回调。 |
+| `fail` | `Function` | 移动麦位失败的回调。 |
 
 ## API 文档
 
-关于 [CoGuestState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState) 和 [LiveSeatState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveSeatState) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 [AtomicXCore](https://write.woa.com/document/192223419814899712) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**State**</td>
-
-<td rowspan="1" colSpan="1" >**功能描述**</td>
-
-<td rowspan="1" colSpan="1" >**API 文档**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >CoGuestState</td>
-
-<td rowspan="1" colSpan="1" >观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >LiveSeatState</td>
-
-<td rowspan="1" colSpan="1" >麦位管理：静音/解除静音，锁定/解锁麦位，踢人下麦、远程控制麦上用户麦克风，麦列表状态监听</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveSeatState)</td>
-</tr>
-</table>
-
+关于 [CoGuestState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState) 和 [LiveSeatState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveSeatState) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 AtomicXCore 框架的官方 API 文档。本指南使用到的相关 Store 如下：
+| **State** | **功能描述** | **API 文档** |
+| --- | --- | --- |
+| CoGuestState | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoGuestState) |
+| LiveSeatState | 麦位管理：静音/解除静音，锁定/解锁麦位，踢人下麦、远程控制麦上用户麦克风，麦列表状态监听 | [API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-LiveSeatState) |
 
 ## 常见问题
 
@@ -903,7 +615,6 @@ const moveSeat = () => {
 
 - 语音房（语聊房）：核心是麦位网格。您不会使用 `LiveCoreView`，而是会基于 `LiveSeatState` 的数据（特别是 `seatList`）来构建一个网格 UI 。UI 的重点是实时显示每个麦位 `SeatInfo` 的状态：是否有人、是否静音、是否被锁定 ，以及是否正在说话。您只需要打开麦克风。
 
-
 ### 如何在 UI 上实时刷新麦位信息（如是否有人、是否静音）？
 
 您应该订阅 `LiveSeatState` 中的 `seatList` 属性，它是一个`[SeatInfo]` 数组类型的响应式数据，每当数组变化时都会通知您重新渲染麦位列表。遍历此数组，您可以：
@@ -913,7 +624,6 @@ const moveSeat = () => {
 
 - 通过 `seatInfo.userInfo.microphoneStatus` 判断麦上用户的麦克风状态。
 
-
 ### LiveSeatState 和 DeviceState  都有麦克风接口，它们有何区别？
 
 这是一个非常重要的问题。`DeviceState` 管理的是物理设备，而 `LiveSeatState` 管理的是麦位业务（即音频流）。
@@ -923,14 +633,12 @@ const moveSeat = () => {
 
 - `closeLocalMicrophone`：停止音频采集并释放麦克风设备。
 
-
    `LiveSeatState`：
 
 - `muteMicrophone`：静音。停止向远端发送本地的音频流，但麦克风设备本身仍在运行。
 
 - `unmuteMicrophone`：解除静音。恢复向远端发送音频流。
 
-
    推荐的工作流程：您应该遵循“设备只开一次，麦上只用静音切换”的原则
 
 1. **上麦时**：当观众成功上麦，调用一次 `openLocalMicrophone` 来启动设备。
@@ -938,7 +646,3 @@ const moveSeat = () => {
 2. **在麦上时**：用户在麦位上所有的“开麦”和“闭麦”操作，都应该调用 `unmuteMicrophone` 和 `muteMicrophone` 来控制上行音频流的通断。
 
 3. **下麦时**：当用户下麦（例如调用 `disconnect` ），调用 `closeLocalMicrophone` 来释放设备。
-
-
-
-