@tencentcloud/sdk-mcp 1.6.4 → 1.6.6

package/resource/knowledge/livekit/core-sdk/features/uni-app/base-beauty.md

@@ -0,0 +1,145 @@
+`BaseBeautyState` 是 `AtomicXCore` 中负责管理人像基础美颜效果的模块。通过它，您可以轻松为您的直播或通话应用添加自然的美颜效果。
+
+## 核心功能
+- **磨皮效果调节**：设置磨皮强度 (0-9)。
+
+- **美白效果调节**：设置美白强度 (0-9)。
+
+- **红润效果调节**：设置红润强度 (0-9)。
+
+- **效果重置**：一键恢复所有美颜参数至默认值。
+
+- **状态监听**：实时获取当前生效的美颜参数。
+
+## 实现步骤
+
+### 步骤1：组件集成
+
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
+
+### 步骤2：获取实例并监听状态
+
+获取 `BaseBeautyState` 的全局单例，并监听对应数据来实时获取当前的美颜参数状态。
+
+#### 实现方式
+1. **获取单例**：通过 `useBaseBeautyState` 来获取当前实例。
+
+2. **监听状态**：通过监听 `BaseBeautyState` 中的响应式数据来驱动 `UI` 的更新。
+
+#### 代码示例
+``` typescript
+import { useBaseBeautyState } from '@/uni_modules/tuikit-atomic-x/state/BaseBeautyState'
+import { watch } from 'vue';
+
+// 1. 通过 liveID 获取 BaseBeautyState 的实例
+const { whitenessLevel, ruddyLevel, smoothLevel } = useBaseBeautyState(liveID)
+
+// 2. 监听 whitenessLevel、ruddyLevel、smoothLevel 的实时变更，用于驱动 UI 变更
+watch( whitenessLevel, (newVal, oldVal) => {
+    console.log(newVal)
+})
+
+watch( ruddyLevel, (newVal, oldVal) => {
+    console.log(newVal)
+})
+
+watch( smoothLevel, (newVal, oldVal) => {
+    console.log(newVal)
+})
+```
+
+### 步骤3：设置美颜参数
+
+当用户拖动美颜滑块或点击预设按钮时，调用相应的接口设置美颜强度。
+
+#### 实现方式
+1. **获取强度值**：从 UI 控件获取用户设定的强度值。请注意，SDK 接口接收的参数范围是 `[0, 9]`，其中 `0` 表示关闭效果，`9` 表示效果最明显。您需要将 UI 控件的值映射到 `0 - 9` 的范围。
+
+2. **调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:)` 来设置磨皮、美白、红润的强度。
+
+#### 代码示例
+``` typescript
+import { useBaseBeautyState } from '@/uni_modules/tuikit-atomic-x/state/BaseBeautyState'
+
+// 1. 通过 liveID 获取 BaseBeautyState 的实例
+const { setSmoothLevel, setWhitenessLevel, setRuddyLevel } = useBaseBeautyState(liveID)
+
+// 2. 调用接口
+const setBeautyLevel = () => {
+    setSmoothLevel({
+      smoothLevel: 9
+    })
+    setWhitenessLevel({
+      whitenessLevel: 9
+    })
+    setRuddyLevel({
+      ruddyLevel: 9
+    })
+}
+```
+
+### 步骤4：重置美颜效果
+
+当用户点击“重置”或“关闭美颜”按钮时，将所有美颜参数恢复到默认值（通常是0）。
+
+#### 实现方式
+
+**调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:)` 并将参数设置为 0。
+
+#### 代码示例
+``` typescript
+import { useBaseBeautyState } from '@/uni_modules/tuikit-atomic-x/state/BaseBeautyState'
+
+// 1. 通过 liveID 获取 BaseBeautyState 的实例
+const { setSmoothLevel, setWhitenessLevel, setRuddyLevel } = useBaseBeautyState(liveID)
+
+// 2. 调用接口
+const setBeautyLevel = () => {
+    setSmoothLevel({
+      smoothLevel: 0
+    })
+    setWhitenessLevel({
+      whitenessLevel: 0
+    })
+    setRuddyLevel({
+      ruddyLevel: 0
+    })
+}
+```
+
+## 功能进阶
+
+### 基础美颜与高级美颜对比
+
+AtomicXCore 也提供了高级美颜支持，以满足不同场景的需求
+
+|**对比项**|**基础美颜 (BaseBeautyState)**|**高级美颜 (TEBeautyKit 需额外集成)**|
+|---------|---------|---------|
+|核心功能|磨皮、美白、红润。|包含基础美颜，并增加 V 脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果。|
+|计费|免费（包含在 AtomicXCore 授权内）。|付费（需要额外购买腾讯特效 SDK License） 。|
+|集成方式|默认内置，直接使用 `BaseBeautyState`。|需要额外集成 `TEBeautyKit` 组件并进行鉴权。|
+|推荐场景|对美颜要求不高，需要快速实现基础美颜功能的场景。|对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景。|
+
+### 集成高级美颜
+
+如果您需要使用高级美颜功能，请参考 [高级美颜](https://cloud.tencent.com/document/product/616/102495) 文档进行集成。集成并成功鉴权 `TEBeautyKit` 后，您可以通过 `TEBeautyKit` 提供的接口来控制所有美颜效果。
+
+## API 文档
+
+关于 [BaseBeautyState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-BaseBeautyState) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 AtomicXCore 框架的官方 API 文档。本指南使用到的相关 Store 如下：
+
+|**State**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|BaseBeautyState|基础美颜：调节磨皮 / 美白 / 红润（0-9 级），重置美颜状态，同步效果参数。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-BaseBeautyState)|
+|DeviceState|音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-DeviceState)|
+
+## 常见问题
+
+### 我设置了美颜参数，为什么没有效果？
+
+请检查以下几点：
+1. **摄像头是否开启**：必须先成功打开摄像头，美颜效果才能应用到视频流上。
+
+2. **是否使用了高级美颜**：如果您集成了 `TEBeautyKit` (高级美颜)，请确保您使用的是 `TEBeautyKit` 提供的接口来调节美颜。
+
+3. **参数范围**：如果您使用的是基础美颜，请确认您传入的强度值在有效的范围内 (`0` 到 `9` 之间的 float 值)。

package/resource/knowledge/livekit/core-sdk/{voice/uni-app/voice-gift.md → features/uni-app/gift.md}

@@ -16,7 +16,6 @@
 
 > **说明：**
 >
-
 > 使用**礼物系统**要求开通TUILiveKit **多人连麦版**、**大规模直播版**，不同套餐中可配置的礼物数量有所不同，详细参见 功能与计费说明 中的**礼物系统**说明。
 >
 
@@ -33,7 +32,7 @@
 
 2. **订阅事件**：使用 `addGiftListener` 以订阅 `'onReceiveGift'`事件。
 
-3. **监听状态**：监听 响应式数据`usableGifts `礼物列表，来驱动 `UI` 更新。
+3. **监听状态**：监听 响应式数据`usableGifts` 礼物列表，来驱动 `UI` 更新。
 
 #### 代码示例:
 ``` typescript
@@ -68,7 +67,7 @@ watch(usableGifts, (newVal, oldVal) => {
    |`extensionInfo`|`[string: string]`|扩展信息字段。|
    |`giftList`|`[string]`|该分类下包含的 Gift 礼物对象数组。|
 
-- `Gift`** 参数说明**
+- `Gift` **参数说明**
 
    |**参数**|**类型**|**描述**|
    |---------|---------|---------|
@@ -166,7 +165,7 @@ const handleSendGift = (giftID: string) => {
 
 您需要自定义直播间可用的礼物种类、分类、名称、图标、价格以及动画效果，以满足运营需求和品牌特色。
 
-#### **实现方式 **
+#### **实现方式**
 1. **服务端配置**：使用 LiveKit 服务端 REST API 管理礼物信息、分类、多语言等。请参考 [礼物配置指引文档](https://cloud.tencent.com/document/product/647/121321)。
 
 2. **客户端拉取**：在客户端调用 `refreshUsableGifts` 获取配置数据。
@@ -234,7 +233,7 @@ const handleSendGift = (giftID: string) => {
 本章节主要演示基础方案的集成。如果您选择高级方案，请参考 [TCEffectPlayer 集成指引](https://cloud.tencent.com/document/product/616/116474)。
 
 #### 基础方案实现：使用 SVGAPlayer
-1. **使用 SVGAPlayer**：在您的项目中，引入 `svga-player `组件
+1. **使用 SVGAPlayer**：在您的项目中，引入 `svga-player` 组件
 
    ``` typescript
    <svga-player :url="xxx"></svga-player>
@@ -275,13 +274,13 @@ onMounted(() => {
 当有用户发送礼物时，不仅播放动画，同时在公屏弹幕区域显示一条系统消息，例如：“【观众昵称】送出了【礼物名称】x【数量】”，让所有观众都能看到。
 
 #### 实现方式
-1. **监听事件: **使用 `addGiftListener` 以订阅 `'onReceiveGift'`事件。
+1. **监听事件:** 使用 `addGiftListener` 以订阅 `'onReceiveGift'`事件。
 
 2. **获取弹幕 State**：使用 `useBarrageState(liveID)`获取与当前房间绑定的实例。
 
 3. **拼接消息**：创建一条消息结构体，设置 `messageType = 'text'`，textContent 为拼接好的字符串（例如 “[`sender.userName`] 送出了 [`gift.name`] x [`count`]”）。
 
-4. **本地插入**：调用 `barrageState`的`appendLocalTip(message: giftTip) `将消息插入本地列表。
+4. **本地插入**：调用 `barrageState`的`appendLocalTip(message: giftTip)` 将消息插入本地列表。
 
 #### 代码示例
 ``` typescript

package/resource/knowledge/livekit/core-sdk/{voice/uni-app/voice-room-list.md → features/uni-app/live-list.md}

@@ -399,7 +399,7 @@ const handleJoinLive = (live: any) => {
 
 #### 实现方式
 
-主播端将当前商品的结构化信息（建议使用 **JSON **格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需监听 `currentLive` 的变化，一旦发现 `metaData` 的 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
+主播端将当前商品的结构化信息（建议使用 **JSON** 格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需监听 `currentLive` 的变化，一旦发现 `metaData` 的 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
 
 #### 代码示例
 ``` typescript

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

@@ -331,7 +331,6 @@
 
 > **提示：**
 >
-
 > 您也可以参考 TUILiveKit 开源项目中的 [widgets](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/audienceview/view/coguest/widgets) 目录下文件来了解完整的实现逻辑。
 >
 
@@ -457,10 +456,10 @@
 | --- | --- | --- |
 | <code>seatInfo</code> | <code>SeatFullInfo?</code> | 麦位信息对象，包含麦上用户的详细信息。 |
 | <code>seatInfo.userId</code> | <code>String</code> | 麦上用户的 ID。 |
-| <code>seatInfo.userName</code> | <code>String </code> | 麦上用户的昵称。 |
+| <code>seatInfo.userName</code> | <code>String</code> | 麦上用户的昵称。 |
 | <code>seatInfo.userAvatar</code> | <code>String</code> | 麦上用户的头像 URL。 |
 | <code>seatInfo.userMicrophoneStatus</code> | <code>DeviceStatus</code> | 麦上用户的麦克风状态。 |
-| <code>seatInfo.userCameraStatus </code> | <code>DeviceStatus</code> | 麦上用户的摄像头状态。 |
+| <code>seatInfo.userCameraStatus</code> | <code>DeviceStatus</code> | 麦上用户的摄像头状态。 |
 | <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举<br>- <code>FOREGROUND</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br>- <code>BACKGROUND</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ## API 文档

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

@@ -138,7 +138,7 @@
 #### 挑战方（例如主播 A）实现
 1. **发起 PK 挑战**
 
-   当主播 A 点击** PK** 按钮时，调用 `requestBattle` 方法。
+   当主播 A 点击 **PK** 按钮时，调用 `requestBattle` 方法。
 
    ``` kotlin
    // AnchorAActivity 的一部分
@@ -249,7 +249,6 @@
 
    > **提示：**
    >
-
    > 您也可以参考 TUILiveKit 开源项目中的 [widgets](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/cohost/widgets) 目录下文件来了解完整的实现逻辑。
    >
 
@@ -361,7 +360,7 @@
 | <code>seatInfo.userName</code> | <code>String</code> | 麦上用户的昵称。 |
 | <code>seatInfo.userAvatar</code> | <code>String</code> | 麦上用户的头像 URL。 |
 | <code>seatInfo.userMicrophoneStatus</code> | <code>DeviceStatus</code> | 麦上用户的麦克风状态。 |
-| <code>seatInfo.userCameraStatus </code> | <code>DeviceStatus</code> | 麦上用户的摄像头状态。 |
+| <code>seatInfo.userCameraStatus</code> | <code>DeviceStatus</code> | 麦上用户的摄像头状态。 |
 | <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举<br>- <code>FOREGROUND</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br>- <code>BACKGROUND</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ### 实现 PK 用户视图的分数展示
@@ -496,7 +495,6 @@
 
 > **重要说明：**
 >
-
 > LiveKit 后台的 PK 分数系统采用纯数值计算和累加机制，所以您需要根据自身的运营策略和业务需求，在调用更新接口前完成 PK 分数的计算，您可以参考如下的 PK 分数计算示例：
 >
 

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

@@ -1,4 +1,4 @@
-本文档将帮助您使用 **AtomicXCore SDK **的核心组件 [LiveCoreView](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-live-core-view/index.html)，快速构建一个包含主播开播和观众观看功能的基础直播 App。
+本文档将帮助您使用 **AtomicXCore SDK** 的核心组件 [LiveCoreView](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.view/-live-core-view/index.html)，快速构建一个包含主播开播和观众观看功能的基础直播 App。
 
 ### **核心功能**
 
@@ -18,23 +18,22 @@
 
 【build.gradle.kts】
 ``` java
-implementation("io.trtc.uikit:atomicx-core:4.0.0.110")
+implementation("io.trtc.uikit:atomicx-core:latest.release")
 api("com.tencent.imsdk:imsdk-plus:8.9.7511")
 ```
 
 【build.gradle】
 ``` java
-implementation 'io.trtc.uikit:atomicx-core:4.0.0.110'
+implementation 'io.trtc.uikit:atomicx-core:latest.release'
 api "com.tencent.imsdk:imsdk-plus:8.9.7511"
 ```
 
 ### 步骤3：实现登录逻辑
 
-在您的项目中调用 `LoginStore.shared.login` 完成登录，**这是使用 **`AtomicXCore`** 所有功能的关键前提**。
+在您的项目中调用 `LoginStore.shared.login` 完成登录，**这是使用** `AtomicXCore` **所有功能的关键前提**。
 
 > **重要：**
 >
-
 > 推荐在您 App 自身的用户账户登录成功后，再调用 LoginStore.shared.login，以确保登录业务逻辑的清晰和一致。
 >
 
@@ -74,7 +73,7 @@ class MainActivity : AppCompatActivity() {
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
 | sdkAppId | Int | 从 <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>。 |
+| 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>。 |
 
 ## 搭建基础直播间
@@ -85,7 +84,6 @@ class MainActivity : AppCompatActivity() {
 
 > **提示：**
 >
-
 > 主播开播推流的业务代码，您也可以参考 TUILiveKit 开源项目中的 [VideoLiveAnchorActivity.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/livestream/VideoLiveAnchorActivity.kt) 文件来了解完整的实现逻辑。
 >
 
@@ -203,7 +201,7 @@ class MainActivity : AppCompatActivity() {
    }
    ```
 
-   `LiveInfo`** 参数说明**
+   `LiveInfo` **参数说明**
 
 | <strong>参数名</strong> | <strong>类型</strong> | <strong>属性</strong> | <strong>描述</strong> |
 | --- | --- | --- | --- |
@@ -267,7 +265,6 @@ class MainActivity : AppCompatActivity() {
 
 > **提示：**
 >
-
 > 观众进房拉流的业务代码，您也可以参考 TUILiveKit 开源项目中的 [VideoLiveAudienceActivity.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/livestream/VideoLiveAudienceActivity.kt) 文件来了解完整的实现逻辑。
 >
 

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

@@ -306,7 +306,6 @@
 
    > **提示：**
    >
-
    > 您也可以参考 TUILiveKit 开源项目中的 [co_host_foreground_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/live_stream/features/decorations/co_host/co_host_foreground_widget.dart) 和 [co_host_background_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/live_stream/features/decorations/co_host/co_host_background_widget.dart) 文件来了解完整的实现逻辑。
    >
 
@@ -797,11 +796,10 @@ class _FullCustomLiveWidgetState extends State<FullCustomLiveWidget> {
 
 > **重要说明：**
 >
-
 > LiveKit 后台的 PK 分数系统采用纯数值计算和累加机制，所以您需要根据自身的运营策略和业务需求，调用更新接口前完成 PK 分数的计算，您可以参考如下的 PK 分数计算示例：
 >
 
-|** 礼物类型**|**分数计算规则**|**示例**|
+| **礼物类型**|**分数计算规则**|**示例**|
 |---------|---------|---------|
 |​基础礼物​|礼物价值 × 5|10元礼物 → 50分|
 |​中级礼物​|礼物价值 × 8|50元礼物 → 400分|

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

@@ -63,7 +63,6 @@ end
 
 > **重要：**
 >
-
 > 推荐在您 App 自身的用户账户登录成功后，再调用 LoginStore.shared.login，以确保登录业务逻辑的清晰和一致。
 >
 
@@ -130,7 +129,6 @@ void main() async {
 
    > **注意：**
    >
-
    > 此步骤对于预览至关重要。只有打开设备，后续的 VideoView 才有画面可渲染。
    >
 
@@ -360,7 +358,6 @@ void main() async {
 
 > **提示：**
 >
-
 > 观众进房拉流的业务代码，您也可以参考 TUILiveKit 开源项目中的 [audience_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/live_stream/features/audience/audience_widget.dart) 文件来了解完整的实现逻辑。
 >
 
@@ -370,11 +367,9 @@ void main() async {
 
    > **注意：**
    >
-
    > **必须确保 LiveCoreWidget 在调用 joinLive() 之前已经完成初始化并处于渲染树中。**
    >
-
-   > **原理分析：**`LiveCoreWidget` 在 `initState` 中会执行 `controller.init() `以注册对 `currentLive` 信息的监听。如果先调用` joinLive()` 导致房间信息更新，而此时 `Widget` 尚未渲染（监听器未注册），则无法触发内部的自动拉流逻辑，导致画面黑屏。
+   > **原理分析：**`LiveCoreWidget` 在 `initState` 中会执行 `controller.init()` 以注册对 `currentLive` 信息的监听。如果先调用 `joinLive()` 导致房间信息更新，而此时 `Widget` 尚未渲染（监听器未注册），则无法触发内部的自动拉流逻辑，导致画面黑屏。
    >
 
    ``` java

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

@@ -252,7 +252,6 @@
 
 > **提示：**
 >
-
 > 您也可以参考 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) 文件来了解完整的实现逻辑。
 >
 
@@ -342,10 +341,10 @@
 | --- | --- | --- |
 | <code>seatInfo</code> | <code>TUISeatFullInfo</code> | 麦位信息对象，包含麦上用户的详细信息。 |
 | <code>seatInfo.userID</code> | <code>String?</code> | 麦上用户的 ID。 |
-| <code>seatInfo.userName</code> | <code>String? </code> | 麦上用户的昵称。 |
+| <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>seatInfo.userCameraStatus</code> | <code>TUIDeviceStatus</code> | 麦上用户的摄像头状态。 |
 | <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举。<br><code>.foreground</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br><code>.background</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ## API 文档

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

@@ -208,7 +208,6 @@
 
    > **提示：**
    >
-
    > 您也可以参考 TUILiveKit 开源项目中的 [AnchorCoHostView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Features/AnchorView/View/VideoWidgets/AnchorCoHostView.swift) 和 [AnchorEmptySeatView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Features/AnchorView/View/VideoWidgets/AnchorEmptySeatView.swift) 文件来了解完整的实现逻辑。
    >
 
@@ -296,10 +295,10 @@
 | --- | --- | --- |
 | <code>seatInfo</code> | <code>TUISeatFullInfo</code> | 麦位信息对象，包含麦上用户的详细信息。 |
 | <code>seatInfo.userId</code> | <code>String?</code> | 麦上用户的 ID。 |
-| <code>seatInfo.userName</code> | <code>String? </code> | 麦上用户的昵称。 |
+| <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>seatInfo.userCameraStatus</code> | <code>TUIDeviceStatus</code> | 麦上用户的摄像头状态。 |
 | <code>viewLayer</code> | <code>ViewLayer</code> | 视图层级枚举：<br>- <code>.foreground</code> 表示前景挂件视图，始终显示在视频画面的最上层。<br>- <code>.background</code> 表示背景挂件视图，位于前景视图下层，仅在对应用户没有视频流（例如未开摄像头）的情况下显示，通常用于展示用户的默认头像或占位图。 |
 
 ### 实现 PK 用户视图的分数展示
@@ -429,7 +428,6 @@
 
 > 重要说明：
 >
-
 > LiveKit 后台的 PK 分数系统采用纯数值计算和累加机制，所以您需要根据自身的运营策略和业务需求，调用更新接口前完成 PK 分数的计算，您可以参考如下的 PK 分数计算示例：
 >
 
@@ -453,7 +451,7 @@
 
 3. **PK 分数更新​**：您的后台服务调用 修改 PK 分数 接口，向 LiveKit 后台更新 PK 分数。
 
-4. **LiveKit****后台 同步客户端**​：LiveKit 后台自动将更新后的 PK 分数同步到所有客户端。
+4. **LiveKit** **后台 同步客户端**​：LiveKit 后台自动将更新后的 PK 分数同步到所有客户端。
 
 #### 涉及的 REST API 接口
 

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

@@ -1,4 +1,4 @@
-本文档将帮助您使用 **AtomicXCore SDK **的核心组件 [LiveCoreView](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview)，快速构建一个包含主播开播和观众观看功能的基础直播 App。
+本文档将帮助您使用 **AtomicXCore SDK** 的核心组件 [LiveCoreView](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview)，快速构建一个包含主播开播和观众观看功能的基础直播 App。
 
 ## **核心功能**
 
@@ -20,7 +20,7 @@
      pod 'AtomicXCore', '~> 4.0'
    end
    ```
-2. **配置工程权限:  **请在应用的 `Info.plist` 文件中添加相机和麦克风的使用权限说明。
+2. **配置工程权限:**  请在应用的 `Info.plist` 文件中添加相机和麦克风的使用权限说明。
 
    ``` ruby
    <key>NSCameraUsageDescription</key>
@@ -31,11 +31,10 @@
 
 ### 步骤3：实现登录逻辑
 
-在您的项目中调用 `LoginStore.shared.login` 完成登录，**这是使用 **`AtomicXCore`** 所有功能的关键前提**。
+在您的项目中调用 `LoginStore.shared.login` 完成登录，**这是使用** `AtomicXCore` **所有功能的关键前提**。
 
 > **重要：**
 >
-
 > 推荐在您 App 自身的用户账户登录成功后，再调用 LoginStore.shared.login，以确保登录业务逻辑的清晰和一致。
 >
 
@@ -62,7 +61,7 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
 | 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>。 |
+| 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>。 |
 
 ## 搭建基础直播间
@@ -73,7 +72,6 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
 
 > **提示：**
 >
-
 > 主播开播推流的业务代码，您也可以参考 TUILiveKit 开源项目中的 [TUILiveRoomAnchorViewController.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/LiveStream/TUILiveRoomAnchorViewController.swift) 文件来了解完整的实现逻辑。
 >
 
@@ -169,7 +167,7 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
    }
    ```
 
-   `LiveInfo`** 参数说明:**
+   `LiveInfo` **参数说明:**
 
    |**参数名**|**类型**|**属性**|**描述**|
    |---------|---------|---------|---------|
@@ -219,7 +217,6 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
 
 > **提示：**
 >
-
 > 观众进房拉流的业务代码，您也可以参考 TUILiveKit 开源项目中的 [TUILiveRoomAudienceViewController.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/LiveStream/TUILiveRoomAudienceViewController.swift) 文件来了解完整的实现逻辑。
 >
 
@@ -420,9 +417,9 @@ class YourAudienceViewController: UIViewController {
 - **检查网络**：请检查设备网络连接是否正常。
 
 ### 主播端打开摄像头后，开播后可以看到本地视频预览画面，开播前视频预览是黑屏？
-- **检查主播端**：请检查主播推流视图 `LiveCoreView` 的 `viewType`是否配置为 `.pushView`。
+- **检查主播端**：请检查主播推流视图 `LiveCoreView` 的 `viewType` 是否配置为 `.pushView`。
 
-- **检查观众端**：请检查观众拉流视图 `LiveCoreView` 的 `viewType`是否配置为 `.playView`。
+- **检查观众端**：请检查观众拉流视图 `LiveCoreView` 的 `viewType` 是否配置为 `.playView`。
 
 ### rsync 因权限不足导致依赖三方库资源拷贝失败