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

package/resource/{doc → knowledge}/livekit/core-sdk/voice/android/voice-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/voice/android/voice-host-interaction.md

@@ -3,18 +3,19 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下跨房连线与 PK 相关的几个核心概念。
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| **CoHostStore** | 抽象类 | 管理主播间的连线生命周期，提供连线功能 API（requestHostConnection、acceptHostConnection）。 |
-| **BattleStore** | 抽象类 | 管理跨房 PK 对战的信令与数据，包括 PK 状态。 |
-| **LiveListStore** | 单例 | 提供直播房间列表的拉取功能 (`fetchLiveList`)，用于获取可连线的其他房间信息。 |
-| **LiveSeatStore** | 抽象类 | 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风等状态。 |
-| **CoHostLayoutTemplate** | 枚举 | 连线时，用于指定房间麦位布局模板，例如 `HOST_STATIC_VOICE_6V6`。 |
-| **BattleConfig** | 数据模型 | 配置 PK 的详细信息，例如 PK 时长 (`duration`) 和是否需要二次响应 (`needResponse`)。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|**CoHostStore**|抽象类|管理主播间的连线生命周期，提供连线功能 API（requestHostConnection、acceptHostConnection）。|
+|**BattleStore**|抽象类|管理跨房 PK 对战的信令与数据，包括 PK 状态。|
+|**LiveListStore**|单例|提供直播房间列表的拉取功能 (`fetchLiveList`)，用于获取可连线的其他房间信息。|
+|**LiveSeatStore**|抽象类|管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风等状态。|
+|**CoHostLayoutTemplate**|枚举|连线时，用于指定房间麦位布局模板，例如 `HOST_STATIC_VOICE_6V6`。|
+|**BattleConfig**|数据模型|配置 PK 的详细信息，例如 PK 时长 (`duration`) 和是否需要二次响应 (`needResponse`)。|
 
 ## 前提条件
 
-请参考 快速接入 集成 **AtomicXCore SDK**，并完成 **主播开播** 和 **观众观看** 的功能实现。
+请参考 开播与收听 集成 **AtomicXCore SDK**，并完成 **主播开播** 和 **观众观看** 的功能实现。
 
 ## 主播发起一场连线
 
@@ -28,7 +29,7 @@
 >
 > - 如果接口返回的列表中没有找到您想要的直播间，您需要检查开播时设置的 `TUILiveInfo` 的 `isPublicVisible` 字段是否为 `true`；
 > - 该接口支持分页继续拉取，您可以使用接口 `onSuccess` 回调中 `cursor` 作为下一次续拉的游标，如果返回的 `cursor` 为空，则表示直播间列表已全部拉取完；
-> - 为了性能考虑，建议您将pageCount设置为 20。
+> - 为了性能考虑，建议您将 pageCount 设置为 20。
 
 ``` java
 import io.trtc.tuikit.atomicxcore.api.live.LiveListStore
@@ -150,7 +151,7 @@ liveSeatStore.liveSeatState.seatList.collect { seatList: List<SeatInfo> ->
 
 ### 步骤6：连线过程中继续邀请其他主播参与连线
 
-AtomicXCore 支持您在已经连线的过程中，还可以继续邀请其他主播参与连线，您可以继续调用`requestHostConnection`邀请新的主播参与连线。
+AtomicXCore 支持您在已经连线的过程中，还可以继续邀请其他主播参与连线，您可以继续调用 `requestHostConnection` 邀请新的主播参与连线。
 ``` java
 import io.trtc.tuikit.atomicxcore.api.live.CoHostLayoutTemplate
 import io.trtc.tuikit.atomicxcore.api.CompletionHandler
@@ -198,10 +199,11 @@ public void onExitButtonClicked() {
 ## 主播发起 PK
 
 主播发起 PK 支持两种主要业务流程，以满足不同直播互动需求。核心区别在于 PK 发起前房间的状态。
-| **PK 模式** | **房间状态（PK 前）** | **房间状态（PK 后）** |
-| --- | --- | --- |
-| **场景一：主播在连线后再发起 PK** | 双方**已连线** | 恢复连线状态 |
-| **场景二：主播发起带 PK 模式的连线** | 双方**未连线** | 恢复连线状态 |
+
+|**PK 模式**|**房间状态（PK 前）**|**房间状态（PK 后）**|
+|---------|---------|---------|
+|**场景一：主播在连线后再发起 PK**|双方**已连线**|恢复连线状态|
+|**场景二：主播发起带 PK 模式的连线**|双方**未连线**|恢复连线状态|
 
 ### 场景一：主播在连线后再发起 PK
 
@@ -210,7 +212,7 @@ AtomicXCore 支持您在这些主播中发起限时的对战 PK。交互如下
 
 2. 参与连线的主播，点击 PK 按钮发起一场限时的对战，可以通过主播收到的礼物数来判定对战的胜负。
 
-3. 对端主播可以弹框提醒，并提示是否加入PK，当被邀请的主播同意后对战即刻开始。
+3. 对端主播可以弹框提醒，并提示是否加入 PK，当被邀请的主播同意后对战即刻开始。
 
 4. PK 开始后，UI 进入对战状态，显示 PK 进度条；该进度条可以是主播收到的礼物数，也可以是收到的点赞数等业务数据。
 
@@ -249,7 +251,7 @@ battleStore.requestBattle(
 
 #### 步骤 2. 对端主播收到 PK 邀请
 
-当 PK 请求成功发出后，对端主播会收到 `BattleListener` 的 `onBattleRequestReceived` 回调，您可以在这个回调中给对端主播的UI 提醒 “有人邀请您 PK”，您也可以通过该回调的 battleInfo 参数的 config 字段中的 needResponse 信息确认是否需要 UI 提醒，例如：
+当 PK 请求成功发出后，对端主播会收到 `BattleListener` 的 `onBattleRequestReceived` 回调，您可以在这个回调中给对端主播的 UI 提醒 “有人邀请您 PK”，您也可以通过该回调的 battleInfo 参数的 config 字段中的 needResponse 信息确认是否需要 UI 提醒，例如：
 - 当 needResponse 为 false 时，您无需提醒，直接进入 PK 状态（详见步骤 3）。
 
 - 当 needResponse 为 true 时，您可以弹框提醒 “有人邀请您 PK”，当对端主播点击同意后进入 PK 状态（详见步骤 3）。
@@ -292,7 +294,7 @@ battleStore.requestBattle(
 
 ##### 2. 主动调用 exitBattle 结束 PK
 
-在 PK 过程中，参与 PK 的任一主播均可以调用 `BattleStore` 的 `exitBattle` 退出 PK，其他主播依然处于 PK 中不受影响，且会收到 `BattleListener` 的 `onUserExitBattle` 回调，您可以在这个回调中提醒 “有人退出 PK”；如果在 PK 的 `duration` 还未结束之前，其余人都主动调用 `BattleStore` 的 `exitBattle` 结束 PK 后，整个 PK 同样也会提前结束，最后一个 PK 主播也会收到`BattleListener` 的 `onUserExitBattle` 回调。
+在 PK 过程中，参与 PK 的任一主播均可以调用 `BattleStore` 的 `exitBattle` 退出 PK，其他主播依然处于 PK 中不受影响，且会收到 `BattleListener` 的 `onUserExitBattle` 回调，您可以在这个回调中提醒 “有人退出 PK”；如果在 PK 的 `duration` 还未结束之前，其余人都主动调用 `BattleStore` 的 `exitBattle` 结束 PK 后，整个 PK 同样也会提前结束，最后一个 PK 主播也会收到 `BattleListener` 的 `onUserExitBattle` 回调。
 ``` java
 val battleStore:BattleStore = BattleStore.create(liveID)
 battleID = battleStore.battleState.currentBattleInfo.value?.battleID
@@ -327,7 +329,7 @@ AtomicXCore 支持您在房间内直播时，直接发起 PK （中间不经历
 
 #### 步骤 1. 主播发起连线请求
 
-此处的步骤与 《主播发起一场连线》中的步骤 1 和步骤 2 相似。唯一的区别在于：主播发起连线请求时，通过`CoHostStore` 的 `requestConnection` 接口设置 `extensionInfo` 字段来标识当前的连线发起后需要同步发起 PK，用于对端主播 UI 提示信息的区分。
+此处的步骤与 《主播发起一场连线》中的步骤 1 和步骤 2 相似。唯一的区别在于：主播发起连线请求时，通过 `CoHostStore` 的 `requestConnection` 接口设置 `extensionInfo` 字段来标识当前的连线发起后需要同步发起 PK，用于对端主播 UI 提示信息的区分。
 
 例如：
 - 当 `extensionInfo` 设置为 {"withPK:true"} 时，对端主播收到连线请求后 UI 提示 “主播向您发起 PK”。
@@ -431,12 +433,13 @@ override fun onCoHostRequestReceived(inviter: SeatUserInfo, extensionInfo: Strin
 
 > 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 调用流程
 
@@ -454,12 +457,13 @@ override fun onCoHostRequestReceived(inviter: SeatUserInfo, extensionInfo: Strin
 4. **LiveKit 后台 同步客户端**​：LiveKit 后台自动将更新后的 PK 分数同步到所有客户端。
 
 #### 涉及的 REST API 接口
-| 接口 | 功能描述 | 请求示例 |
-| --- | --- | --- |
-| 主动接口 - 查询 PK 状态 | 可根据此接口查询当前房间是否在 PK | 请求示例 |
-| 主动接口 - 修改 PK 分数 | 将计算后的 PK 数值通过此接口更新 | 请求示例 |
-| 回调配置 - PK 开始时回调 | 客户后台可以通过该回调及时知晓 PK 开启 | 回调示例 |
-| 回调配置 - PK 结束时回调 | 客户后台可以通过该回调及时知晓 PK 结束 | 回调示例 |
+
+|接口|功能描述|请求示例|
+|---------|---------|---------|
+|主动接口 - 查询 PK 状态|可根据此接口查询当前房间是否在 PK。|请求示例|
+|主动接口 - 修改 PK 分数|将计算后的 PK 数值通过此接口更新。|请求示例|
+|回调配置 - PK 开始时回调|客户后台可以通过该回调及时知晓 PK 开启。|回调示例|
+|回调配置 - PK 结束时回调|客户后台可以通过该回调及时知晓 PK 结束。|回调示例|
 
 ### 区分 PK 胜负
 
@@ -480,12 +484,13 @@ override fun onCoHostRequestReceived(inviter: SeatUserInfo, extensionInfo: Strin
 ## API 文档
 
 关于 `CoHostStore`、`BattleStore`、`LiveListStore` 和 `LiveSeatStore` 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [**AtomicXCore**](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **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** | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [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) |
-| **LiveListStore** | 直播间全生命周期管理：查询房间列表，修改直播信息等。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-list-store/index.html) |
-| **LiveSeatStore** | 麦位状态管理： 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风、麦位状态等信息。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/index.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**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**|直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。|[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)|
+|**LiveListStore**|直播间全生命周期管理：查询房间列表，修改直播信息等。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-list-store/index.html)|
+|**LiveSeatStore**|麦位状态管理： 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风、麦位状态等信息。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/index.html)|
 
 ## 常见问题
 
@@ -502,13 +507,13 @@ override fun onCoHostRequestReceived(inviter: SeatUserInfo, extensionInfo: Strin
 
 - 检查网络连接是否通畅，邀请信令有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、展示系统，确保主播 / 观众 / 后台分数实时一致，无延迟。

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

@@ -1,14 +1,14 @@
-本文档将帮助开发者使用 `AtomicXCore SDK`的 `LiveListStore` 和 `LiveSeatStore`  快速构建一个包含主播开播和观众进房功能的语聊房 `App`。
+本文档将帮助开发者使用 `AtomicXCore SDK` 的 `LiveListStore` 和 `LiveSeatStore` 快速构建一个包含主播开播和观众进房功能的语聊房 App。
 
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `LiveSeatStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| `LiveSeatStore` | `abstract class` | 麦位管理核心，负责管理房间内的所有麦位信息和麦位相关操作。<br>通过 `liveSeatState.seatList` 暴露实时的麦位列表数据流。 |
-| `LiveSeatState` | `data class` | 代表麦位的当前状态。<br>- `seatList` ：是一个 `StateFlow`，存储了麦位列表的实时状态。<br>- `speakingUsers` ：则代表当前正在说话的人和对应的音量。 |
-| `SeatInfo` | `data class` | 单个麦位的数据模型。` LiveSeatStore` 所推送的麦位列表（`seatList`）就是由多个 `SeatInfo` 对象组成的。<br>关键字段：<br>- `index`：麦位的索引（位置）。<br>- `isLocked `：麦位是否被锁定。<br>- `userInfo`： 麦位上的用户信息。如果麦位为空，此字段也为空对象。 |
-| `SeatUserInfo` | `data class` | 麦上用户的详细数据模型。 当一个用户成功上麦后，`SeatInfo` 中的 `userInfo` 字段就会被填充为此用户。<br>关键字段：<br>- `userID`：  用户的唯一 ID。<br>- `userName`：  用户的昵称。<br>- `avatarURL`：  用户的头像 URL。<br>- `microphoneStatus`： 麦克风状态（开/关）。<br>- `cameraStatus`：  摄像头状态（开/关）。 |
+| <code>LiveSeatStore</code> | <code>abstract class</code> | 麦位管理核心，负责管理房间内的所有麦位信息和麦位相关操作。<br>通过 <code>liveSeatState.seatList</code> 暴露实时的麦位列表数据流。 |
+| <code>LiveSeatState</code> | <code>data class</code> | 代表麦位的当前状态。<br>- <code>seatList</code> ：是一个 <code>StateFlow</code>，存储了麦位列表的实时状态。<br>- <code>speakingUsers</code> ：则代表当前正在说话的人和对应的音量。 |
+| <code>SeatInfo</code> | <code>data class</code> | 单个麦位的数据模型。<code> LiveSeatStore</code> 所推送的麦位列表（<code>seatList</code>）就是由多个 <code>SeatInfo</code> 对象组成的。<br>关键字段：<br>- <code>index</code>：麦位的索引（位置）。<br>- <code>isLocked </code>：麦位是否被锁定。<br>- <code>userInfo</code>： 麦位上的用户信息。如果麦位为空，此字段也为空对象。 |
+| <code>SeatUserInfo</code> | <code>data class</code> | 麦上用户的详细数据模型。 当一个用户成功上麦后，<code>SeatInfo</code> 中的 <code>userInfo</code> 字段就会被填充为此用户。<br>关键字段：<br>- <code>userID</code>：  用户的唯一 ID。<br>- <code>userName</code>：  用户的昵称。<br>- <code>avatarURL</code>：  用户的头像 URL。<br>- <code>microphoneStatus</code>： 麦克风状态（开/关）。<br>- <code>cameraStatus</code>：  摄像头状态（开/关）。 |
 
 ## 准备工作
 
@@ -72,11 +72,11 @@ class MainActivity : AppCompatActivity() {
 ```
 
 **登录接口参数说明：**
-| **参数** | **类型** | **说明** |
+| <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> | 当前用户的唯一 <code>ID</code>，仅包含英文字母、数字、连字符和下划线。为避免多端登录冲突，<strong>请勿使用</strong><code>1</code>、<code>123</code><strong>等简单 ID</strong>。 |
+| <code>userSig</code> | <code>String</code> | 用于腾讯云鉴权的票据。请注意：<br>- 开发环境：您可以采用本地 <code>GenerateTestUserSig.genTestSig</code> 函数生成 <code>userSig</code> 或者 通过 <a href="https://console.cloud.tencent.com/im/tool-usersig">UserSig 辅助工具</a> 生成临时的 <code>UserSig</code>。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 <code>UserSig</code> 的方式。详细信息请参考 <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>。 |
 
 ## 搭建基础语聊房
 
@@ -201,20 +201,20 @@ class YourAnchorActivity : AppCompatActivity() {
 ```
 
 `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>：否）。 |
 
 #### **4. 构建麦位 UI 界面**
 
@@ -469,28 +469,29 @@ class YourAnchorActivity : AppCompatActivity() {
 ## 丰富语聊房场景
 
 当您完成了基础的语聊房功能后，您可以参考以下功能指南来为语聊房添加丰富的互动玩法。
-| **功能** | **功能介绍** | **功能 Stores** | **实现指南** |
-| --- | --- | --- | --- |
-| **实现听众上麦** | 听众申请上麦，与房主进行实时语音互动。 | [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) | 观众上麦 |
-| **实现房主跨房连线 PK** | 两个不同房间的主播进行连线，实现互动或 PK。 | [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)<br>[BattleStore](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) | 主播连线 & PK |
-| **添加弹幕聊天功能** | 房间内成员可以发送和接收实时文字消息。 | [BarrageStore](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) | 实现弹幕功能 |
-| **构建礼物赠送系统** | 观众可以向主播赠送虚拟礼物，增加互动和趣味性。 | [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) | 实现礼物功能 |
+
+|**功能**|**功能介绍**|**功能 Stores**|**实现指南**|
+|---------|---------|---------|---------|
+|**实现听众上麦**|听众申请上麦，与房主进行实时语音互动。|[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)|观众上麦|
+|**实现房主跨房连线 PK**|两个不同房间的主播进行连线，实现互动或 PK。|[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)<br>[BattleStore](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)|主播连线 & PK|
+|**添加弹幕聊天功能**|房间内成员可以发送和接收实时文字消息。|[BarrageStore](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)|实现弹幕功能|
+|**构建礼物赠送系统**|观众可以向主播赠送虚拟礼物，增加互动和趣味性。|[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)|实现礼物功能|
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API 文档** |
+| <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API 文档</strong> |
 | --- | --- | --- |
-| **LiveListStore** | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-list-store/index.html) |
-| **LiveSeatStore** | 麦位管理核心：管理麦位列表、麦上用户状态、麦位相关操作（上麦、下麦、踢人、锁麦、开关麦克风/摄像头等），监听麦位事件。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/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) |
-| **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) |
-| **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) |
-| **LikeStore** | 点赞互动：发送点赞，监听点赞事件，同步总点赞数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-like-store/index.html) |
-| **LiveAudienceStore** | 观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-audience-store/index.html) |
-| **AudioEffectStore** | 音频特效：变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-effect-store/index.html) |
-| **BaseBeautyStore** | 基础美颜：调节磨皮 / 美白 / 红润（0-100 级），重置美颜状态，同步效果参数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-base-beauty-store/index.html) |
+| <strong>LiveListStore</strong> | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-list-store/index.html">API 文档</a> |
+| <strong>LiveSeatStore</strong> | 麦位管理核心：管理麦位列表、麦上用户状态、麦位相关操作（上麦、下麦、踢人、锁麦、开关麦克风/摄像头等），监听麦位事件。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/index.html">API 文档</a> |
+| <strong>DeviceStore</strong> | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | <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> |
+| <strong>CoGuestStore</strong> | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | <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> |
+| <strong>CoHostStore</strong> | 主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。 | <a href="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">API 文档</a> |
+| <strong>BattleStore</strong> | 主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。 | <a href="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">API 文档</a> |
+| <strong>GiftStore</strong> | 礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。 | <a href="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">API 文档</a> |
+| <strong>BarrageStore</strong> | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | <a href="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">API 文档</a> |
+| <strong>LikeStore</strong> | 点赞互动：发送点赞，监听点赞事件，同步总点赞数。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-like-store/index.html">API 文档</a> |
+| <strong>LiveAudienceStore</strong> | 观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-audience-store/index.html">API 文档</a> |
+| <strong>AudioEffectStore</strong> | 音频特效：变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-effect-store/index.html">API 文档</a> |
+| <strong>BaseBeautyStore</strong> | 基础美颜：调节磨皮 / 美白 / 红润（0-100 级），重置美颜状态，同步效果参数。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-base-beauty-store/index.html">API 文档</a> |
 
 ## 常见问题