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

package/resource/{doc → knowledge}/livekit/core-sdk/live/android/live-co-guest-interaction.md

@@ -11,7 +11,7 @@
 
 ### 步骤1：组件集成
 
-请参考 开始直播 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
 
 ### 步骤2：实现观众申请上麦
 
@@ -68,14 +68,14 @@
        private val guestListener = object : GuestListener() {
            override fun onGuestApplicationResponded(isAccept: Boolean, hostUser: LiveUserInfo) {
                if (isAccept) {
-                   println("主播 ${hostUser.userName} 同意了你的申请，准备上麦")
+                   println("主播 ${hostUser.userName} 同意了您的申请，准备上麦")
                    // 上麦申请被同意，进行上麦后的操作
                    // 1. 打开摄像头、麦克风
                    DeviceStore.shared().openLocalCamera(true, completion = null)
                    DeviceStore.shared().openLocalMicrophone(completion = null)
                    // 2. 在此更新 UI，例如关闭申请按钮，显示连麦中的状态
                } else {
-                   println("主播 ${hostUser.userName} 拒绝了你的申请")
+                   println("主播 ${hostUser.userName} 拒绝了您的申请")
                    // 上麦申请被拒绝，弹窗提示
                }
            }
@@ -259,9 +259,9 @@
    // 在 HostListener 的实现中添加
    override fun onHostInvitationResponded(isAccept: Boolean, guestUser: LiveUserInfo) {
        if (isAccept) {
-           println("观众 ${guestUser.userName} 接受了你的邀请")
+           println("观众 ${guestUser.userName} 接受了您的邀请")
        } else {
-           println("观众 ${guestUser.userName} 拒绝了你的邀请")
+           println("观众 ${guestUser.userName} 拒绝了您的邀请")
        }
    }
    ```
@@ -332,7 +332,7 @@
 > **提示：**
 >
 
-> 您也可以参考 TUILiveKit 开源项目中的 [widgets](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorboardcast/view/coguest/widgets)目录下文件来了解完整的实现逻辑。
+> 您也可以参考 TUILiveKit 开源项目中的 [widgets](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/audienceview/view/coguest/widgets) 目录下文件来了解完整的实现逻辑。
 >
 
 - **步骤 1**：创建前景视图 (**CustomSeatView**)，该视图用于在视频流上方显示用户信息。
@@ -453,24 +453,24 @@
    ```
 
 #### **参数说明**：
-| **参数** | **类型** | **说明** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>说明</strong> |
 | --- | --- | --- |
-| `seatInfo` | `SeatFullInfo?` | 麦位信息对象，包含麦上用户的详细信息 |
-| `seatInfo.userId` | `String` | 麦上用户的 ID |
-| `seatInfo.userName` | `String ` | 麦上用户的昵称 |
-| `seatInfo.userAvatar` | `String` | 麦上用户的头像 URL |
-| `seatInfo.userMicrophoneStatus` | `DeviceStatus` | 麦上用户的麦克风状态 |
-| `seatInfo.userCameraStatus ` | `DeviceStatus` | 麦上用户的摄像头状态 |
-| `viewLayer` | `ViewLayer` | 视图层级枚举<br>- `FOREGROUND` 表示前景挂件视图，始终显示在视频画面的最上层<br>- `BACKGROUND` 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图 |
+| <code>seatInfo</code> | <code>SeatFullInfo?</code> | 麦位信息对象，包含麦上用户的详细信息。 |
+| <code>seatInfo.userId</code> | <code>String</code> | 麦上用户的 ID。 |
+| <code>seatInfo.userName</code> | <code>String </code> | 麦上用户的昵称。 |
+| <code>seatInfo.userAvatar</code> | <code>String</code> | 麦上用户的头像 URL。 |
+| <code>seatInfo.userMicrophoneStatus</code> | <code>DeviceStatus</code> | 麦上用户的麦克风状态。 |
+| <code>seatInfo.userCameraStatus </code> | <code>DeviceStatus</code> | 麦上用户的摄像头状态。 |
+| <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举<br>- <code>FOREGROUND</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br>- <code>BACKGROUND</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ## API 文档
 
 关于 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-guest-store/index.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Android/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
 | Store/Component | 功能描述 | API 文档 |
 | --- | --- | --- |
-| LiveCoreView | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-live-core-view/index.html) |
-| DeviceStore | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html) |
-| CoGuestStore | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-guest-store/index.html) |
+| LiveCoreView | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-live-core-view/index.html">API 文档</a> |
+| DeviceStore | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html">API 文档</a> |
+| CoGuestStore | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-guest-store/index.html">API 文档</a> |
 
 ## 常见问题
 

package/resource/{doc → knowledge}/livekit/core-sdk/live/android/live-gift.md

@@ -1,7 +1,8 @@
 `GiftStore` 是 `AtomicXCore` 中专门负责管理直播间礼物功能的模块。通过它，您可以为您的直播应用构建一套完整的礼物系统，实现丰富的营收和互动场景。
-| 礼物面板 | 弹幕礼物 | 全屏礼物 |
-| --- | --- | --- |
-|  |  |  |
+
+|礼物面板|弹幕礼物|全屏礼物|
+|---------|---------|---------|
+||||
 
 ## 核心功能
 - **礼物列表获取**：从服务端拉取礼物面板所需的数据，包括礼物分类和礼物详情。
@@ -13,13 +14,14 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `GiftStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| `Gift` | `data class` | 代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。 |
-| `GiftCategory` | `data class` | 代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift** 列表。 |
-| `GiftState` | `data class` | 代表礼物模块的当前状态。其核心属性 usableGifts 是一个 `StateFlow`，存储了从服务端拉取到的完整礼物列表。 |
-| `GiftEvent` | `abstract class` | 代表直播间内发生的礼物事件监听器。目前只有 onReceiveGift，当有任何人（包括自己）发送礼物时，房间内所有人都会收到此事件。 |
-| `GiftStore` | `abstract class` | 这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、发送礼物，并通过添加监听器来接收礼物事件。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|`Gift`|`data class`|代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。|
+|`GiftCategory`|`data class`|代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift** 列表。|
+|`GiftState`|`data class`|代表礼物模块的当前状态。其核心属性 usableGifts 是一个 `StateFlow`，存储了从服务端拉取到的完整礼物列表。|
+|`GiftEvent`|`abstract class`|代表直播间内发生的礼物事件监听器。目前只有 onReceiveGift，当有任何人（包括自己）发送礼物时，房间内所有人都会收到此事件。|
+|`GiftStore`|`abstract class`|这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、发送礼物，并通过添加监听器来接收礼物事件。|
 
 ## 实现步骤
 
@@ -69,6 +71,12 @@ class GiftManager(
     private val _giftList = MutableStateFlow<List<GiftCategory>>(emptyList())
     val giftList: StateFlow<List<GiftCategory>> = _giftList.asStateFlow()
 
+    private val giftListener = object : GiftListener() {
+        override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
+            // 收到事件后，将其转发给UI层处理
+        }
+    }
+
     init {
         setupGiftListener()
         subscribeToGiftState()
@@ -76,11 +84,7 @@ class GiftManager(
 
     /// 2. 订阅礼物事件
     private fun setupGiftListener() {
-        giftStore.addGiftListener(object : GiftListener() {
-            override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
-                // 收到事件后，将其转发给UI层处理
-            }
-        })
+        giftStore.addGiftListener(giftListener)
     }
 
     /// 3. 订阅礼物列表状态
@@ -98,26 +102,26 @@ class GiftManager(
 #### 礼物列表结构体参数
 - `GiftCategory`**参数说明**
 
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `categoryID` | `String` | 礼物分类的唯一 ID。 |
-| `name` | `String` | 礼物分类的显示名称。 |
-| `desc` | `String` | 礼物分类的描述信息。 |
-| `extensionInfo` | `Map<String, String>` | 扩展信息字段。 |
-| `giftList` | `List` | 该分类下包含的 Gift 礼物对象数组。 |
+   |**参数**|**类型**|**描述**|
+   |---------|---------|---------|
+   |`categoryID`|`String`|礼物分类的唯一 ID。|
+   |`name`|`String`|礼物分类的显示名称。|
+   |`desc`|`String`|礼物分类的描述信息。|
+   |`extensionInfo`|`Map<String, String>`|扩展信息字段。|
+   |`giftList`|`List`|该分类下包含的 Gift 礼物对象数组。|
 
 - `Gift`** 参数说明**
 
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `giftID` | `String` | 礼物的唯一 ID。 |
-| `name` | `String` | 礼物的显示名称。 |
-| `desc` | `String` | 礼物的描述信息。 |
-| `iconURL` | `String` | 礼物图标 URL。 |
-| `resourceURL` | `String` | 礼物动画资源 URL。 |
-| `level` | `Long` | 礼物等级。 |
-| `coins` | `Long` | 礼物价格。 |
-| `extensionInfo` | `Map<String, String>` | 扩展信息字段。 |
+   |**参数**|**类型**|**描述**|
+   |---------|---------|---------|
+   |`giftID`|`String`|  礼物的唯一 ID。|
+   |`name`|`String`|  礼物的显示名称。|
+   |`desc`|`String`|  礼物的描述信息。|
+   |`iconURL`|`String`|  礼物图标 URL。|
+   |`resourceURL`|`String`|  礼物动画资源 URL。|
+   |`level`|`Long`|  礼物等级。|
+   |`coins`|`Long`|  礼物价格。|
+   |`extensionInfo`|`Map<String, String>`|  扩展信息字段。|
 
 ### 步骤3：获取礼物列表
 
@@ -189,11 +193,12 @@ class GiftManager(
 ```
 
 #### `sendGift`接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `giftID` | `String` | 要发送的礼物的唯一 ID。 |
-| `count` | `Int` | 发送的数量。 |
-| `completion` | `CompletionHandler?` | 发送完成后的回调。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`giftID`|`String`|要发送的礼物的唯一 ID。|
+|`count`|`Int`|发送的数量。|
+|`completion`|`CompletionHandler?`|发送完成后的回调。|
 
 ## 功能进阶
 
@@ -247,9 +252,10 @@ class GiftManager(
 #### 调用流程图
 
 #### 涉及 REST API 接口一览
-| 接口 | 说明 | 请求示例 |
-| --- | --- | --- |
-| 回调配置 - 发送礼物之前回调 | 客户后台可以通过该回调决定是否通过送礼前校验等场景 | 调用示例 |
+
+|接口|说明|请求示例|
+|---------|---------|---------|
+|回调配置 - 发送礼物之前回调|客户后台可以通过该回调决定是否通过送礼前校验等场景|调用示例|
 
 ### 实现全屏礼物动画播放
 
@@ -258,13 +264,14 @@ class GiftManager(
 #### 实现方式
 
 `AtomicXCore` 本身不包含礼物动画播放器，您需要根据业务需求选择并集成第三方库。以下是两种方案的对比：
-| **对比项** | **基础方案 (SVGAPlayer-Android)** | **高级方案 (TCEffectPlayerKit)** |
-| --- | --- | --- |
-| 计费 | 免费 (开源库) | 付费 (需购买 License)，请参见 [付费指引](https://cloud.tencent.com/document/product/616/116461) |
-| 集成方式 | 需手动集成 SVGAPlayer 库 (例如通过 Gradle) | 需额外集成 TCEffectPlayerKit 并进行鉴权 |
-| 动画格式支持 | 仅支持 SVGA | SVGA、PAG、WebP、Lottie、MP4 等多种格式 |
-| 性能 | 建议 SVGA 文件 ≤ 10MB | 支持更大的动画文件，复杂特效/多动画并发/低端机表现更优 |
-| 推荐场景 | 礼物动画格式统一为 SVGA，且文件大小可控 | 需要支持多种动画格式，或对动画性能/设备兼容性有更高要求 |
+
+|**对比项**|**基础方案 (SVGAPlayer-Android)**|**高级方案 (TCEffectPlayerKit)**|
+|---------|---------|---------|
+|计费|免费 (开源库)|付费 (需购买 License)，请参见 [付费指引](https://cloud.tencent.com/document/product/616/116461)|
+|集成方式|需手动集成 SVGAPlayer 库 (例如通过 Gradle)|需额外集成 TCEffectPlayerKit 并进行鉴权|
+|动画格式支持|仅支持 SVGA|SVGA、PAG、WebP、Lottie、MP4 等多种格式|
+|性能|建议 SVGA 文件 ≤ 10MB|支持更大的动画文件，复杂特效/多动画并发/低端机表现更优|
+|推荐场景|礼物动画格式统一为 SVGA，且文件大小可控|需要支持多种动画格式，或对动画性能/设备兼容性有更高要求|
 
 本章节主要演示基础方案的集成。如果您选择高级方案，请参见 [TCEffectPlayer 集成指引](https://cloud.tencent.com/document/product/616/116472)。
 
@@ -326,21 +333,23 @@ class LiveRoomActivity : AppCompatActivity() {
         }
     }
 
+    private val giftListener = object : GiftListener() {
+        override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
+            if (gift.resourceURL.isNotEmpty()) {
+                try {
+                    val url = URL(gift.resourceURL)
+                    playAnimation(url)
+                } catch (e: Exception) {
+                    println("无效的动画URL: ${gift.resourceURL}")
+                }
+            }
+        }
+    }
+
     fun setupGiftSubscription(liveId: String) {
         giftStore = GiftStore.create(liveId)
 
-        giftStore.addGiftListener(object : GiftListener() {
-            override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
-                if (gift.resourceURL.isNotEmpty()) {
-                    try {
-                        val url = URL(gift.resourceURL)
-                        playAnimation(url)
-                    } catch (e: Exception) {
-                        println("无效的动画URL: ${gift.resourceURL}")
-                    }
-                }
-            }
-        })
+        giftStore.addGiftListener(giftListener)
     }
 
     private fun playAnimation(url: URL) {
@@ -394,25 +403,21 @@ class LiveRoomManager(
 ) {
     private val giftStore: GiftStore = GiftStore.create(liveId)
     private val barrageStore: BarrageStore = BarrageStore.create(liveId)
+    private val giftListener = object : GiftListener() {
+        override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
+            val tipText = "送出了 ${gift.name} x $count"
+            val giftTip = Barrage(
+                liveID = liveID,
+                messageType = BarrageType.TEXT,
+                textContent = tipText
+                sender = sender
+            )
+            barrageStore.appendLocalTip(giftTip)
+        }
+    }
 
     private fun setupGiftToBarrageFlow() {
-        giftStore.addGiftListener(object : GiftListener() {
-            override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
-                // 1. 监听事件 2. 获取信息
-
-                // 4. 拼接消息
-                val tipText = "送出了 ${gift.name} x $count"
-                val giftTip = Barrage(
-                    liveID = liveID,
-                    messageType = BarrageType.TEXT,
-                    textContent = tipText
-                    sender = sender
-                )
-
-                // 5. 本地插入
-                barrageStore.appendLocalTip(giftTip)
-            }
-        })
+        giftStore.addGiftListener(giftListener)
     }
 }
 ```
@@ -420,10 +425,11 @@ class LiveRoomManager(
 ## API 文档
 
 关于 [GiftStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.gift/-gift-store/index.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Android/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| Store/Component | 功能描述 | API 文档 |
-| --- | --- | --- |
-| GiftStore | 礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.gift/-gift-store/index.html) |
-| BarrageStore | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.barrage/-barrage-store/index.html) |
+
+|Store/Component|功能描述|API 文档|
+|---------|---------|---------|
+|GiftStore|礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.gift/-gift-store/index.html)|
+|BarrageStore|弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.barrage/-barrage-store/index.html)|
 
 ## 常见问题
 

package/resource/{doc → knowledge}/livekit/core-sdk/live/android/live-host-interaction.md

@@ -8,7 +8,7 @@
 
 ### 步骤1：组件集成
 
-请参考 开始直播 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
 
 ### 步骤2：实现跨房连线
 
@@ -17,7 +17,7 @@
 #### 邀请方（主播 A）实现
 1. **发起连线邀请**
 
-   当主播A在界面上选择目标主播B并发起连线时，调用 `requestHostConnection` 方法。
+   当主播 A 在界面上选择目标主播 B 并发起连线时，调用 `requestHostConnection` 方法。
 
    ``` kotlin
    import androidx.appcompat.app.AppCompatActivity
@@ -69,11 +69,11 @@
        private val coHostStore = CoHostStore.create(liveId)
        private val coHostListener = object : CoHostListener() {
            override fun onCoHostRequestAccepted(invitee: SeatUserInfo) {
-               println("主播 ${invitee.userName} 同意了你的连线邀请")
+               println("主播 ${invitee.userName} 同意了您的连线邀请")
            }
 
            override fun onCoHostRequestRejected(invitee: SeatUserInfo) {
-               println("主播 ${invitee.userName} 拒绝了你的邀请")
+               println("主播 ${invitee.userName} 拒绝了您的邀请")
            }
 
            override fun onCoHostRequestTimeout(inviter: SeatUserInfo, invitee: SeatUserInfo) {
@@ -94,7 +94,7 @@
 #### 受邀方（主播 B）实现
 1. **接收连线邀请**
 
-   通过 `CoHostListener`，主播B可以监听到来自主播A的邀请。
+   通过 `CoHostListener`，主播 B 可以监听到来自主播 A 的邀请。
 
    ``` kotlin
    import androidx.appcompat.app.AppCompatActivity
@@ -118,7 +118,7 @@
    ```
 2. **响应连线邀请**
 
-   当主播B在弹出的对话框中做出选择后，调用相应的方法。
+   当主播 B 在弹出的对话框中做出选择后，调用相应的方法。
 
    ``` kotlin
    // AnchorBActivity 的一部分
@@ -250,7 +250,7 @@
    > **提示：**
    >
 
-   > 您也可以参考 TUILiveKit 开源项目中的 [widgets](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorboardcast/view/cohost/widgets) 目录下文件来了解完整的实现逻辑。
+   > 您也可以参考 TUILiveKit 开源项目中的 [widgets](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/cohost/widgets) 目录下文件来了解完整的实现逻辑。
    >
 
    ``` kotlin
@@ -354,15 +354,15 @@
    ```
 
 #### **参数说明**：
-| **参数** | **类型** | **说明** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>说明</strong> |
 | --- | --- | --- |
-| `seatInfo` | `SeatFullInfo?` | 麦位信息对象，包含麦上用户的详细信息 |
-| `seatInfo.userId` | `String` | 麦上用户的 ID |
-| `seatInfo.userName` | `String` | 麦上用户的昵称 |
-| `seatInfo.userAvatar` | `String` | 麦上用户的头像 URL |
-| `seatInfo.userMicrophoneStatus` | `DeviceStatus` | 麦上用户的麦克风状态 |
-| `seatInfo.userCameraStatus ` | `DeviceStatus` | 麦上用户的摄像头状态 |
-| `viewLayer` | `ViewLayer` | 视图层级枚举<br>- `FOREGROUND` 表示前景挂件视图，始终显示在视频画面的最上层<br>- `BACKGROUND` 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图 |
+| <code>seatInfo</code> | <code>SeatFullInfo?</code> | 麦位信息对象，包含麦上用户的详细信息。 |
+| <code>seatInfo.userId</code> | <code>String</code> | 麦上用户的 ID。 |
+| <code>seatInfo.userName</code> | <code>String</code> | 麦上用户的昵称。 |
+| <code>seatInfo.userAvatar</code> | <code>String</code> | 麦上用户的头像 URL。 |
+| <code>seatInfo.userMicrophoneStatus</code> | <code>DeviceStatus</code> | 麦上用户的麦克风状态。 |
+| <code>seatInfo.userCameraStatus </code> | <code>DeviceStatus</code> | 麦上用户的摄像头状态。 |
+| <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举<br>- <code>FOREGROUND</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br>- <code>BACKGROUND</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ### 实现 PK 用户视图的分数展示
 
@@ -371,7 +371,7 @@
 #### **实现效果**
 
 #### 实现方式
-- **步骤1**：创建自定义 PK 用户视图，您可以参考 TUILiveKit 开源项目中的 [BattleMemberInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorboardcast/view/battle/widgets/BattleMemberInfoView.kt) 文件来了解完整的实现逻辑。
+- **步骤1**：创建自定义 PK 用户视图，您可以参考 TUILiveKit 开源项目中的 [BattleMemberInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/battle/widgets/BattleMemberInfoView.kt) 文件来了解完整的实现逻辑。
 
    ``` kotlin
    import android.content.Context
@@ -460,21 +460,22 @@
    ```
 
 #### **参数说明**：
-| **参数** | **类型** | **说明** |
-| --- | --- | --- |
-| `battleUser` | `BattleUser?` | PK 用户信息对象 |
-| `battleUser.roomId` | `String` | PK 的房间 ID |
-| `battleUser.userId` | `String` | PK 用户 ID |
-| `battleUser.userName` | `String` | PK 用户昵称 |
-| `battleUser.avatarUrl` | `String` | PK 用户头像地址 |
-| `battleUser.score` | `int` | PK 分数 |
+
+|**参数**|**类型**|**说明**|
+|---------|---------|---------|
+|`battleUser`|`BattleUser?`|PK 用户信息对象。|
+|`battleUser.roomId`|`String`|PK 的房间 ID。|
+|`battleUser.userId`|`String`|PK 用户 ID。|
+|`battleUser.userName`|`String`|PK 用户昵称。|
+|`battleUser.avatarUrl`|`String`|PK 用户头像地址。|
+|`battleUser.score`|`int`|PK 分数。|
 
 ### 实现视频流画面上的 PK 状态显示
 
 #### **实现效果**
 
 #### **实现方式**
-- **步骤1：**创建自定义 PK 全局视图 **CustomBattleContainerView**，您可以参考 TUILiveKit 开源项目中的 [BattleInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorboardcast/view/battle/widgets/BattleInfoView.kt) 文件来实现，即可实现同样的效果。
+- **步骤1：**创建自定义 PK 全局视图 **CustomBattleContainerView**，您可以参考 TUILiveKit 开源项目中的 [BattleInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/battle/widgets/BattleInfoView.kt) 文件来实现，即可实现同样的效果。
 
 - **步骤2**：实现 `VideoViewAdapter.createBattleContainerView` 协议。
 
@@ -498,12 +499,13 @@
 
 > LiveKit 后台的 PK 分数系统采用纯数值计算和累加机制，所以您需要根据自身的运营策略和业务需求，在调用更新接口前完成 PK 分数的计算，您可以参考如下的 PK 分数计算示例：
 >
-| 礼物类型 | 分数计算规则 | 示例 |
-| --- | --- | --- |
-| ​基础礼物​ | 礼物价值 × 5 | 10元礼物 → 50分 |
-| ​中级礼物​ | 礼物价值 × 8 | 50元礼物 → 400分 |
-| ​高级礼物​ | 礼物价值 × 12 | 100元礼物 → 1200分 |
-| ​特效礼物​ | 固定高分数 | 520元礼物 → 1314分 |
+
+|礼物类型|分数计算规则|示例|
+|---------|---------|---------|
+|​基础礼物​|礼物价值 × 5|10元礼物 → 50分|
+|​中级礼物​|礼物价值 × 8|50元礼物 → 400分|
+|​高级礼物​|礼物价值 × 12|100元礼物 → 1200分|
+|​特效礼物​|固定高分数|520元礼物 → 1314分|
 
 #### REST API 调用流程
 
@@ -514,29 +516,31 @@
 
   - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
 
-2. **PK分数计算**​：您的后台服务根据业务规则（如上述示例），计算 PK 分数增量。
+2. **PK 分数计算**​：您的后台服务根据业务规则（如上述示例），计算 PK 分数增量。
 
-3. **PK分数更新​**：您的后台服务调用 修改 PK 分数 接口，向 LiveKit 后台更新 PK 分数。
+3. **PK 分数更新​**：您的后台服务调用 修改 PK 分数 接口，向 LiveKit 后台更新 PK 分数。
 
-4. **LiveKit后台 同步客户端**​：LiveKit 后台自动将更新后的 PK 分数同步到所有客户端。
+4. **LiveKit 后台 同步客户端**​：LiveKit 后台自动将更新后的 PK 分数同步到所有客户端。
 
 #### 涉及的 REST API 接口
-| 接口 | 功能描述 | 请求示例 |
-| --- | --- | --- |
-| 主动接口 - 查询 PK 状态 | 可根据此接口查询当前房间是否在 PK | 请求示例 |
-| 主动接口 - 修改 PK 分数 | 将计算后的 PK 数值通过此接口更新 | 请求示例 |
-| 回调配置 - PK 开始时回调 | 客户后台可以通过该回调及时知晓 PK 开启 | 回调示例 |
-| 回调配置 - PK 结束时回调 | 客户后台可以通过该回调及时知晓 PK 结束 | 回调示例 |
+
+|接口|功能描述|请求示例|
+|---------|---------|---------|
+|主动接口 - 查询 PK 状态|可根据此接口查询当前房间是否在 PK。|请求示例|
+|主动接口 - 修改 PK 分数|将计算后的 PK 数值通过此接口更新。|请求示例|
+|回调配置 - PK 开始时回调|客户后台可以通过该回调及时知晓 PK 开启。|回调示例|
+|回调配置 - PK 结束时回调|客户后台可以通过该回调及时知晓 PK 结束。|回调示例|
 
 ## API 文档
 
 关于 [CoHostStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-host-store/index.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Android/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| Store/Component | 功能描述 | API 文档 |
-| --- | --- | --- |
-| LiveCoreView | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-live-core-view/index.html) |
-| DeviceStore | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html) |
-| CoHostStore | 主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-host-store/index.html) |
-| BattleStore | 主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-battle-store/index.html) |
+
+|Store/Component|功能描述|API 文档|
+|---------|---------|---------|
+|LiveCoreView|直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-live-core-view/index.html)|
+|DeviceStore|音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html)|
+|CoHostStore|主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-host-store/index.html)|
+|BattleStore|主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-battle-store/index.html)|
 
 ## 常见问题
 
@@ -545,13 +549,13 @@
 
 - 检查网络连接是否通畅，邀请信令有30秒的默认超时时间。
 
-### 连线或PK过程中，一方主播网络断开或App崩溃了怎么办？
+### 连线或 PK 过程中，一方主播网络断开或 App 崩溃了怎么办？
 
-**CoHostStore** 和 **BattleStore** 内部都有心跳和超时检测机制。如果一方异常退出，另一方会通过 **onCoHostUserLeft** 或 **onUserExitBattle** 等事件收到通知，您可以根据这些事件来处理UI，例如提示"对方已掉线"并结束互动。
+**CoHostStore** 和 **BattleStore** 内部都有心跳和超时检测机制。如果一方异常退出，另一方会通过 **onCoHostUserLeft** 或 **onUserExitBattle** 等事件收到通知，您可以根据这些事件来处理 UI，例如提示"对方已掉线"并结束互动。
 
 ### 为什么 PK 分数只能通过 REST API 更新？
 
-因为 REST API  能同时满足 PK 分数的**安全性、实时性、扩展性**需求：
+因为 REST API 能同时满足 PK 分数的**安全性、实时性、扩展性**需求：
 - **防篡改保公平**：需鉴权 + 数据校验，每笔更新可追溯来源（例如礼物行为），杜绝手动改分、刷分，保障竞技公平；
 
 - **多端实时同步**：用标准化格式（例如 JSON）快速对接礼物、PK、展示系统，确保主播 / 观众 / 后台分数实时一致，无延迟；