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

package/resource/{doc → knowledge}/livekit/core-sdk/live/ios/live-barrage.md

@@ -14,17 +14,19 @@
 ## 核心概念解析
 
 在开始集成之前，我们先通过下表了解一下 BarrageStore 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| [Barrage](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barrage) | `struct` | 代表一条弹幕消息的数据模型。它包含了发送者信息 (`sender`)、消息内容 (`textContent` 或 `data`)、消息类型 (`messageType`) 等所有关键信息。 |
-| [BarrageState](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestate) | `struct` | 代表弹幕模块的当前状态。其核心属性 `messageList` 是一个 `[Barrage]` 数组，按时间顺序存储了当前直播间的所有弹幕消息，是UI渲染的数据源。 |
-| [BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) | `class` | 这是与弹幕功能交互的核心管理类。通过它，您可以发送消息 (`sendTextMessage`, `sendCustomMessage`)，并通过订阅其 `state` 属性来接收和监听所有弹幕消息的更新。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|[Barrage](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barrage)|`struct`|代表一条弹幕消息的数据模型。它包含了发送者信息 (`sender`)、消息内容 (`textContent` 或 `data`)、消息类型 (`messageType`) 等所有关键信息。|
+|[BarrageState](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestate)|`struct`|代表弹幕模块的当前状态。其核心属性 `messageList` 是一个 `[Barrage]` 数组，按时间顺序存储了当前直播间的所有弹幕消息，是 UI 渲染的数据源。|
+|[BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)|`class`|这是与弹幕功能交互的核心管理类。通过它，您可以发送消息 (`sendTextMessage`, `sendCustomMessage`)，并通过订阅其 `state` 属性来接收和监听所有弹幕消息的更新。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 开始直播 集成 **AtomicXCore**，完成接入。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：初始化并监听弹幕
 
@@ -95,11 +97,12 @@ extension BarrageManager {
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `text` | `String` | 要发送的文本内容。 |
-| `extensionInfo` | `[String: String]?` | 附加的扩展信息，可用于业务自定义。 |
-| `completion` | `CompletionClosure?` | 发送完成后的回调，包含成功或失败的结果。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`text`|`String`|要发送的文本内容。|
+|`extensionInfo`|`[String: String]?`|附加的扩展信息，可用于业务自定义。|
+|`completion`|`CompletionClosure?`|发送完成后的回调，包含成功或失败的结果。|
 
 ### 步骤4：发送自定义弹幕
 
@@ -134,11 +137,12 @@ extension BarrageManager {
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `businessId` | `String` | 业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。 |
-| `data` | `String` | 业务数据，通常为 JSON 格式的字符串。 |
-| `completion` | `CompletionClosure?` | 发送完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`businessId`|`String`|业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。|
+|`data`|`String`|业务数据，通常为 JSON 格式的字符串。|
+|`completion`|`CompletionClosure?`|发送完成后的回调。|
 
 ### 步骤5：在本地插入提示消息
 
@@ -161,9 +165,10 @@ extension BarrageManager {
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `message` | `Barrage` | 要在本地插入的消息对象。SDK 会将此消息对象追加到 BarrageState 的 messageList 中。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`message`|`Barrage`|要在本地插入的消息对象。SDK 会将此消息对象追加到 BarrageState 的 messageList 中。|
 
 ### 步骤6：管理用户发言（禁言与解禁）
 
@@ -230,7 +235,7 @@ liveListStore.updateLiveInfo(currentLiveInfo, modifyFlag: .isMessageDisable) { r
 
 #### 技术挑战
 
-SDK 会以极高频率返回完整的弹幕列表。如果每次都调用 `tableView.reloadData()`，主线程会被密集的UI布局和渲染操作阻塞，导致界面卡顿。
+SDK 会以极高频率返回完整的弹幕列表。如果每次都调用 `tableView.reloadData()`，主线程会被密集的 UI 布局和渲染操作阻塞，导致界面卡顿。
 
 #### 优化方案：批处理与流量削峰 (Batch Processing & Debouncing)
 
@@ -284,7 +289,7 @@ class BarrageUIManager {
 
 #### 技术挑战
 
-SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 UI 层做了节流，数据层持有的这个巨大数组也会持续侵占内存，最终导致应用闪退。
+SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 UI 层做了节流，数据层持有的这个巨大数组也会持续占用内存，最终导致应用闪退。
 
 #### 优化方案：固定容量的循环数组 (Circular Buffer)
 
@@ -331,7 +336,7 @@ class BarrageUIManager {
 ``` swift
 import UIKit
 
-// 在你的自定义弹幕Cell中
+// 在您的自定义弹幕Cell中
 class BarrageCell: UITableViewCell {
 
     // ... (UILabel, UIImageView等子视图的声明)
@@ -349,7 +354,7 @@ class BarrageCell: UITableViewCell {
     }
 
     func configure(with viewModel: BarrageViewModel) {
-        // 在这里设置你的Label文本、Image图片等
+        // 在这里设置您的Label文本、Image图片等
         // 由于开启了异步绘制，这些内容的最终渲染会尽量在后台完成
     }
 
@@ -379,7 +384,7 @@ class BarrageCell: UITableViewCell {
    ```
 2. **发送端:** 在发送时，将这个 JSON 结构转换为字符串，并通过 `sendCustomMessage` 的 `data` 参数发送出去。`businessId` 可以设置为一个能代表您业务的唯一标识，例如 "`barrage_style_v1`"。
 
-3. **接收端**: 在接收到弹幕消息后，检查其 `messageType` 是否为 `.custom` 以及 `businessId` 是否匹配。如果匹配，则解析 `data` 字符串（通常是解析JSON），根据解析出的数据（例如 `color、text`）来渲染您的自定义UI样式。
+3. **接收端**: 在接收到弹幕消息后，检查其 `messageType` 是否为 `.custom` 以及 `businessId` 是否匹配。如果匹配，则解析 `data` 字符串（通常是解析 JSON），根据解析出的数据（例如 `color、text`）来渲染您的自定义 UI 样式。
 
 ### 我在不同的类、不同的文件中都调用了 `BarrageStore.create(liveID: "some_id")`，这会创建出多个实例导致混乱吗？
 
@@ -400,15 +405,23 @@ class BarrageCell: UITableViewCell {
 
 `AtomicXCore` 支持拉取历史弹幕消息，但这需要您在**服务端控制台**进行一项简单的配置。配置完成后，SDK 会自动处理后续的一切，您无需编写额外的代码。
 
-**步骤1：在 IM 控制台进行配置**
-1. 登录您的 [即时通讯 IM 控制台](https://cloud.tencent.com/login?s_url=https%3A%2F%2Fconsole.cloud.tencent.com%2Fim)。
+**步骤1：在控制台进行配置**
+
+根据您的应用创建方式，选择对应的控制台进行配置（实时音视频控制台或即时通信 IM 控制台）。
+
+在控制台的配置页面中，找到**查看直播间历史消息**选项，修改其配置（最大支持 **50** 条消息）。
+- 若您的应用在 [实时音视频控制台](https://console.cloud.tencent.com/trtc/app) 创建，配置步骤如下：
+
+   左侧导航栏选择**应用管理** > **功能配置 **>** LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
+
+- 若您的应用在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/rtc-config) 创建，配置步骤如下：
 
-2. 在左侧导航栏按照路径：**消息服务 Chat** >** 功能配置 **>** 群组配置 **> **群功能配置** >** 直播群新成员查看入群前消息量配置**进行导航。
+   左侧导航栏选择**音视频服务 RTC**，选择对应的应用后，单击**在线直播/语音聊天室(TUILiveKit) > 配置**。
 
-3. 修改“新成员可查看最近消息数”，最大支持 **50** 条。
+   进入 **LiveKit 功能配置**后，单击**查看直播间历史消息** > **编辑**。
 
    **步骤2：客户端无感获取 **
 
    完成上述配置后，您的客户端代码**无需做任何改动**。
 
-   当新用户加入直播间时，`AtomicXCore` 的底层 会自动拉取您配置的历史消息数量。这些历史消息会和实时消息一样，通过您已实现的 `BarrageStore.state` 订阅通道推送给您的UI层。您的应用会像接收实时弹幕一样，自然地接收并展示这些历史弹幕。
+   当新用户加入直播间时，`AtomicXCore` 的底层 会自动拉取您配置的历史消息数量。这些历史消息会和实时消息一样，通过您已实现的 `BarrageStore.state` 订阅通道推送给您的 UI 层。您的应用会像接收实时弹幕一样，自然地接收并展示这些历史弹幕。

package/resource/{doc → knowledge}/livekit/core-sdk/live/ios/live-base-beauty.md

@@ -14,16 +14,17 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 BaseBeautyStore 相关的核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| `BaseBeautyState` | `struct` | 代表基础美颜模块的当前状态。包含了当前生效的磨皮 (`smoothLevel`)、美白 (`whitenessLevel`) 和红润 (`ruddyLevel`) 的强度值。 |
-| `BaseBeautyStore` | `class` | 这是与基础美颜功能交互的核心管理类。它是一个全局单例 (`shared`)，负责所有基础美颜参数的设置、重置和状态同步。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|`BaseBeautyState`|`struct`|代表基础美颜模块的当前状态。包含了当前生效的磨皮 (`smoothLevel`)、美白 (`whitenessLevel`) 和红润 (`ruddyLevel`) 的强度值。|
+|`BaseBeautyStore`|`class`|这是与基础美颜功能交互的核心管理类。它是一个全局单例 (`shared`)，负责所有基础美颜参数的设置、重置和状态同步。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 开始直播 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
 
 ### 步骤2：获取实例并监听状态
 
@@ -70,7 +71,7 @@ class BeautyManager {
 当用户拖动美颜滑块或点击预设按钮时，调用相应的接口设置美颜强度。
 
 #### 实现方式
-1. **获取强度值**：从 UI 控件（如 `UISlider`）获取用户设定的强度值。请注意，SDK 接口接收的参数范围是 `[0, 9]`，其中 `0` 表示关闭效果，`9` 表示效果最明显。您需要将 UI 控件的值（例如 UISlider 的 `0.0 - 1.0`）映射到 `0 - 9` 的范围。
+1. **获取强度值**：从 UI 控件（例如 `UISlider`）获取用户设定的强度值。请注意，SDK 接口接收的参数范围是 `[0, 9]`，其中 `0` 表示关闭效果，`9` 表示效果最明显。您需要将 UI 控件的值（例如 UISlider 的 `0.0 - 1.0`）映射到 `0 - 9` 的范围。
 
 2. **调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:) `来设置磨皮、美白、红润的强度。
 
@@ -121,12 +122,13 @@ extension BeautyManager {
 ### 基础美颜与高级美颜对比
 
 AtomicXCore 也提供了高级美颜支持，以满足不同场景的需求
-| **对比项** | **基础美颜 (BaseBeautyStore)** | **高级美颜 (TEBeautyKit 需额外集成)** |
-| --- | --- | --- |
-| 核心功能 | 磨皮、美白、红润 | 包含基础美颜，并增加 V 脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果 |
-| 计费 | 免费 (包含在 AtomicXCore 授权内) | 付费（需要额外购买腾讯特效 SDK License） |
-| 集成方式 | 默认内置，直接使用 `BaseBeautyStore.shared` | 需要额外集成 `TEBeautyKit` 组件并进行鉴权 |
-| 推荐场景 | 对美颜要求不高，需要快速实现基础美颜功能的场景 | 对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景 |
+
+|**对比项**|**基础美颜 (BaseBeautyStore)**|**高级美颜 (TEBeautyKit 需额外集成)**|
+|---------|---------|---------|
+|核心功能|磨皮、美白、红润。|包含基础美颜，并增加 V 脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果。|
+|计费|免费 (包含在 AtomicXCore 授权内)。|付费（需要额外购买腾讯特效 SDK License） 。|
+|集成方式|默认内置，直接使用 `BaseBeautyStore.shared`。|需要额外集成 `TEBeautyKit` 组件并进行鉴权。|
+|推荐场景|对美颜要求不高，需要快速实现基础美颜功能的场景。|对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景。|
 
 ### 集成高级美颜
 
@@ -135,10 +137,11 @@ AtomicXCore 也提供了高级美颜支持，以满足不同场景的需求
 ## API 文档
 
 关于 [BaseBeautyStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| Store/Component | 功能描述 | API 文档 |
-| --- | --- | --- |
-| BaseBeautyStore | 基础美颜：调节磨皮 / 美白 / 红润（0-9 级），重置美颜状态，同步效果参数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore) |
-| DeviceStore | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore) |
+
+|Store/Component|功能描述|API 文档|
+|---------|---------|---------|
+|BaseBeautyStore|基础美颜：调节磨皮 / 美白 / 红润（0-9 级），重置美颜状态，同步效果参数。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore)|
+|DeviceStore|音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore)|
 
 ## 常见问题
 

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

@@ -11,7 +11,7 @@
 
 ### 步骤1：组件集成
 
-请参考 开始直播 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
 
 ### 步骤2：实现观众申请上麦
 
@@ -52,13 +52,13 @@
          .sink { [weak self] event in
              if case let .onGuestApplicationResponded(isAccept, hostUser) = event {
                  if isAccept {
-                     print("主播 \(hostUser.userName) 同意了你的申请，准备上麦")
+                     print("主播 \(hostUser.userName) 同意了您的申请，准备上麦")
                      // 1. 打开摄像头、麦克风
                      DeviceStore.shared.openLocalCamera(isFront: true, completion: nil)
                      DeviceStore.shared.openLocalMicrophone(completion: nil)
                      // 2. 在此更新 UI，例如关闭申请按钮，显示连麦中的状态
                  } else {
-                     print("主播 \(hostUser.userName) 拒绝了你的申请")
+                     print("主播 \(hostUser.userName) 拒绝了您的申请")
                      // 弹窗提示用户申请被拒绝
                  }
              }
@@ -190,9 +190,9 @@
    // 在 hostEventPublisher 的订阅中添加
    if case let .onHostInvitationResponded(isAccept, guestUser) = event {
        if isAccept {
-           print("观众 \(guestUser.userName) 接受了你的邀请")
+           print("观众 \(guestUser.userName) 接受了您的邀请")
        } else {
-           print("观众 \(guestUser.userName) 拒绝了你的邀请")
+           print("观众 \(guestUser.userName) 拒绝了您的邀请")
        }
    }
    ```
@@ -253,7 +253,7 @@
 > **提示：**
 >
 
-> 您也可以参考 TUILiveKit 开源项目中的 [AnchorCoGuestView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Features/AnchorBoardcast/View/LivingView/Video/AnchorCoGuestView.swift) 和 [AnchorEmptySeatView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Features/AnchorBoardcast/View/LivingView/Video/AnchorEmptySeatView.swift) 文件来了解完整的实现逻辑。
+> 您也可以参考 TUILiveKit 开源项目中的 [AnchorCoGuestView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Features/AnchorView/View/VideoWidgets/AnchorCoGuestView.swift) 和 [AnchorEmptySeatView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Features/AnchorView/View/VideoWidgets/AnchorEmptySeatView.swift) 文件来了解完整的实现逻辑。
 >
 
 - **步骤 1**：创建前景视图 (**CustomSeatView**)，该视图用于在视频流上方显示用户信息。
@@ -338,24 +338,25 @@
    ```
 
 #### **参数说明**：
-| **参数** | **类型** | **说明** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>说明</strong> |
 | --- | --- | --- |
-| `seatInfo` | `TUISeatFullInfo` | 麦位信息对象，包含麦上用户的详细信息。 |
-| `seatInfo.userID` | `String?` | 麦上用户的 ID。 |
-| `seatInfo.userName` | `String? ` | 麦上用户的昵称。 |
-| `seatInfo.userAvatar` | `String?` | 麦上用户的头像 URL。 |
-| `seatInfo.userMicrophoneStatus` | `TUIDeviceStatus` | 麦上用户的麦克风状态。 |
-| `seatInfo.userCameraStatus ` | `TUIDeviceStatus` | 麦上用户的摄像头状态。 |
-| `viewLayer` | `ViewLayer` | 视图层级枚举。<br>`.foreground` 表示前景挂件视图，始终显示在视频画面的最上层。<br>`.background` 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
+| <code>seatInfo</code> | <code>TUISeatFullInfo</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>TUIDeviceStatus</code> | 麦上用户的麦克风状态。 |
+| <code>seatInfo.userCameraStatus </code> | <code>TUIDeviceStatus</code> | 麦上用户的摄像头状态。 |
+| <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举。<br><code>.foreground</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br><code>.background</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ## API 文档
 
 关于 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| Store/Component | 功能描述 | API 文档 |
-| --- | --- | --- |
-| LiveCoreView | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview) |
-| DeviceStore | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore) |
-| CoGuestStore | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) |
+
+|Store/Component|功能描述|API 文档|
+|---------|---------|---------|
+|LiveCoreView|直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview)|
+|DeviceStore|音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore)|
+|CoGuestStore|观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore)|
 
 ## 常见问题
 

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

@@ -1,25 +1,27 @@
 `GiftStore` 是 `AtomicXCore` 中专门负责管理直播间礼物功能的模块。通过它，您可以为您的直播应用构建一套完整的礼物系统，实现丰富的营收和互动场景。
-| 礼物面板 | 弹幕礼物 | 全屏礼物 |
-| --- | --- | --- |
-|  |  |  |
+
+|礼物面板|弹幕礼物|全屏礼物|
+|---------|---------|---------|
+||||
 
 ## 核心功能
 - **礼物列表获取**：从服务端拉取礼物面板所需的数据，包括礼物分类和礼物详情。
 
-- **发送礼物**：观众可以向主播发送选定的礼物，并附带数量。
+- **发送礼物功能**：观众可以向主播发送选定的礼物，并附带数量。
 
 - **礼物事件广播**：实时接收房间内发生的礼物赠送事件，用于展示礼物动画和弹幕通知。
 
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `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：获取礼物列表
 
@@ -146,7 +148,7 @@ extension GiftManager {
 }
 ```
 
-### 步骤4：发送礼物
+### 步骤4：实现发送礼物功能
 
 当用户在礼物面板选择一个礼物并点击发送时，调用 `sendGift` 接口将礼物发送出去。
 
@@ -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)。
 
@@ -330,7 +335,7 @@ class LiveRoomViewController: UIViewController, SVGAPlayerDelegate {
 
 ### 在弹幕区展示礼物赠送消息
 
-当有用户发送礼物时，不仅播放动画，同时在公屏弹幕区域显示一条系统消息，例如：“【观众昵称】送出了【礼物名称】x【数量】”，让所有观众都能看到。
+当有用户调用发送礼物接口时，不仅播放动画，同时在公屏弹幕区域显示一条系统消息，例如：“【观众昵称】送出了【礼物名称】x【数量】”，让所有观众都能看到。
 
 #### 实现方式
 1. **监听事件**：订阅 `giftStore.giftEventPublisher`。
@@ -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)|
 
 ## 常见问题