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

package/resource/{doc → knowledge}/livekit/core-sdk/voice/ios/voice-gift.md

@@ -1,7 +1,8 @@
 `GiftStore` 是 `AtomicXCore` 中专门负责管理直播间礼物功能的模块。通过它，您可以为您的直播应用构建一套完整的礼物系统，实现丰富的营收和互动场景。
-| 礼物面板 | 弹幕礼物 | 全屏礼物 |
-| --- | --- | --- |
-|  |  |  |
+
+|礼物面板|弹幕礼物|全屏礼物|
+|---------|---------|---------|
+||||
 
 ## 核心功能
 - **礼物列表获取**：从服务端拉取礼物面板所需的数据，包括礼物分类和礼物详情。
@@ -13,13 +14,14 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `GiftStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| `Gift` | `struct` | 代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。 |
-| `GiftCategory` | `struct` | 代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift **列表。 |
-| `GiftState` | `struct` | 代表礼物模块的当前状态。其核心属性 usableGifts 是一个 [GiftCategory] 数组，存储了从服务端拉取到的完整礼物列表。 |
-| `GiftEvent` | `enum` | 代表直播间内发生的礼物事件。目前只有 .onReceiveGift，当有任何人（包括自己）调用发送礼物接口时，房间内所有人都会收到此事件。 |
-| `GiftStore` | `class` | 这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、调用发送礼物接口，并通过订阅其 giftEventPublisher 来接收礼物事件。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|`Gift`|`struct`|代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。|
+|`GiftCategory`|`struct`|代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift **列表。|
+|`GiftState`|`struct`|代表礼物模块的当前状态。其核心属性 usableGifts 是一个 [GiftCategory] 数组，存储了从服务端拉取到的完整礼物列表。|
+|`GiftEvent`|`enum`|代表直播间内发生的礼物事件。目前只有 .onReceiveGift，当有任何人（包括自己）调用发送礼物接口时，房间内所有人都会收到此事件。|
+|`GiftStore`|`class`|这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、调用发送礼物接口，并通过订阅其 giftEventPublisher 来接收礼物事件。|
 
 ## 实现步骤
 
@@ -96,26 +98,26 @@ class GiftManager {
 #### 礼物列表结构体参数
 - `GiftCategory`**参数说明**
 
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `categoryID` | `String` | 礼物分类的唯一 ID。 |
-| `name` | `String` | 礼物分类的显示名称。 |
-| `desc` | `String` | 礼物分类的描述信息。 |
-| `extensionInfo` | `[String: String]` | 扩展信息字段。 |
-| `giftList` | `[`[`Gift`](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/gift)`]` | 该分类下包含的 Gift 礼物对象数组。 |
+   |**参数**|**类型**|**描述**|
+   |---------|---------|---------|
+   |`categoryID`|`String`|礼物分类的唯一 ID。|
+   |`name`|`String`|礼物分类的显示名称。|
+   |`desc`|`String`|礼物分类的描述信息。|
+   |`extensionInfo`|`[String: String]`|扩展信息字段。|
+   |`giftList`|`[`[`Gift`](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/gift)`]`|该分类下包含的 Gift 礼物对象数组。|
 
 - `Gift`** 参数说明**
 
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `giftID` | `String` | 礼物的唯一 ID。 |
-| `name` | `String` | 礼物的显示名称。 |
-| `desc` | `String` | 礼物的描述信息。 |
-| `iconURL` | `String` | 礼物图标 URL。 |
-| `resourceURL` | `String` | 礼物动画资源 URL。 |
-| `level` | `UInt` | 礼物等级。 |
-| `coins` | `UInt` | 礼物价格。 |
-| `extensionInfo` | `[String: String]` | 扩展信息字段。 |
+   |**参数**|**类型**|**描述**|
+   |---------|---------|---------|
+   |`giftID`|`String`|  礼物的唯一 ID。|
+   |`name`|`String`|  礼物的显示名称。|
+   |`desc`|`String`|  礼物的描述信息。|
+   |`iconURL`|`String`|  礼物图标 URL。|
+   |`resourceURL`|`String`|  礼物动画资源 URL。|
+   |`level`|`UInt`|  礼物等级。|
+   |`coins`|`UInt`|  礼物价格。|
+   |`extensionInfo`|`[String: String]`|  扩展信息字段。|
 
 ### 步骤3：获取礼物列表
 
@@ -177,11 +179,12 @@ extension GiftManager {
 ```
 
 #### `sendGift`接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `giftID` | `String` | 要发送的礼物的唯一 ID。 |
-| `count` | `UInt` | 发送的数量。 |
-| `completion` | `CompletionClosure?` | 发送完成后的回调。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`giftID`|`String`|要发送的礼物的唯一 ID。|
+|`count`|`UInt`|发送的数量。|
+|`completion`|`CompletionClosure?`|发送完成后的回调。|
 
 ## 功能进阶
 
@@ -235,9 +238,10 @@ extension GiftManager {
 #### 调用流程图
 
 #### 涉及 REST API 接口一览
-| 接口 | 说明 | 请求示例 |
-| --- | --- | --- |
-| 回调配置 - 调用发送礼物接口之前回调 | 客户后台可以通过该回调决定是否通过送礼前校验等场景 | 调用示例 |
+
+|接口|说明|请求示例|
+|---------|---------|---------|
+|回调配置 - 调用发送礼物接口之前回调|客户后台可以通过该回调决定是否通过送礼前校验等场景|调用示例|
 
 ### 实现全屏礼物动画播放
 
@@ -246,13 +250,14 @@ extension GiftManager {
 #### 实现方式
 
 `AtomicXCore` 本身不包含礼物动画播放器，您需要根据业务需求选择并集成第三方库。以下是两种方案的对比：
-| **对比项** | **基础方案 (SVGAPlayer-iOS)** | **高级方案 (TCEffectPlayerKit)** |
-| --- | --- | --- |
-| 计费 | 免费 (开源库) | 付费 (需购买 License)，请参见 [付费指引](https://cloud.tencent.com/document/product/616/116461) |
-| 集成方式 | 需手动集成 SVGAPlayer 库 (例如通过 CocoaPods) | 需额外集成 TCEffectPlayerKit 并进行鉴权 |
-| 动画格式支持 | 仅支持 SVGA | SVGA、PAG、WebP、Lottie、MP4 等多种格式 |
-| 性能 | 建议 SVGA 文件 ≤ 10MB | 支持更大的动画文件，复杂特效/多动画并发/低端机表现更优 |
-| 推荐场景 | 礼物动画格式统一为 SVGA，且文件大小可控 | 需要支持多种动画格式，或对动画性能/设备兼容性有更高要求 |
+
+|**对比项**|**基础方案 (SVGAPlayer-iOS)**|**高级方案 (TCEffectPlayerKit)**|
+|---------|---------|---------|
+|计费|免费 (开源库)|付费 (需购买 License)，请参见 [付费指引](https://cloud.tencent.com/document/product/616/116461)|
+|集成方式|需手动集成 SVGAPlayer 库 (例如通过 CocoaPods)|需额外集成 TCEffectPlayerKit 并进行鉴权|
+|动画格式支持|仅支持 SVGA|SVGA、PAG、WebP、Lottie、MP4 等多种格式|
+|性能|建议 SVGA 文件 ≤ 10MB|支持更大的动画文件，复杂特效/多动画并发/低端机表现更优|
+|推荐场景|礼物动画格式统一为 SVGA，且文件大小可控|需要支持多种动画格式，或对动画性能/设备兼容性有更高要求|
 
 本章节主要演示基础方案的集成。如果您选择高级方案，请参考 [TCEffectPlayer 集成指引](https://cloud.tencent.com/document/product/616/116474)。
 
@@ -372,10 +377,11 @@ private func setupGiftToBarrageFlow() {
 ## API 文档
 
 关于 [GiftStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| Store/Component | 功能描述 | API 文档 |
-| --- | --- | --- |
-| GiftStore | 礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore) |
-| BarrageStore | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) |
+
+|Store/Component|功能描述|API 文档|
+|---------|---------|---------|
+|GiftStore|礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore)|
+|BarrageStore|弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)|
 
 ## 常见问题
 

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

@@ -1,18 +1,19 @@
 `AtomicXCore` 提供了 `CoHostStore` 和 `BattleStore` 两个模块，分别用于处理**跨房连线**和 **PK 对战**。本文将指导您如何组合使用这两个工具，完成语聊房场景下的连线和 PK 功能的开发。
 
 ## 核心概念
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| **CoHostStore** | class | 管理主播间的连线生命周期，提供连线功能 API（requestHostConnection、acceptHostConnection）。 |
-| **BattleStore** | class | 管理跨房 PK 对战的信令与数据，包括 PK 状态。 |
-| **LiveListStore** | class | 提供直播房间列表的拉取功能 (`fetchLiveList`)，用于获取可连线的其他房间信息。 |
-| **LiveSeatStore** | class | 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风等状态。 |
-| **CoHostLayoutTemplate** | enum | 连线时，用于指定房间麦位布局模板，例如`.hostStaticVoice6v6`。 |
-| **BattleConfig** | struct | 配置 PK 的详细信息，例如 PK 时长 (`duration`) 和是否需要二次响应 (`needResponse`)。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|**CoHostStore**|class|管理主播间的连线生命周期，提供连线功能 API（requestHostConnection、acceptHostConnection）。|
+|**BattleStore**|class|管理跨房 PK 对战的信令与数据，包括 PK 状态。|
+|**LiveListStore**|class|提供直播房间列表的拉取功能 (`fetchLiveList`)，用于获取可连线的其他房间信息。|
+|**LiveSeatStore**|class|管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风等状态。|
+|**CoHostLayoutTemplate**|enum|连线时，用于指定房间麦位布局模板，例如`.hostStaticVoice6v6`。|
+|**BattleConfig**|struct|配置 PK 的详细信息，例如 PK 时长 (`duration`) 和是否需要二次响应 (`needResponse`)。|
 
 ## 前提条件
 
-请参考 快速接入 集成 **AtomicXCore SDK**，并完成 **主播开播** 和 **观众观看** 的功能实现。
+请参考 开播与收听 集成 **AtomicXCore SDK**，并完成 **主播开播** 和 **观众观看** 的功能实现。
 
 ## 主播发起一场连线
 
@@ -25,8 +26,8 @@
 > **注意：**
 >
 > - 如果接口返回的列表中没有找到您想要的直播间，您需要检查开播时设置的 `TUILiveInfo` 的 `isPublicVisible` 字段是否为 `true`；
-> - 该接口支持分页继续拉取，您可以使用`result`为 `success` 时的`cursor`作为下一次续拉的游标，如果返回的 `cursor` 为空，则表示直播间列表已全部拉取完；
-> - 为了性能考虑，建议您将count设置为 20。
+> - 该接口支持分页继续拉取，您可以使用 `result` 为 `success` 时的 `cursor` 作为下一次续拉的游标，如果返回的 `cursor` 为空，则表示直播间列表已全部拉取完；
+> - 为了性能考虑，建议您将 count 设置为 20。
 
 ``` swift
 import AtomicXCore
@@ -57,8 +58,8 @@ func fetchLiveListForCoHost() {
 > **说明：**
 >
 > - AtomicXCore最大支持 **9** 个房间互相连线，每个房间支持 **50 **路用户。
-> - 该接口支持批量发起邀请，您可以按需使用；单个直播间是否邀请成功，您需要在 `completion` 回调中检查`Result`是否为`.success`。
-> - 该接口支持扩展字段，邀请发送成功后，该字段会随着 `CoHostEventPublisher ` 的 `onCoHostRequestReceived` 回调通知给对端主播，您可以在这个字段中携带 “**是否立即开始 PK 对战**” 等信息，来实现自己的特殊业务。
+> - 该接口支持批量发起邀请，您可以按需使用；单个直播间是否邀请成功，您需要在 `completion` 回调中检查 `Result` 是否为`.success`。
+> - 该接口支持扩展字段，邀请发送成功后，该字段会随着 `CoHostEventPublisher` 的 `onCoHostRequestReceived` 回调通知给对端主播，您可以在这个字段中携带 “**是否立即开始 PK 对战**” 等信息，来实现自己的特殊业务。
 
 ``` swift
 import AtomicXCore
@@ -197,7 +198,7 @@ liveSeatStore.state.subscribe(StatePublisherSelector(keyPath: \LiveSeatState.sea
 
 ### 步骤6：连线过程中继续邀请其他主播参与连线
 
-AtomicXCore 支持您在已经连线的过程中，还可以继续邀请其他主播参与连线，您可以继续调用`requestHostConnection`邀请新的主播参与连线。
+AtomicXCore 支持您在已经连线的过程中，还可以继续邀请其他主播参与连线，您可以继续调用 `requestHostConnection` 邀请新的主播参与连线。
 ``` swift
 import AtomicXCore
 
@@ -246,10 +247,11 @@ func onExitButtonClicked() {
 ## 主播发起 PK
 
 主播发起 PK 支持两种主要业务流程，以满足不同直播互动需求。核心区别在于 PK 发起前房间的状态。
-| **PK 模式** | **房间状态（PK 前）** | **房间状态（PK 后）** |
-| --- | --- | --- |
-| **场景一：主播在连线后再发起 PK** | 双方**已连线** | 恢复连线状态 |
-| **场景二：主播发起带 PK 模式的连线** | 双方**未连线** | 恢复连线状态 |
+
+|**PK 模式**|**房间状态（PK 前）**|**房间状态（PK 后）**|
+|---------|---------|---------|
+|**场景一：主播在连线后再发起 PK**|双方**已连线**|恢复连线状态|
+|**场景二：主播发起带 PK 模式的连线**|双方**未连线**|恢复连线状态|
 
 ### 场景一：主播在连线后再发起 PK
 
@@ -258,7 +260,7 @@ AtomicXCore 支持您在这些主播中发起限时的对战 PK。交互如下
 
 2. 参与连线的主播，点击 PK 按钮发起一场限时的对战，可以通过主播收到的礼物数来判定对战的胜负。
 
-3. 对端主播可以弹框提醒，并提示是否加入PK，当被邀请的主播同意后对战即刻开始。
+3. 对端主播可以弹框提醒，并提示是否加入 PK，当被邀请的主播同意后对战即刻开始。
 
 4. PK 开始后，UI 进入对战状态，显示 PK 进度条；该进度条可以是主播收到的礼物数，也可以是收到的点赞数等业务数据。
 
@@ -275,7 +277,7 @@ AtomicXCore 支持您在这些主播中发起限时的对战 PK。交互如下
 > - 当您不设置 `BattleConfig` 的 `duration` 字段时， PK 默认时长为 5 分钟。
 > - 当您不需要对端主播同意时，您可以设置 `BattleConfig` 的 `needResponse` 字段为 `false`，当邀请发出后 PK 会立即开始。
 > - 当 `BattleConfig` 的 `needResponse` 字段为 `false` 时，`requestBattle` 接口的 `timeout` 字段必须设置为 0。
-> - 当设置了超时时间后，如果对端主播在 timeout 时间内还未同意，当次的 PK 邀请会超时，主播和对端主播都会收到 `BattleEventPublisher ` 的 `onBattleRequestTimeout` 回调；参与连线的所有主播依然可以继续发起下一场 PK。
+> - 当设置了超时时间后，如果对端主播在 timeout 时间内还未同意，当次的 PK 邀请会超时，主播和对端主播都会收到 `BattleEventPublisher` 的 `onBattleRequestTimeout` 回调；参与连线的所有主播依然可以继续发起下一场 PK。
 
 ``` swift
 var battleStore: BattleStore {
@@ -325,9 +327,9 @@ battleStore.battleEventPublisher
 
 - 当 `needResponse` 设置为 `true`，则当被邀请的所有对端主播都调用 `BattleStore` 的 `acceptBattle` 接口同意后进入 PK 状态。
 
-- 当 `needResponse` 设置为 `true`，若对端主播同意 PK，则已加入 PK 的主播会收到 `BattleEventPublisher ` 的 `onUserJoinBattle` 回调。
+- 当 `needResponse` 设置为 `true`，若对端主播同意 PK，则已加入 PK 的主播会收到 `BattleEventPublisher` 的 `onUserJoinBattle` 回调。
 
-- 进入 PK 状态之后，参与 PK 的所有主播均会收到 `BattleEventPublisher ` 的 `onBattleStarted` 回调。
+- 进入 PK 状态之后，参与 PK 的所有主播均会收到 `BattleEventPublisher` 的 `onBattleStarted` 回调。
 
 #### 步骤 4. 结束 PK 状态
 
@@ -339,7 +341,7 @@ battleStore.battleEventPublisher
 
 ##### 2. 主动调用 exitBattle 结束 PK
 
-在 PK 过程中，参与 PK 的任一主播均可以调用 `BattleStore` 的 `exitBattle` 退出 PK，其他主播依然处于 PK 中不受影响，且会收到 `BattleEventPublisher` 的 `onUserExitBattle` 回调，您可以在这个回调中提醒 “有人退出 PK”；如果在 PK 的 `duration` 还未结束之前，其余人都主动调用 `BattleStore` 的 `exitBattle` 结束 PK 后，整个 PK 同样也会提前结束，最后一个 PK 主播也会收到  `BattleEventPublisher ` 的 `onUserExitBattle` 回调。
+在 PK 过程中，参与 PK 的任一主播均可以调用 `BattleStore` 的 `exitBattle` 退出 PK，其他主播依然处于 PK 中不受影响，且会收到 `BattleEventPublisher` 的 `onUserExitBattle` 回调，您可以在这个回调中提醒 “有人退出 PK”；如果在 PK 的 `duration` 还未结束之前，其余人都主动调用 `BattleStore` 的 `exitBattle` 结束 PK 后，整个 PK 同样也会提前结束，最后一个 PK 主播也会收到 `BattleEventPublisher` 的 `onUserExitBattle` 回调。
 ``` swift
 var battleStore: BattleStore {
         return BattleStore.create(liveID: liveID)
@@ -384,12 +386,12 @@ AtomicXCore 支持您在房间内直播时，直接发起 PK （中间不经历
 
 #### 步骤 1. 主播发起连线请求
 
-此处的步骤与 《主播发起一场连线》中的步骤 1 和步骤 2 相似。唯一的区别在于：主播发起连线请求时，通过`CoHostStore` 的 `requestHostConnection` 接口设置`extraInfo`字段来标识当前的连线发起后需要同步发起 PK，用于对端主播 UI 提示信息的区分。
+此处的步骤与 《主播发起一场连线》中的步骤 1 和步骤 2 相似。唯一的区别在于：主播发起连线请求时，通过 `CoHostStore` 的 `requestHostConnection` 接口设置 `extraInfo` 字段来标识当前的连线发起后需要同步发起 PK，用于对端主播 UI 提示信息的区分。
 
 例如：
-- 当 `extraInfo`设置为 `{"withPK:true"}` 时，对端主播收到连线请求后 UI 提示 “主播向您发起 PK”。
+- 当 `extraInfo` 设置为 `{"withPK:true"}` 时，对端主播收到连线请求后 UI 提示 “主播向您发起 PK”。
 
-- 当 `extraInfo`设置为 `{"withPK:false"}` 时，对端主播收到连线请求后 UI 提示 “主播邀请您参与跨房连线”。
+- 当 `extraInfo` 设置为 `{"withPK:false"}` 时，对端主播收到连线请求后 UI 提示 “主播邀请您参与跨房连线”。
 
    ``` swift
    import AtomicXCore
@@ -527,12 +529,13 @@ coHostStore.coHostEventPublisher
 
 > 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分<br>|
 
 #### REST API 调用流程
 
@@ -543,19 +546,20 @@ coHostStore.coHostEventPublisher
 
   - 主动查询​：您的后台服务可主动调用 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 结束。|回调示例|
 
 ### 区分 PK 胜负
 
@@ -575,12 +579,13 @@ battleStore.state.subscribe(StatePublisherSelector(keyPath: \BattleState.battleS
 ## 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_iOS/documentation/atomicxcore/cohoststore) |
-| **BattleStore** | 主播 PK 对战生命周期管理： 负责管理主播间的限时 PK 对战全生命周期，包括发起 PK 邀请、开始对战、实时更新 PK 分数、PK 结束结算胜负以及惩罚时间等流程。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore) |
-| **LiveListStore** | 直播间全生命周期管理：查询房间列表，修改直播信息等。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore) |
-| **LiveSeatStore** | 麦位状态管理： 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风、麦位状态等信息。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**CoHostStore**|主播连线生命周期管理： 负责管理和协调主播间连线的生命周期，包括发起连线邀请、处理接受/拒绝、连线状态切换、连线中的视频流管理以及断开连线等任务。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore)|
+|**BattleStore**|主播 PK 对战生命周期管理： 负责管理主播间的限时 PK 对战全生命周期，包括发起 PK 邀请、开始对战、实时更新 PK 分数、PK 结束结算胜负以及惩罚时间等流程。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore)|
+|**LiveListStore**|直播间全生命周期管理：查询房间列表，修改直播信息等。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore)|
+|**LiveSeatStore**|麦位状态管理： 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风、麦位状态等信息。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore)|
 
 ## 常见问题
 
@@ -597,13 +602,13 @@ battleStore.state.subscribe(StatePublisherSelector(keyPath: \BattleState.battleS
 
 - 检查网络连接是否通畅，邀请信令有 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/ios/voice-integration.md

@@ -3,12 +3,12 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `LiveSeatStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| `LiveSeatStore` | `class` | 麦位管理核心，负责管理房间内的所有麦位信息和麦位相关操作。<br>通过 `liveSeatState.seatList` 暴露实时的麦位列表数据流。 |
-| `LiveSeatState` | `struct` | 代表麦位的当前状态。<br>- `seatList` ：是一个`[seatInfo]`类型数组，存储了麦位列表的实时状态。<br>- `speakingUsers` ：则代表当前正在说话的人和对应的音量。 |
-| `SeatInfo` | `struct` | 单个麦位的数据模型。` LiveSeatStore` 所推送的麦位列表（`seatList`）就是由多个 `SeatInfo` 对象组成的。<br>关键字段：<br>- `index`：麦位的索引（位置）。<br>- `isLocked `：麦位是否被锁定。<br>- `userInfo`： 麦位上的用户信息。如果麦位为空，此字段也为空对象。 |
-| `SeatUserInfo` | `struct` | 麦上用户的详细数据模型。 当一个用户成功上麦后，`SeatInfo` 中的 `userInfo` 字段就会被填充为此用户。<br>关键字段：<br>- `userID`：  用户的唯一 ID。<br>- `userName`：  用户的昵称。<br>- `avatarURL`：  用户的头像 URL。<br>- `microphoneStatus`： 麦克风状态（开/关）。<br>- `cameraStatus`：  摄像头状态（开/关）。 |
+| <code>LiveSeatStore</code> | <code>class</code> | 麦位管理核心，负责管理房间内的所有麦位信息和麦位相关操作。<br>通过 <code>liveSeatState.seatList</code> 暴露实时的麦位列表数据流。 |
+| <code>LiveSeatState</code> | <code>struct</code> | 代表麦位的当前状态。<br>- <code>seatList</code> ：是一个<code>[seatInfo]</code>类型数组，存储了麦位列表的实时状态。<br>- <code>speakingUsers</code> ：则代表当前正在说话的人和对应的音量。 |
+| <code>SeatInfo</code> | <code>struct</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>struct</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>：  摄像头状态（开/关）。 |
 
 ## 准备工作
 
@@ -17,7 +17,7 @@
 请参见 开通服务，获取体验版或付费版 `SDK`。
 
 ### 步骤2：在当前项目中导入 AtomicXCore
-1. **安装组件**：请在您的 **Podfile** 文件中添加 `pod 'AtomicXCore'` 依赖，然后执行`pod install`。
+1. **安装组件**：请在您的 **Podfile** 文件中添加 `pod 'AtomicXCore'` 依赖，然后执行 `pod install`。
 
    ``` ruby
    # Podfile
@@ -62,11 +62,11 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
 ```
 
 **登录接口参数说明：**
-| **参数** | **类型** | **说明** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>说明</strong> |
 | --- | --- | --- |
-| sdkAppId | Int32 | 从 [控制台](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 | Int32 | 从 <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>。 |
 
 ## 搭建基础语聊房
 
@@ -186,27 +186,27 @@ class YourAnchorViewController: UIViewController {
 ```
 
 `LiveInfo`**参数说明**
-| **参数名** | **类型** | **属性** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>属性</strong> | <strong>描述</strong> |
 | --- | --- | --- | --- |
-| `liveID` | `String` | 必填 | 直播间的唯一标识符。 |
-| `liveName` | `String` | 选填 | 直播间的标题。 |
-| `notice` | `String` | 选填 | 直播间的公告信息。 |
-| `isMessageDisable` | `Bool` | 选填 | 是否禁言（`true`：是，`false`：否）。 |
-| `isPublicVisible` | `Bool` | 选填 | 是否公开可见（`true`：是，`false`：否）。 |
-| `seatMode` | `TakeSeatMode` | 选填 | 上麦模式（`.free`：自由上麦，`.apply`：申请上麦）。 |
-| `seatTemplate` | `SeatLayoutTemplate` | 必填 | 麦位布局模板。 |
-| `coverURL` | `String` | 选填 | 直播间的封面图片地址。 |
-| `backgroundURL` | `String` | 选填 | 直播间的背景图片地址。 |
-| `categoryList` | `[NSNumber]` | 选填 | 直播间的分类标签列表。 |
-| `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>Bool</code> | 选填 | 是否禁言（<code>true</code>：是，<code>false</code>：否）。 |
+| <code>isPublicVisible</code> | <code>Bool</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>[NSNumber]</code> | 选填 | 直播间的分类标签列表。 |
+| <code>activityStatus</code> | <code>Int</code> | 选填 | 直播活动状态。 |
+| <code>isGiftEnabled</code> | <code>Boolean</code> | 选填 | 是否启用礼物功能（<code>true</code>：是，<code>false</code>：否）。 |
 
 #### **4. 构建麦位 UI 界面**
 
 > **提示：**
 >
 
-> 麦位 `UI` 效果的业务代码，您也可以参考 `TUILiveKit` 开源项目中的 [SeatGridView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/SeatGridview/SeatGridView.swift) 文件来了解完整的实现逻辑。
+> 麦位 `UI` 效果的业务代码，您也可以参考 `TUILiveKit` 开源项目中的 [SeatGridView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Component/SeatGridview/SeatGridView.swift) 文件来了解完整的实现逻辑。
 >
 
 通过 `LiveSeatStore` 实例，监听 `state.seatList` 的变化，以实时获取麦位数据来渲染您的 UI。您可以在 `ViewController` 中（例如 `YourAnchorViewController` 或 `YourAudienceViewController`）通过以下方式监听数据：
@@ -398,7 +398,7 @@ class YourAudienceViewController: UIViewController {
 > **提示：**
 >
 
-> 麦上用户说话时展示波浪动画效果，您也可以参考 `TUILiveKit` 开源项目中的 [SeatGridView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/SeatGridview/SeatGridView.swift) 文件来了解完整的实现逻辑。
+> 麦上用户说话时展示波浪动画效果，您也可以参考 `TUILiveKit` 开源项目中的 [SeatGridView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Component/SeatGridview/SeatGridView.swift) 文件来了解完整的实现逻辑。
 >
 
 在 `YourAnchorViewController` 或 `YourAudienceViewController` 中监听 `speakingUsers` 变化，并更新“正在说话”状态，代码示例如下：
@@ -438,28 +438,30 @@ class YourAnchorViewController: UIViewController {
 ## 丰富语聊房场景
 
 当您完成了基础的语聊房功能后，您可以参考以下功能指南来为语聊房添加丰富的互动玩法。
-| **功能** | **功能介绍** | **功能 Stores** | **实现指南** |
-| --- | --- | --- | --- |
-| **实现听众上麦** | 听众申请上麦，与房主进行实时语音互动。 | [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) | 观众上麦 |
-| **实现房主跨房连线 PK** | 两个不同房间的主播进行连线，实现互动或 PK。 | [CoHostStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore)<br>[BattleStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore) | 主播连线和 PK |
-| **添加弹幕聊天功能** | 房间内成员可以发送和接收实时文字消息。 | [BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) | 实现弹幕功能 |
-| **构建礼物赠送系统** | 观众可以向主播赠送虚拟礼物，增加互动和趣味性。 | [GiftStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore) | 实现礼物功能 |
+
+|**功能**|**功能介绍**|**功能 Stores**|**实现指南**|
+|---------|---------|---------|---------|
+|**实现听众上麦**|听众申请上麦，与房主进行实时语音互动。|[CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore)|观众上麦|
+|**实现房主跨房连线 PK**|两个不同房间的主播进行连线，实现互动或 PK。|[CoHostStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore)<br>[BattleStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore)|主播连线和 PK|
+|**添加弹幕聊天功能**|房间内成员可以发送和接收实时文字消息。|[BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)|实现弹幕功能|
+|**构建礼物赠送系统**|观众可以向主播赠送虚拟礼物，增加互动和趣味性。|[GiftStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore)|实现礼物功能|
 
 ## API 文档
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **LiveListStore** | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore) |
-| **LiveSeatStore** | 麦位管理核心：管理麦位列表、麦上用户状态、麦位相关操作（上麦、下麦、踢人、锁麦、开关麦克风/摄像头等），监听麦位事件。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore) |
-| **DeviceStore** | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore/) |
-| **CoGuestStore** | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore/) |
-| **CoHostStore** | 主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore/) |
-| **BattleStore** | 主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore) |
-| **GiftStore** | 礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore/) |
-| **BarrageStore** | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) |
-| **LikeStore** | 点赞互动：发送点赞，监听点赞事件，同步总点赞数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/likestore) |
-| **LiveAudienceStore** | 观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore) |
-| **AudioEffectStore** | 音频特效：变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore) |
-| **BaseBeautyStore** | 基础美颜：调节磨皮 / 美白 / 红润（0-100 级），重置美颜状态，同步效果参数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**LiveListStore**|直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore)|
+|**LiveSeatStore**|麦位管理核心：管理麦位列表、麦上用户状态、麦位相关操作（上麦、下麦、踢人、锁麦、开关麦克风/摄像头等），监听麦位事件。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore)|
+|**DeviceStore**|音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore/)|
+|**CoGuestStore**|观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore/)|
+|**CoHostStore**|主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore/)|
+|**BattleStore**|主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore)|
+|**GiftStore**|礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore/)|
+|**BarrageStore**|弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)|
+|**LikeStore**|点赞互动：发送点赞，监听点赞事件，同步总点赞数。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/likestore)|
+|**LiveAudienceStore**|观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore)|
+|**AudioEffectStore**|音频特效：变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore)|
+|**BaseBeautyStore**|基础美颜：调节磨皮 / 美白 / 红润（0-100 级），重置美颜状态，同步效果参数。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore)|
 
 ## 常见问题