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

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

@@ -1,4 +1,4 @@
-本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的  `AudioEffectStore` 和 `DeviceStore` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
+本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的 `AudioEffectStore` 和 `DeviceStore` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
 
 ## 核心功能
 
@@ -12,24 +12,24 @@
 - **混响效果**：模拟不同环境的声场效果，例如 KTV、金属声、低沉、洪亮等。
 
 ## 概念说明
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| `AudioChangerType` | `enum` | 变声效果枚举，例如，“小孩”，“男人”等。 |
-| `AudioReverbType` | `enum` | 混响效果枚举，例如，“ktv”，“礼堂”等。 |
-| `AudioEffectState` | `struct` | 代表音效模块的当前状态，通常用于 UI 渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。 |
-| `AudioEffectStore` | `class` | 代表音效模块**单例数据管理类**。通过它您可以调用修改音效接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
-| `DeviceState` | `struct` | 代表设备模块的当前状态，通常用于 UI 渲染。核心属性包括摄像头、麦克风的设备状态。 |
-| `DeviceStore` | `class` | 代表设备模块**单例数据管理类**。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
+| <code>AudioChangerType</code> | <code>enum</code> | 变声效果枚举，例如，“小孩”，“男人”等。 |
+| <code>AudioReverbType</code> | <code>enum</code> | 混响效果枚举，例如，“ktv”，“礼堂”等。 |
+| <code>AudioEffectState</code> | <code>struct</code> | 代表音效模块的当前状态，通常用于 UI 渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。 |
+| <code>AudioEffectStore</code> | <code>class</code> | 代表音效模块<strong>单例数据管理类</strong>。通过它您可以调用修改音效接口，当您调用接口后，相应的 <code>state</code> 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
+| <code>DeviceState</code> | <code>struct</code> | 代表设备模块的当前状态，通常用于 UI 渲染。核心属性包括摄像头、麦克风的设备状态。 |
+| <code>DeviceStore</code> | <code>class</code> | 代表设备模块<strong>单例数据管理类</strong>。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的 <code>state</code> 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 快速接入 集成 **AtomicXCore。**
+请参考 开播与收听 集成 **AtomicXCore。**
 
 ### 步骤2：获取 Store 实例
 
-`AudioEffectStore` 和 `DeviceStore`是单例对象，您可以直接通过 shared 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源 UI Demo 项目中的 [AudioEffectView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Component/AudioEffect/AudioEffectView.swift) 文件来了解完整的实现逻辑。
+`AudioEffectStore` 和 `DeviceStore` 是单例对象，您可以直接通过 shared 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源 UI Demo 项目中的 [AudioEffectView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Component/AudioEffect/AudioEffectView.swift) 文件来了解完整的实现逻辑。
 ``` swift
 import UIKit
 import AtomicXCore
@@ -50,11 +50,11 @@ let deviceStore = DeviceStore.shared
 >
 
 #### 实现方式:
-1. **开关耳返**：您可以使用`UISwitch`控件实现开关耳返功能。
+1. **开关耳返**：您可以使用 `UISwitch`  控件实现开关耳返功能。
 
-2. **设置耳返音量值**：您可以使用 `UISlider` 控件实现左右拖动滑块来调节音量的功能，并将 `UISlider` 的值映射成音量值，调用`setOutputVolume(_ volume:)。`请注意，该接口接收的参数范围是 `[0, 150]`，所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
+2. **设置耳返音量值**：您可以使用 `UISlider` 控件实现左右拖动滑块来调节音量的功能，并将 `UISlider` 的值映射成音量值，调用 `setOutputVolume(_ volume:)`。请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
 
-3. **监听状态更新UI**：您可以订阅实时的耳返状态值更新UI。
+3. **监听状态更新 UI**：您可以订阅实时的耳返状态值更新 UI。
 
 #### 代码示例:
 ``` swift
@@ -79,21 +79,21 @@ audioEffectStore.state
 ```
 
 #### setVoiceEarMonitorEnable 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `enable` | `Bool` | 是否开启耳返。<br>- true：开启<br>- false：关闭 |
+| <code>enable</code> | <code>Bool</code> | 是否开启耳返。<br>- true：开启<br>- false：关闭 |
 
 #### setVoiceEarMonitorVolume 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `volume` | `Int` | 耳返音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
+| <code>volume</code> | <code>Int</code> | 耳返音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
 
 ### 步骤4：实现人声音量调节
 
-当主播希望调节自己的上行采集音量大小时，调用`DeviceStore`的`setCaptureVolume(volume: )`方法传入音量值即可。
+当主播希望调节自己的上行采集音量大小时，调用 `DeviceStore` 的 `setCaptureVolume(volume: )` 方法传入音量值即可。
 
 #### 实现方式:
-1. **设置采集音量值**：您可以使用 `UISlider` 控件实现左右拖动滑块来调节音量的功能，并将 `UISlider` 的值映射成音量值后调用`setCaptureVolume(volume: 80)。`请注意，该接口接收的参数范围是 `[0, 150]`，所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
+1. **设置采集音量值**：您可以使用 `UISlider` 控件实现左右拖动滑块来调节音量的功能，并将 `UISlider` 的值映射成音量值后调用 `setCaptureVolume(volume: 80)`。请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
 
 2. **监听状态更新 UI**：您可以订阅实时的音量状态值更新 UI。
 
@@ -114,13 +114,13 @@ deviceStore.state
 ```
 
 #### setCaptureVolume 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `volume` | `Int` | 采集音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
+| <code>volume</code> | <code>Int</code> | 采集音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
 
 ### 步骤5：实现变声效果
 
-当主播希望改变自己的声音时，您可以调用 `setAudioChangerType(type:)`方法，传入相应的Type 枚举值即可切换效果。
+当主播希望改变自己的声音时，您可以调用 `setAudioChangerType(type:)` 方法，传入相应的 Type 枚举值即可切换效果。
 
 #### 示例代码：
 ``` swift
@@ -131,13 +131,14 @@ audioEffectStore.setAudioChangerType(type: .none)
 ```
 
 #### setAudioChangerType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `type` | `AudioChangerType` | 变声效果枚举。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`type`|`AudioChangerType`|变声效果枚举。|
 
 ### 步骤6：实现混响效果
 
-当主播希望给自己的声音添加混响效果时，您可以调用`setAudioReverbType(type:)` 方法，传入相应的Type 枚举值即可切换效果。
+当主播希望给自己的声音添加混响效果时，您可以调用 `setAudioReverbType(type:)` 方法，传入相应的 Type 枚举值即可切换效果。
 ``` swift
 // 示例：设置为“KTV”混响效果
 audioEffectStore.setAudioReverbType(type: .ktv)
@@ -146,22 +147,23 @@ audioEffectStore.setAudioReverbType(type: .none)
 ```
 
 #### setAudioReverbType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `type` | `AudioReverbType` | 混响效果枚举。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`type`|`AudioReverbType`|混响效果枚举。|
 
 ### 步骤7：重置音效设置
 
 > **重要：**
 >
 
-> AudioEffectStore和DeviceStore是单例，这意味着音效和设备设置是全局生效的，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
+> `AudioEffectStore` 和 `DeviceStore` 是单例，这意味着音效和设备设置是全局生效的，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
 >
 
 以下两种情况您可能需要重置音效设置：
 1. 当前直播间结束时，需要重置音效设置。
 
-2. 您需要提供“一键恢复”的功能，可以通过调用 store的`reset()` 方法实现。
+2. 您需要提供“一键恢复”的功能，可以通过调用 store 的 `reset()` 方法实现。
 
    ``` swift
    class YourMainViewController: UIViewController {
@@ -175,16 +177,17 @@ audioEffectStore.setAudioReverbType(type: .none)
 ## API 文档
 
 关于 [AudioEffectStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore) 和 [DeviceStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore) 及其相关类的所有公开接口、属性的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| AudioEffectStore | 音效管理：进行音效设置，并获取实时音效状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore/) |
-| DeviceStore | 设备管理：进行摄像头、麦克风操作，并获取实时设备状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|AudioEffectStore|音效管理：进行音效设置，并获取实时音效状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore/)|
+|DeviceStore |设备管理：进行摄像头、麦克风操作，并获取实时设备状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore)|
 
 ## 常见问题
 
 ### 音效和设备接口的调用时机有没有要求？
 
-没有限制。`AudioEffectStore`和`DeviceStore` 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。
+没有限制。`AudioEffectStore` 和 `DeviceStore` 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。
 
 ### **“人声音量” 和“耳返音量” 有什么区别？**
 
@@ -195,7 +198,7 @@ audioEffectStore.setAudioReverbType(type: .none)
 
 ### **新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？**
 
-`AudioEffectStore`和`DeviceStore`是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用`reset()`方法重置。
+`AudioEffectStore` 和 `DeviceStore` 是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用 `reset()` 方法重置。
 
 ### **为什么我开启了“耳返”，但是听不到自己的声音？**
 

package/resource/{doc → knowledge}/livekit/core-sdk/voice/ios/voice-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)
 
@@ -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/voice/ios/voice-co-guest-interaction.md

@@ -1,8 +1,8 @@
-**AtomicXCore** 提供了 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) 和 [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore) 模块，用于管理观众连麦的完整业务流程。您无需关心复杂的状态同步和信令交互，只需调用几个简单的方法，即可为您的直播添加强大的观众与主播音视频互动功能。本文档将指导您如何使用 `CoGuestStore `和 `LiveSeatStore`在 iOS 应用中快速实现语音连麦功能。
+**AtomicXCore** 提供了 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) 和 [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore) 模块，用于管理观众连麦的完整业务流程。您无需关心复杂的状态同步和信令交互，只需调用几个简单的方法，即可为您的直播添加强大的观众与主播音视频互动功能。本文档将指导您如何使用 `CoGuestStore `和 `LiveSeatStore` 在 iOS 应用中快速实现语音连麦功能。
 
 ## 核心场景
 
-`CoGuestStore`和`LiveSeatStore`支持以下几个主流的场景：
+`CoGuestStore` 和 `LiveSeatStore` 支持以下几个主流的场景：
 - **观众申请上麦**：观众主动发起连麦请求，主播在收到请求后进行同意或拒绝。
 
 - **主播邀请上麦**：主播可以主动向直播间内的任意一位观众发起连麦邀请。
@@ -13,7 +13,7 @@
 
 ### 步骤1：组件集成
 
-请参考 快速接入 集成 **AtomicXCore**。
+请参考 开播与收听 集成 **AtomicXCore**。
 
 ### 步骤2：实现观众申请上麦
 
@@ -56,12 +56,12 @@
          .sink { [weak self] event in
              if case let .onGuestApplicationResponded(isAccept, hostUser) = event {
                  if isAccept {
-                     print("主播 \(hostUser.userName) 同意了你的申请，准备上麦")
+                     print("主播 \(hostUser.userName) 同意了您的申请，准备上麦")
                      // 1. 打开麦克风
                      DeviceStore.shared.openLocalMicrophone(completion: nil)
                      // 2. 在此更新 UI，例如关闭申请按钮，显示连麦中的状态
                  } else {
-                     print("主播 \(hostUser.userName) 拒绝了你的申请")
+                     print("主播 \(hostUser.userName) 拒绝了您的申请")
                      // 弹窗提示用户申请被拒绝
                  }
              }
@@ -195,9 +195,9 @@
    // 在 hostEventPublisher 的订阅中添加
    if case let .onHostInvitationResponded(isAccept, guestUser) = event {
        if isAccept {
-           print("观众 \(guestUser.userName) 接受了你的邀请")
+           print("观众 \(guestUser.userName) 接受了您的邀请")
        } else {
-           print("观众 \(guestUser.userName) 拒绝了你的邀请")
+           print("观众 \(guestUser.userName) 拒绝了您的邀请")
        }
    }
    ```
@@ -263,9 +263,10 @@ seatStore.unmuteMicrophone(completion: nil) //解除静音
 ```
 
 #### unmuteMicrophone 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `completion` | `CompletionClosure?` | 操作完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`completion`|`CompletionClosure?`|操作完成后的回调。|
 
 ### 主播远程控制麦上用户开麦或关麦
 
@@ -320,16 +321,18 @@ seatStore.liveSeatEventPublisher
 ```
 
 #### closeRemoteMicrophone 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被操作的用户`userID`。 |
-| `completion` | `CompletionClosure?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被操作的用户 `userID`。|
+|`completion`|`CompletionClosure?`|请求完成后的回调。|
 
 #### openRemoteMicrophone 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被操作的用户`userID`。 |
-| `completion` | `CompletionClosure?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被操作的用户 `userID`。|
+|`completion`|`CompletionClosure?`|请求完成后的回调。|
 
 ### 主播将麦上用户踢下麦位
 
@@ -369,17 +372,18 @@ guestStore
 ```
 
 #### kickUserOutOfSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被踢下麦的用户`userID`。 |
-| `completion` | `CompletionClosure?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被踢下麦的用户 `userID`。|
+|`completion`|`CompletionClosure?`|请求完成后的回调。|
 
 ### 主播锁定和解锁麦位
 
 主播可以锁定或解锁某个麦位。
 
 #### 实现方式：
-1. **锁定麦位**：主播可调用 `lockSeat` 方法锁定指定索引的麦位，麦位被锁定后，观众无法通过 `applyForSeat` 或`takeSeat` 占用该麦位。
+1. **锁定麦位**：主播可调用 `lockSeat` 方法锁定指定索引的麦位，麦位被锁定后，观众无法通过 `applyForSeat` 或 `takeSeat` 占用该麦位。
 
 2. **解锁麦位**：调用 `unlockSeat` 可以解锁麦位，解锁后该麦位可以再次被占用。
 
@@ -401,25 +405,27 @@ seatStore.unlockSeat(seatIndex: 2) { result in
 ```
 
 #### lockSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `seatIndex` | `Int` | 需要锁定的麦位索引。 |
-| `completion` | `CompletionClosure?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`seatIndex`|`Int`|需要锁定的麦位索引。|
+|`completion`|`CompletionClosure?`|请求完成后的回调。|
 
 #### unlockSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `seatIndex` | `Int` | 需要解锁的麦位索引。 |
-| `completion` | `CompletionClosure?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`seatIndex`|`Int`|需要解锁的麦位索引。|
+|`completion`|`CompletionClosure?`|请求完成后的回调。|
 
 ### 移动麦位
 
-主播和普通上麦用户可以调用`moveUserToSeat(userID:targetIndex:policy:completion:)`移动麦位。
+主播和普通上麦用户可以调用 `moveUserToSeat(userID:targetIndex:policy:completion:)`移动麦位。
 
 #### 实现方式：
-1. **主播移动麦位**：主播可以调用此接口将任意用户移动到指定麦位。此时 `userID` 传入目标用户的 ID，`targetIndex`是目标麦位索引，`policy` 参数来指定如果目标麦位有人时的移动策略，详细参见 接口参数 说明。
+1. **主播移动麦位**：主播可以调用此接口将任意用户移动到指定麦位。此时 `userID` 传入目标用户的 ID，`targetIndex` 是目标麦位索引，`policy` 参数来指定如果目标麦位有人时的移动策略，详细参见 接口参数 说明。
 
-2. **普通上麦用户移动自己麦位**：普通上麦用户也可以调用此接口来移动自己。此时 `userID` 必须传入用户自己的 ID，`targetIndex` 传入想去的新麦位索引，此时`policy` 参数无效，如果目标麦位有人时会报错并停止移动。
+2. **普通上麦用户移动自己麦位**：普通上麦用户也可以调用此接口来移动自己。此时 `userID` 必须传入用户自己的 ID，`targetIndex` 传入想去的新麦位索引，此时 `policy` 参数无效，如果目标麦位有人时会报错并停止移动。
 
 #### 示例代码：
 ``` swift
@@ -435,27 +441,28 @@ seatStore.moveUserToSeat(userID: "userC",
 ```
 
 #### moveUserToSeat 接口参数：
-| **参数** | **类型** | **描述** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `userID` | `String` | 需要移麦的用户`userID`。 |
-| `targetIndex` | `Int` | 目标麦位索引。 |
-| `policy` | `MoveSeatPolicy?` | 目标麦位有人时的移动策略枚举：<br>- `abortWhenOccupied`：目标麦位有人时放弃移动（默认策略）​​<br>- `forceReplace`：强制替换目标麦位上的用户​​，被替换的用户将会被踢下麦<br>- `swapPosition`：与目标麦位用户交换位置​​。 |
-| `completion` | `CompletionClosure?` | 请求完成后的回调。 |
+| <code>userID</code> | <code>String</code> | 需要移麦的用户 <code>userID</code>。 |
+| <code>targetIndex</code> | <code>Int</code> | 目标麦位索引。 |
+| <code>policy</code> | <code>MoveSeatPolicy?</code> | 目标麦位有人时的移动策略枚举：<br>- <code>abortWhenOccupied</code>：目标麦位有人时放弃移动（默认策略）​​<br>- <code>forceReplace</code>：强制替换目标麦位上的用户​​，被替换的用户将会被踢下麦<br>- <code>swapPosition</code>：与目标麦位用户交换位置​​。 |
+| <code>completion</code> | <code>CompletionClosure?</code> | 请求完成后的回调。 |
 
 ## API 文档
 
 关于 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) 和 [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| CoGuestStore | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) |
-| LiveSeatStore | 麦位管理：静音/解除静音，锁定/解锁麦位，踢人下麦、远程控制麦上用户麦克风，麦列表状态监听 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|CoGuestStore|观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore)|
+|LiveSeatStore|麦位管理：静音/解除静音，锁定/解锁麦位，踢人下麦、远程控制麦上用户麦克风，麦列表状态监听|[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore)|
 
 ## 常见问题
 
 ### 语音房连麦和视频直播连麦的实现有何不同？
 
 两者的主要区别在于业务形态与 UI 展现：
-- 视频直播：核心是视频画面。您会使用 `LiveCoreView` 作为核心组件来渲染主播和连麦观众的视频流。UI 的重点是处理视频画面的布局、大小，以及通过 `VideoViewDelegate` 在视频流上添加挂件（如昵称、占位图）。您可以同时打开摄像头，麦克风。
+- 视频直播：核心是视频画面。您会使用 `LiveCoreView` 作为核心组件来渲染主播和连麦观众的视频流。UI 的重点是处理视频画面的布局、大小，以及通过 `VideoViewDelegate` 在视频流上添加挂件（例如昵称、占位图）。您可以同时打开摄像头，麦克风。
 
 - 语音房（语聊房）：核心是麦位网格。您不会使用 `LiveCoreView`，而是会基于 `LiveSeatStore` 的 `state`（特别是 `seatList`）来构建一个网格 UI（例如 `UICollectionView`）。UI 的重点是实时显示每个麦位 `SeatInfo` 的状态：是否有人、是否静音、是否被锁定 ，以及是否正在说话。您只需要打开麦克风。
 
@@ -485,8 +492,8 @@ seatStore.moveUserToSeat(userID: "userC",
 
    推荐的工作流程：您应该遵循“设备只开一次，麦上只用静音切换”的原则
 
-1. **上麦时**：当观众成功上麦，调用一次 `openLocalMicrophone`来启动设备。
+1. **上麦时**：当观众成功上麦，调用一次 `openLocalMicrophone` 来启动设备。
 
-2. **在麦上时**：用户在麦位上所有的“开麦”和“闭麦”操作，都应该调用 `unmuteMicrophone`和 `muteMicrophone`来控制上行音频流的通断。
+2. **在麦上时**：用户在麦位上所有的“开麦”和“闭麦”操作，都应该调用 `unmuteMicrophone` 和 `muteMicrophone` 来控制上行音频流的通断。
 
-3. **下麦时**：当用户下麦（例如调用 `disconnect`），调用`closeLocalMicrophone`来释放设备。
+3. **下麦时**：当用户下麦（例如调用 `disconnect`），调用 `closeLocalMicrophone` 来释放设备。