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

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

@@ -14,16 +14,17 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `BaseBeautyStore` 相关的核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| [BaseBeautyState](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_base_beauty_store/BaseBeautyState-class.html) | `class` | 代表基础美颜模块的当前状态。包含了当前生效的磨皮 (`smoothLevel`)、美白 (`whitenessLevel`) 和红润 (`ruddyLevel`) 的强度值。所有属性均为 `ValueListenable<double>` 类型，支持订阅监听。 |
-| [BaseBeautyStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_base_beauty_store/BaseBeautyStore-class.html) | `class` | 这是与基础美颜功能交互的核心管理类。它是一个全局单例 (`shared`)，负责所有基础美颜参数的设置、重置和状态同步。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|[BaseBeautyState](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_base_beauty_store/BaseBeautyState-class.html)|`class`|代表基础美颜模块的当前状态。包含了当前生效的磨皮 (`smoothLevel`)、美白 (`whitenessLevel`) 和红润 (`ruddyLevel`) 的强度值。所有属性均为 `ValueListenable<double>` 类型，支持订阅监听。|
+|[BaseBeautyStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_base_beauty_store/BaseBeautyStore-class.html)|`class`|这是与基础美颜功能交互的核心管理类。它是一个全局单例 (`shared`)，负责所有基础美颜参数的设置、重置和状态同步。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 开始直播 集成 **AtomicXCore**，完成接入。
+请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：获取实例并监听状态
 
@@ -82,7 +83,7 @@ class BeautyManager {
 当用户拖动美颜滑块或点击预设按钮时，调用相应的接口设置美颜强度。
 
 #### 实现方式
-1. **获取强度值**：从 UI 控件（如 `Slider`）获取用户设定的强度值。SDK 接口接收的参数范围是 `0-9`，其中 `0` 表示关闭效果，`9` 表示效果最明显。您需要将 UI 控件的值（例如 Slider 的 `0.0 - 1.0`）映射到 `0 - 9` 的范围。
+1. **获取强度值**：从 UI 控件（例如 `Slider`）获取用户设定的强度值。SDK 接口接收的参数范围是 `0-9`，其中 `0` 表示关闭效果，`9` 表示效果最明显。您需要将 UI 控件的值（例如 Slider 的 `0.0 - 1.0`）映射到 `0 - 9` 的范围。
 
 2. **调用接口**：分别调用 `setSmoothLevel()`、`setWhitenessLevel()`、`setRuddyLevel()` 来设置磨皮、美白、红润的强度。
 
@@ -302,12 +303,13 @@ class BeautySettingsPage extends StatelessWidget {
 ### 基础美颜与高级美颜对比
 
 AtomicXCore 也提供了高级美颜支持，以满足不同场景的需求：
-| **对比项** | **基础美颜 (BaseBeautyStore)** | **高级美颜 (TencentEffect 需额外集成)** |
-| --- | --- | --- |
-| 核心功能 | 磨皮、美白、红润 | 包含基础美颜，并增加 V 脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果 |
-| 计费 | 免费 (包含在 AtomicXCore 授权内) | 付费（需要额外购买腾讯特效 SDK License） |
-| 集成方式 | 默认内置，直接使用 `BaseBeautyStore.shared` | 需要额外集成 `TencentEffect` 组件并进行鉴权 |
-| 推荐场景 | 对美颜要求不高，需要快速实现基础美颜功能的场景 | 对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景 |
+
+|**对比项**|**基础美颜 (BaseBeautyStore)**|**高级美颜 (TencentEffect 需额外集成)**|
+|---------|---------|---------|
+|核心功能|磨皮、美白、红润。|包含基础美颜，并增加 V 脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果。|
+|计费|免费 (包含在 AtomicXCore 授权内)。|付费（需要额外购买腾讯特效 SDK License）。|
+|集成方式|默认内置，直接使用 `BaseBeautyStore.shared`。|需要额外集成 `TencentEffect` 组件并进行鉴权。|
+|推荐场景|对美颜要求不高，需要快速实现基础美颜功能的场景。|对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景。|
 
 ### 集成高级美颜
 
@@ -316,21 +318,23 @@ AtomicXCore 也提供了高级美颜支持，以满足不同场景的需求：
 ## API 参考
 
 ### BaseBeautyStore
-| **属性/方法** | **类型** | **说明** |
-| --- | --- | --- |
-| `shared` | `BaseBeautyStore` | 单例实例 |
-| `baseBeautyState` | `BaseBeautyState` | 美颜状态 |
-| `setSmoothLevel` | `void` | 设置磨皮强度（0-9） |
-| `setWhitenessLevel` | `void` | 设置美白强度（0-9） |
-| `setRuddyLevel` | `void` | 设置红润强度（0-9） |
-| `reset` | `void` | 重置所有美颜参数至默认值（0） |
+
+|**属性/方法**|**类型**|**说明**|
+|---------|---------|---------|
+|`shared`|`BaseBeautyStore`|单例实例|
+|`baseBeautyState`|`BaseBeautyState`|美颜状态|
+|`setSmoothLevel`|`void`|设置磨皮强度（0-9）|
+|`setWhitenessLevel`|`void`|设置美白强度（0-9）|
+|`setRuddyLevel`|`void`|设置红润强度（0-9）|
+|`reset`|`void`|重置所有美颜参数至默认值（0）|
 
 ### BaseBeautyState
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| `smoothLevel` | `ValueListenable<double>` | 磨皮强度（0-9） |
-| `whitenessLevel` | `ValueListenable<double>` | 美白强度（0-9） |
-| `ruddyLevel` | `ValueListenable<double>` | 红润强度（0-9） |
+
+|**属性**|**类型**|**说明**|
+|---------|---------|---------|
+|`smoothLevel`|`ValueListenable<double>`|磨皮强度（0-9）|
+|`whitenessLevel`|`ValueListenable<double>`|美白强度（0-9）|
+|`ruddyLevel`|`ValueListenable<double>`|红润强度（0-9）|
 
 ## 常见问题
 

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

@@ -11,7 +11,7 @@
 
 ### 步骤1：组件集成
 
-请参考 开始直播 集成 **AtomicXCore**，并完成 **LiveCoreWidget** 的接入。
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreWidget** 的接入。
 
 完成集成后，开始实现连麦功能。
 
@@ -56,14 +56,14 @@
    void subscribeGuestEvents() {
        _guestListener = GuestListener(
            onApplicationAccepted: (hostUser) {
-               print("主播 ${hostUser.userName} 同意了你的申请，准备上麦");
+               print("主播 ${hostUser.userName} 同意了您的申请，准备上麦");
                // 1. 打开摄像头、麦克风
                DeviceStore.shared.openLocalCamera(isFront: true);
                DeviceStore.shared.openLocalMicrophone();
                // 2. 在此更新 UI，例如关闭申请按钮，显示连麦中的状态
            },
            onApplicationRejected: (hostUser) {
-               print("主播 ${hostUser.userName} 拒绝了你的申请");
+               print("主播 ${hostUser.userName} 拒绝了您的申请");
                // 弹窗提示用户申请被拒绝
            },
            onInvitationReceived: (hostUser) {
@@ -139,10 +139,10 @@
                // 在此更新 UI，例如在"申请列表"按钮上显示红点
            },
            onInvitationAccepted: (guestUser) {
-               print("观众 ${guestUser.userName} 接受了你的邀请");
+               print("观众 ${guestUser.userName} 接受了您的邀请");
            },
            onInvitationRejected: (guestUser) {
-               print("观众 ${guestUser.userName} 拒绝了你的邀请");
+               print("观众 ${guestUser.userName} 拒绝了您的邀请");
            },
        );
        guestStore.addHostListener(_hostListener);
@@ -232,10 +232,10 @@
    // 在 HostListener 中已配置回调
    _hostListener = HostListener(
        onInvitationAccepted: (guestUser) {
-           print("观众 ${guestUser.userName} 接受了你的邀请");
+           print("观众 ${guestUser.userName} 接受了您的邀请");
        },
        onInvitationRejected: (guestUser) {
-           print("观众 ${guestUser.userName} 拒绝了你的邀请");
+           print("观众 ${guestUser.userName} 拒绝了您的邀请");
        },
    );
    ```
@@ -461,24 +461,25 @@
    ```
 
 #### **参数说明**：
-| **参数** | **类型** | **说明** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>说明</strong> |
 | --- | --- | --- |
-| `seatFullInfo` | `SeatFullInfo` | 麦位信息对象，包含麦上用户的详细信息。 |
-| `seatFullInfo.userInfo.userId` | `String` | 麦上用户的 ID。 |
-| `seatFullInfo.userInfo.userName` | `String` | 麦上用户的昵称。 |
-| `seatFullInfo.userInfo.avatarUrl` | `String` | 麦上用户的头像 URL。 |
-| `viewLayer` | `ViewLayer` | 视图层级枚举。<br>- `ViewLayer.foreground` 表示前景挂件视图，始终显示在视频画面的最上层。<br>- `ViewLayer.background` 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
+| <code>seatFullInfo</code> | <code>SeatFullInfo</code> | 麦位信息对象，包含麦上用户的详细信息。 |
+| <code>seatFullInfo.userInfo.userId</code> | <code>String</code> | 麦上用户的 ID。 |
+| <code>seatFullInfo.userInfo.userName</code> | <code>String</code> | 麦上用户的昵称。 |
+| <code>seatFullInfo.userInfo.avatarUrl</code> | <code>String</code> | 麦上用户的头像 URL。 |
+| <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举。<br>- <code>ViewLayer.foreground</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br>- <code>ViewLayer.background</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ## API 文档
 
 关于 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| LiveCoreWidget | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreWidget-class.html) |
-| LiveCoreController | LiveCoreWidget 的控制器：用于设置直播 ID、控制预览等操作。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreController-class.html) |
-| VideoWidgetBuilder | 视频视图适配器：用于自定义连麦观众、主播连线、PK 等场景的视频流挂件视图。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/VideoWidgetBuilder-class.html) |
-| DeviceStore | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html) |
-| CoGuestStore | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|LiveCoreWidget|直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreWidget-class.html)|
+|LiveCoreController|LiveCoreWidget 的控制器：用于设置直播 ID、控制预览等操作。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreController-class.html)|
+|VideoWidgetBuilder|视频视图适配器：用于自定义连麦观众、主播连线、PK 等场景的视频流挂件视图。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/VideoWidgetBuilder-class.html)|
+|DeviceStore|音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html)|
+|CoGuestStore|观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html)|
 
 ## 常见问题
 

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

@@ -1,7 +1,8 @@
 `GiftStore` 是 `AtomicXCore` 中专门负责管理直播间礼物功能的模块。通过它，您可以为您的直播应用构建一套完整的礼物系统，实现丰富的营收和互动场景。
-| **礼物面板** | **弹幕礼物** | **全屏礼物** |
-| --- | --- | --- |
-|  |  |  |
+
+|**礼物面板**|**弹幕礼物**|**全屏礼物**|
+|---------|---------|---------|
+||||
 
 ## 核心功能
 - **礼物列表获取**：从服务端拉取礼物面板所需的数据，包括礼物分类和礼物详情。
@@ -13,19 +14,21 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `GiftStore` 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| [Gift](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/Gift-class.html) | `class` | 代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。 |
-| [GiftCategory](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftCategory-class.html) | `class` | 代表一个礼物分类，例如"热门"、"豪华"等。它包含了分类的名称以及该分类下的 **Gift** 列表。 |
-| [GiftState](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftState-class.html) | `class` | 代表礼物模块的当前状态。其核心属性 `usableGifts` 是一个 `ValueListenable<List<GiftCategory>>`，存储了从服务端拉取到的完整礼物列表。 |
-| [GiftListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftListener-class.html) | `class` | 礼物事件监听器，通过 `onReceiveGift` 回调接收礼物赠送事件，当有任何人（包括自己）发送礼物时，房间内所有人都会收到此事件。 |
-| [GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html) | `class` | 这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、发送礼物，并通过 `addGiftListener` 来接收礼物事件。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|[Gift](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/Gift-class.html)|`class`|代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。|
+|[GiftCategory](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftCategory-class.html)|`class`|代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift** 列表。|
+|[GiftState](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftState-class.html)|`class`|代表礼物模块的当前状态。其核心属性 `usableGifts` 是一个 `ValueListenable<List<GiftCategory>>`，存储了从服务端拉取到的完整礼物列表。|
+|[GiftListener](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftListener-class.html)|`class`|礼物事件监听器，通过 `onReceiveGift` 回调接收礼物赠送事件，当有任何人（包括自己）发送礼物时，房间内所有人都会收到此事件。|
+|[GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html)|`class`|这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、发送礼物，并通过 `addGiftListener` 来接收礼物事件。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 开始直播 集成 **AtomicXCore**，完成接入。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：初始化并监听礼物事件
 
@@ -95,26 +98,26 @@ class GiftManager {
 #### 礼物列表结构体参数
 - `GiftCategory`**参数说明**
 
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `categoryID` | `String` | 礼物分类的唯一 ID。 |
-| `name` | `String` | 礼物分类的显示名称。 |
-| `desc` | `String` | 礼物分类的描述信息。 |
-| `extensionInfo` | `Map<String, String>` | 扩展信息字段。 |
-| `giftList` | `List<Gift>` | 该分类下包含的 Gift 礼物对象数组。 |
+   |**参数**|**类型**|**描述**|
+   |---------|---------|---------|
+   |`categoryID`|`String`|礼物分类的唯一 ID。|
+   |`name`|`String`|礼物分类的显示名称。|
+   |`desc`|`String`|礼物分类的描述信息。|
+   |`extensionInfo`|`Map<String, String>`|扩展信息字段。|
+   |`giftList`|`List<Gift>`|该分类下包含的 Gift 礼物对象数组。|
 
 - `Gift`**参数说明**
 
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `giftID` | `String` | 礼物的唯一 ID。 |
-| `name` | `String` | 礼物的显示名称。 |
-| `desc` | `String` | 礼物的描述信息。 |
-| `iconURL` | `String` | 礼物图标 URL。 |
-| `resourceURL` | `String` | 礼物动画资源 URL。 |
-| `level` | `int` | 礼物等级。 |
-| `coins` | `int` | 礼物价格。 |
-| `extensionInfo` | `Map<String, String>` | 扩展信息字段。 |
+   |**参数**|**类型**|**描述**|
+   |---------|---------|---------|
+   |`giftID`|`String`|礼物的唯一 ID。|
+   |`name`|`String`|礼物的显示名称。|
+   |`desc`|`String`|礼物的描述信息。|
+   |`iconURL`|`String`|礼物图标 URL。|
+   |`resourceURL`|`String`|礼物动画资源 URL。|
+   |`level`|`int`|礼物等级。|
+   |`coins`|`int`|礼物价格。|
+   |`extensionInfo`|`Map<String, String>`|扩展信息字段。|
 
 ### 步骤3：获取礼物列表
 
@@ -165,17 +168,18 @@ extension GiftManagerSend on GiftManager {
       // 发送成功后，包括发送者在内的所有人都会收到 onReceiveGift 事件
     } else {
       debugPrint("礼物发送失败: ${result.errorMessage}");
-      // 可以在此提示用户，例如"余额不足"或"网络错误"
+      // 可以在此提示用户，例如“余额不足”或“网络错误”
     }
   }
 }
 ```
 
 #### `sendGift` 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `giftID` | `String` | 要发送的礼物的唯一 ID。 |
-| `count` | `int` | 发送的数量。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`giftID`|`String`|要发送的礼物的唯一 ID。|
+|`count`|`int`|发送的数量。|
 
 ## 功能进阶
 
@@ -195,23 +199,24 @@ extension GiftManagerSend on GiftManager {
 #### **配置时序图**
 
 #### **涉及 REST API 接口一览**
-| **接口分类** | **接口** | **请求示例** |
-| --- | --- | --- |
-| 礼物管理 | 添加礼物信息 | 请求示例 |
-| 礼物管理 | 删除礼物信息 | 请求示例 |
-| 礼物管理 | 查询礼物信息 | 请求示例 |
-| 礼物分类管理 | 添加礼物分类信息 | 请求示例 |
-| 礼物分类管理 | 删除指定礼物分类信息 | 请求示例 |
-| 礼物分类管理 | 获取指定礼物分类信息 | 请求示例 |
-| 礼物关系管理 | 添加指定礼物分类和礼物间的关系 | 请求示例 |
-| 礼物关系管理 | 删除指定礼物分类和礼物间的关系 | 请求示例 |
-| 礼物关系管理 | 获取指定礼物分类下的礼物关系 | 请求示例 |
-| 礼物多语言管理 | 添加礼物多语言信息 | 请求示例 |
-| 礼物多语言管理 | 删除指定礼物多语言信息 | 请求示例 |
-| 礼物多语言管理 | 获取礼物多语言信息 | 请求示例 |
-| 礼物多语言管理 | 添加礼物分类多语言信息 | 请求示例 |
-| 礼物多语言管理 | 删除指定礼物分类多语言信息 | 请求示例 |
-| 礼物多语言管理 | 获取礼物分类多语言信息 | 请求示例 |
+
+|**接口分类**|**接口**|**请求示例**|
+|---------|---------|---------|
+|礼物管理|添加礼物信息|请求示例|
+|礼物管理|删除礼物信息|请求示例|
+|礼物管理|查询礼物信息|请求示例|
+|礼物分类管理|添加礼物分类信息|请求示例|
+|礼物分类管理|删除指定礼物分类信息|请求示例|
+|礼物分类管理|获取指定礼物分类信息|请求示例|
+|礼物关系管理|添加指定礼物分类和礼物间的关系|请求示例|
+|礼物关系管理|删除指定礼物分类和礼物间的关系|请求示例|
+|礼物关系管理|获取指定礼物分类下的礼物关系|请求示例|
+|礼物多语言管理|添加礼物多语言信息|请求示例|
+|礼物多语言管理|删除指定礼物多语言信息|请求示例|
+|礼物多语言管理|获取礼物多语言信息|请求示例|
+|礼物多语言管理|添加礼物分类多语言信息|请求示例|
+|礼物多语言管理|删除指定礼物分类多语言信息|请求示例|
+|礼物多语言管理|获取礼物分类多语言信息|请求示例|
 
 ### 计费与送礼扣费流程
 
@@ -229,24 +234,26 @@ extension GiftManagerSend on GiftManager {
 #### 调用流程图
 
 #### 涉及 REST API 接口一览
-| **接口** | **说明** | **请求示例** |
-| --- | --- | --- |
-| 回调配置 - 发送礼物之前回调 | 客户后台可以通过该回调决定是否通过送礼前校验等场景 | 调用示例 |
+
+|**接口**|**说明**|**请求示例**|
+|---------|---------|---------|
+|回调配置 - 发送礼物之前回调|客户后台可以通过该回调决定是否通过送礼前校验等场景|调用示例|
 
 ### 播放全屏礼物动画
 
-当直播间有用户（包括自己）发送了"火箭"、"嘉年华"等豪华礼物时，全屏播放一个酷炫的礼物动画（例如 SVGA 动画），营造热烈的氛围。
+当直播间有用户（包括自己）发送了“火箭”、“嘉年华”等豪华礼物时，全屏播放一个酷炫的礼物动画（例如 SVGA 动画），营造热烈的氛围。
 
 #### 实现方式
 
 `AtomicXCore` 本身不包含礼物动画播放器，您需要根据业务需求选择并集成第三方库。以下是两种方案的对比：
-| **对比项** | **基础方案 (svgaplayer_flutter)** | **高级方案 (TCEffectPlayerKit)** |
-| --- | --- | --- |
-| 计费 | 免费 (开源库) | 付费 (需购买 License)，请参见 [付费指引](https://cloud.tencent.com/document/product/616/116461) |
-| 集成方式 | 需手动集成 [svgaplayer_flutter](https://pub.dev/packages/svgaplayer_flutter) 库 | 需额外集成 [flutter_effect_player](https://github.com/Tencent-RTC/EffectPlayer_Flutter)库并进行鉴权 |
-| 动画格式支持 | 仅支持 SVGA | SVGA、PAG、WebP、Lottie、MP4 等多种格式 |
-| 性能 | 建议 SVGA 文件 ≤ 10MB | 支持更大的动画文件，复杂特效/多动画并发/低端机表现更优 |
-| 推荐场景 | 礼物动画格式统一为 SVGA，且文件大小可控 | 需要支持多种动画格式，或对动画性能/设备兼容性有更高要求 |
+
+|**对比项**|**基础方案 (svgaplayer_flutter)**|**高级方案 (TCEffectPlayerKit)**|
+|---------|---------|---------|
+|计费|免费 (开源库)。|付费 (需购买 License)，请参见 [付费指引](https://cloud.tencent.com/document/product/616/116461)。|
+|集成方式|需手动集成 [svgaplayer_flutter](https://pub.dev/packages/svgaplayer_flutter) 库。|需额外集成 [flutter_effect_player](https://github.com/Tencent-RTC/EffectPlayer_Flutter) 库并进行鉴权。|
+|动画格式支持|仅支持 SVGA。|SVGA、PAG、WebP、Lottie、MP4 等多种格式。|
+|性能|建议 SVGA 文件 ≤ 10MB。|支持更大的动画文件，复杂特效/多动画并发/低端机表现更优。|
+|推荐场景|礼物动画格式统一为 SVGA，且文件大小可控。|需要支持多种动画格式，或对动画性能/设备兼容性有更高要求。|
 
 本章节主要演示基础方案的集成。如果您选择高级方案，请参考 [EffectPlayer Flutter 集成指引](https://cloud.tencent.com/document/product/616/123945)。
 
@@ -343,7 +350,7 @@ class _LiveRoomWidgetState extends State<LiveRoomWidget> with SingleTickerProvid
 
 ### 在弹幕区展示礼物赠送消息
 
-当有用户发送礼物时，不仅播放动画，同时在公屏弹幕区域显示一条系统消息，例如："【观众昵称】送出了【礼物名称】x【数量】"，让所有观众都能看到。
+当有用户发送礼物时，不仅播放动画，同时在公屏弹幕区域显示一条系统消息，例如：“【观众昵称】送出了【礼物名称】x【数量】”，让所有观众都能看到。
 
 #### 实现方式
 1. **监听事件**：通过 `giftStore.addGiftListener` 添加监听器。
@@ -384,11 +391,12 @@ void _setupGiftToBarrageFlow() {
 
 ## API 文档
 
-关于 [GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **GiftStore** | 礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html) |
-| **BarrageStore** | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageStore-class.html) |
+关于 [GiftStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**GiftStore**|礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_gift_gift_store/GiftStore-class.html)|
+|**BarrageStore**|弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageStore-class.html)|
 
 ## 常见问题
 
@@ -398,12 +406,13 @@ void _setupGiftToBarrageFlow() {
 
 ### 如何实现礼物的多语言展示（例如中文、英文）？
 
-`GiftStore` 提供了 `setLanguage(String language)` 接口。您可以在 `refreshUsableGifts` 之前调用此方法，传入目标语言代码（例如 "en" 或 "zh-CN"）。服务端会根据此语言代码，返回对应语言的礼物名称和描述。
+`GiftStore` 提供了 `setLanguage(String language)` 接口。您可以在 `refreshUsableGifts` 之前调用此方法，传入目标语言代码（例如 “en” 或 “zh-CN”）。服务端会根据此语言代码，返回对应语言的礼物名称和描述。
 
 ### 我调用 sendGift 发送了礼物，礼物动画为什么重复播放了两次？
 
 `onReceiveGift` 事件是对房间内所有成员的广播（包括发送者自己）。如果您在 `sendGift` 的成功回调里执行了一次 UI 操作，同时又在 `onReceiveGift` 回调中执行了相同的 UI 操作，就会造成重复。
-- **最佳实践**：UI 的更新（例如播放动画、弹幕提示）只在 `onReceiveGift` 事件的回调中处理。`sendGift` 的返回结果仅用于处理发送失败的逻辑（例如提示用户"发送失败"或"余额不足"）。
+
+**实践**：UI 的更新（例如播放动画、弹幕提示）只在 `onReceiveGift` 事件的回调中处理。`sendGift` 的返回结果仅用于处理发送失败的逻辑（例如提示用户“发送失败”或“余额不足”）。
 
 ### 礼物扣费逻辑在哪里实现？
 

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

@@ -8,7 +8,7 @@
 
 ### 步骤1：组件集成
 
-请参考 开始直播 集成 **AtomicXCore**，并完成 **LiveCoreWidget** 的接入。
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreWidget** 的接入。
 
 ### 步骤2：实现跨房连线
 
@@ -17,7 +17,7 @@
 #### 邀请方（主播 A）实现
 1. **发起连线邀请**
 
-   当主播A在界面上选择目标主播 B 并发起连线时，调用 `requestHostConnection` 方法。
+   当主播 A 在界面上选择目标主播 B 并发起连线时，调用 `requestHostConnection` 方法。
 
    ``` java
    import 'package:atomic_x_core/atomicxcore.dart';
@@ -77,10 +77,10 @@
    void _setupListeners() {
      _coHostListener = CoHostListener(
        onCoHostRequestAccepted: (invitee) {
-         print('主播 ${invitee.userName} 同意了你的连线邀请');
+         print('主播 ${invitee.userName} 同意了您的连线邀请');
        },
        onCoHostRequestRejected: (invitee) {
-         print('主播 ${invitee.userName} 拒绝了你的邀请');
+         print('主播 ${invitee.userName} 拒绝了您的邀请');
        },
        onCoHostRequestTimeout: (inviter, invitee) {
          print('邀请超时，对方未回应');
@@ -99,7 +99,7 @@
 #### 受邀方（主播 B）实现
 1. **接收连线邀请**
 
-   通过 `CoHostListener`，主播B可以监听到来自主播 A 的邀请。
+   通过 `CoHostListener`，主播 B 可以监听到来自主播 A 的邀请。
 
    ``` java
    import 'package:atomic_x_core/atomicxcore.dart';
@@ -478,13 +478,13 @@
    ```
 
 #### **参数说明**：
-| **参数** | **类型** | **说明** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>说明</strong> |
 | --- | --- | --- |
-| `seatFullInfo` | `SeatFullInfo` | 麦位信息对象，包含麦上用户的详细信息 |
-| `seatFullInfo.userInfo.userId` | `String` | 麦上用户的 ID |
-| `seatFullInfo.userInfo.userName` | `String` | 麦上用户的昵称 |
-| `seatFullInfo.userInfo.avatarUrl` | `String` | 麦上用户的头像 URL |
-| `viewLayer` | `ViewLayer` | 视图层级枚举<br>`ViewLayer.foreground` 表示前景挂件视图，始终显示在视频画面的最上层<br>`ViewLayer.background` 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图 |
+| <code>seatFullInfo</code> | <code>SeatFullInfo</code> | 麦位信息对象，包含麦上用户的详细信息。 |
+| <code>seatFullInfo.userInfo.userId</code> | <code>String</code> | 麦上用户的 ID。 |
+| <code>seatFullInfo.userInfo.userName</code> | <code>String</code> | 麦上用户的昵称。 |
+| <code>seatFullInfo.userInfo.avatarUrl</code> | <code>String</code> | 麦上用户的头像 URL。 |
+| <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举：<br>- <code>ViewLayer.foreground</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br>- <code>ViewLayer.background</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ### 实现 PK 用户视图的分数展示
 
@@ -638,14 +638,15 @@
    ```
 
 #### **参数说明**：
-| **参数** | **类型** | **说明** |
-| --- | --- | --- |
-| `battleUser` | `TUIBattleUser` | PK 用户信息对象 |
-| `battleUser.roomId` | `String` | PK 的房间 ID |
-| `battleUser.userId` | `String` | PK 用户 ID |
-| `battleUser.userName` | `String` | PK 用户昵称 |
-| `battleUser.avatarUrl` | `String` | PK 用户头像地址 |
-| `battleUser.score` | `int` | PK 分数 |
+
+|**参数**|**类型**|**说明**|
+|---------|---------|---------|
+|`battleUser`|`TUIBattleUser`|PK 用户信息对象。|
+|`battleUser.roomId`|`String`|PK 的房间 ID。|
+|`battleUser.userId`|`String`|PK 用户 ID。|
+|`battleUser.userName`|`String`|PK 用户昵称。|
+|`battleUser.avatarUrl`|`String`|PK 用户头像地址。|
+|`battleUser.score`|`int`|PK 分数。|
 
 ### 实现视频流画面上的 PK 状态显示
 
@@ -799,12 +800,13 @@ class _FullCustomLiveWidgetState extends State<FullCustomLiveWidget> {
 
 > 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 调用流程
 
@@ -822,24 +824,26 @@ class _FullCustomLiveWidgetState extends State<FullCustomLiveWidget> {
 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://pub.dev/documentation/atomic_x_core/latest/api_live_co_host_store/CoHostStore-class.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **LiveCoreWidget** | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreWidget-class.html) |
-| **LiveCoreController** | LiveCoreWidget 的控制器：用于设置直播 ID、控制预览等操作。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreController-class.html) |
-| **VideoWidgetBuilder** | 视频视图适配器：用于自定义连线主播、PK 用户、PK 容器等场景的视频流挂件视图。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/VideoWidgetBuilder-class.html) |
-| **DeviceStore** | 音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html) |
-| **CoHostStore** | 主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_host_store/api_live_co_host_store-library.html) |
-| **BattleStore** | 主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_battle_store/BattleStore-class.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**LiveCoreWidget**|直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreWidget-class.html)|
+|**LiveCoreController**|LiveCoreWidget 的控制器：用于设置直播 ID、控制预览等操作。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/LiveCoreController-class.html)|
+|**VideoWidgetBuilder**|视频视图适配器：用于自定义连线主播、PK 用户、PK 容器等场景的视频流挂件视图。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_view_live_live_core_widget/VideoWidgetBuilder-class.html)|
+|**DeviceStore**|音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html)|
+|**CoHostStore**|主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_host_store/api_live_co_host_store-library.html)|
+|**BattleStore**|主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_battle_store/BattleStore-class.html)|
 
 ## 常见问题
 
@@ -850,14 +854,14 @@ class _FullCustomLiveWidgetState extends State<FullCustomLiveWidget> {
 
 ### 连线或 PK 过程中，一方主播网络断开或 App 崩溃了怎么办？
 
-**CoHostStore** 和 **BattleStore** 内部都有心跳和超时检测机制。如果一方异常退出，另一方会通过 **onCoHostUserLeft** 或 **onUserExitBattle** 等事件收到通知，您可以根据这些事件来处理UI，例如提示"对方已掉线"并结束互动。
+**CoHostStore** 和 **BattleStore** 内部都有心跳和超时检测机制。如果一方异常退出，另一方会通过 **onCoHostUserLeft** 或 **onUserExitBattle** 等事件收到通知，您可以根据这些事件来处理 UI，例如提示“对方已掉线”并结束互动。
 
 ### 为什么 PK 分数只能通过 REST API 更新？
 
-因为 REST API  能同时满足 PK 分数的**安全性、实时性、扩展性**需求：
-- **防篡改保公平**：需鉴权 + 数据校验，每笔更新可追溯来源（例如礼物行为），杜绝手动改分、刷分，保障竞技公平；
+因为 REST API 能同时满足 PK 分数的**安全性、实时性、扩展性**需求：
+- **防篡改保公平**：需鉴权 + 数据校验，每笔更新可追溯来源（例如礼物行为），杜绝手动改分、刷分，保障竞技公平。
 
-- **多端实时同步**：用标准化格式（例如 JSON）快速对接礼物、PK、展示系统，确保主播 / 观众 / 后台分数实时一致，无延迟；
+- **多端实时同步**：用标准化格式（例如 JSON）快速对接礼物、PK、展示系统，确保主播 / 观众 / 后台分数实时一致，无延迟。
 
 - **灵活适配规则**：后端改配置（例如调整礼物对应分数、加成分数）即可适配业务变化，无需改前端，降低迭代成本。