npm - @tencentcloud/sdk-mcp - Versions diffs - 1.3.9 → 1.4.0 - Mend

@tencentcloud/sdk-mcp 1.3.9 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (510) hide show

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

@@ -1,8 +1,5 @@
 本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的  `AudioEffectStore` 和 `DeviceStore` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100032603567/5c80ff5db57311f085a55254007c27c5.png)
 ## 核心功能
 通过组合 `AudioEffectStore` 和 `DeviceStore`，您将能实现以下核心功能：
@@ -14,72 +11,21 @@
 - **混响效果**：模拟不同环境的声场效果，例如 KTV、金属声、低沉、洪亮等。
 ## 概念说明
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**核心概念**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**核心职责与描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`AudioChangerType`</td>
-<td rowspan="1" colSpan="1" >`enum`</td>
-<td rowspan="1" colSpan="1" >变声效果枚举，例如，“小孩”，“男人”等。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" ><br>`AudioReverbType`<br></td>
-<td rowspan="1" colSpan="1" >`enum`</td>
-<td rowspan="1" colSpan="1" >混响效果枚举，例如，“ktv”，“礼堂”等。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`AudioEffectState`</td>
-<td rowspan="1" colSpan="1" >`struct`</td>
-<td rowspan="1" colSpan="1" >代表音效模块的当前状态，通常用于 UI 渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`AudioEffectStore`</td>
-<td rowspan="1" colSpan="1" >`class`</td>
-<td rowspan="1" colSpan="1" >代表音效模块**单例数据管理类**。通过它您可以调用修改音效接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`DeviceState`</td>
-<td rowspan="1" colSpan="1" >`struct`</td>
-<td rowspan="1" colSpan="1" >代表设备模块的当前状态，通常用于 UI 渲染。核心属性包括摄像头、麦克风的设备状态。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`DeviceStore`</td>
-<td rowspan="1" colSpan="1" >`class`</td>
-<td rowspan="1" colSpan="1" >代表设备模块**单例数据管理类**。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。</td>
-</tr>
-</table>
+| **核心概念** | **类型** | **核心职责与描述** |
+| --- | --- | --- |
+| `AudioChangerType` | `enum` | 变声效果枚举，例如，“小孩”，“男人”等。 |
+| `AudioReverbType` | `enum` | 混响效果枚举，例如，“ktv”，“礼堂”等。 |
+| `AudioEffectState` | `struct` | 代表音效模块的当前状态，通常用于 UI 渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。 |
+| `AudioEffectStore` | `class` | 代表音效模块**单例数据管理类**。通过它您可以调用修改音效接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
+| `DeviceState` | `struct` | 代表设备模块的当前状态，通常用于 UI 渲染。核心属性包括摄像头、麦克风的设备状态。 |
+| `DeviceStore` | `class` | 代表设备模块**单例数据管理类**。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
 ## 实现步骤
 ### 步骤1：组件集成
-请参考 [快速接入](https://write.woa.com/document/192834898445422592) 集成 **AtomicXCore。**
+请参考 快速接入 集成 **AtomicXCore。**
 ### 步骤2：获取 Store 实例
@@ -98,11 +44,10 @@ let deviceStore = DeviceStore.shared
 耳返功能允许用户实时监听自己的麦克风声音，可以通过调用本节介绍的接口管理耳返功能。
 > **注意：**
->
+>
 > 耳返功能通常需要连接耳机才能正常工作。
->
+>
 #### 实现方式:
 1. **开关耳返**：您可以使用`UISwitch`控件实现开关耳返功能。
@@ -111,7 +56,6 @@ let deviceStore = DeviceStore.shared
 3. **监听状态更新UI**：您可以订阅实时的耳返状态值更新UI。
 #### 代码示例:
 ``` swift
 // 1. 开启耳返
@@ -135,44 +79,14 @@ audioEffectStore.state
 ```
 #### setVoiceEarMonitorEnable 接口参数
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数名**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`enable`</td>
-<td rowspan="1" colSpan="1" >`Bool`</td>
-<td rowspan="1" colSpan="1" >是否开启耳返。<br>- true：开启<br>- false：关闭</td>
-</tr>
-</table>
+| **参数名** | **类型** | **描述** |
+| --- | --- | --- |
+| `enable` | `Bool` | 是否开启耳返。<br>- true：开启<br>- false：关闭 |
 #### setVoiceEarMonitorVolume 接口参数
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数名**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`volume`</td>
-<td rowspan="1" colSpan="1" >`Int`</td>
-<td rowspan="1" colSpan="1" >耳返音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100</td>
-</tr>
-</table>
+| **参数名** | **类型** | **描述** |
+| --- | --- | --- |
+| `volume` | `Int` | 耳返音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
 ### 步骤4：实现人声音量调节
@@ -183,7 +97,6 @@ audioEffectStore.state
 2. **监听状态更新 UI**：您可以订阅实时的音量状态值更新 UI。
 #### 示例代码：
 ``` swift
 // 1. 调节音量
@@ -201,24 +114,9 @@ deviceStore.state
 ```
 #### setCaptureVolume 接口参数
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数名**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`volume`</td>
-<td rowspan="1" colSpan="1" >`Int`</td>
-<td rowspan="1" colSpan="1" >采集音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100</td>
-</tr>
-</table>
+| **参数名** | **类型** | **描述** |
+| --- | --- | --- |
+| `volume` | `Int` | 采集音量大小。<br>- 取值范围： [0, 150]<br>- 默认值：100 |
 ### 步骤5：实现变声效果
@@ -233,24 +131,9 @@ audioEffectStore.setAudioChangerType(type: .none)
 ```
 #### setAudioChangerType 接口参数
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数名**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`type`</td>
-<td rowspan="1" colSpan="1" >`AudioChangerType`</td>
-<td rowspan="1" colSpan="1" >变声效果枚举。</td>
-</tr>
-</table>
+| **参数名** | **类型** | **描述** |
+| --- | --- | --- |
+| `type` | `AudioChangerType` | 变声效果枚举。 |
 ### 步骤6：实现混响效果
@@ -263,33 +146,17 @@ audioEffectStore.setAudioReverbType(type: .none)
 ```
 #### setAudioReverbType 接口参数
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数名**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`type`</td>
-<td rowspan="1" colSpan="1" >`AudioReverbType`</td>
-<td rowspan="1" colSpan="1" >混响效果枚举。</td>
-</tr>
-</table>
+| **参数名** | **类型** | **描述** |
+| --- | --- | --- |
+| `type` | `AudioReverbType` | 混响效果枚举。 |
 ### 步骤7：重置音效设置
 > **重要：**
->
+>
 > AudioEffectStore和DeviceStore是单例，这意味着音效和设备设置是全局生效的，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
->
+>
 以下两种情况您可能需要重置音效设置：
 1. 当前直播间结束时，需要重置音效设置。
@@ -297,7 +164,7 @@ audioEffectStore.setAudioReverbType(type: .none)
 2. 您需要提供“一键恢复”的功能，可以通过调用 store的`reset()` 方法实现。
    ``` swift
-   class YourMainViewController: UIViewController {
+   class YourMainViewController: UIViewController {
        func reset() {
            AudioEffectStore.shared.reset()
            DeviceStore.shared.reset()
@@ -308,32 +175,10 @@ 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 文档。
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Store/Component**</td>
-<td rowspan="1" colSpan="1" >**功能描述**</td>
-<td rowspan="1" colSpan="1" >**API 文档**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >AudioEffectStore</td>
-<td rowspan="1" colSpan="1" >音效管理：进行音效设置，并获取实时音效状态。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore/)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >DeviceStore </td>
-<td rowspan="1" colSpan="1" >设备管理：进行摄像头、麦克风操作，并获取实时设备状态。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore)</td>
-</tr>
-</table>
+| **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) |
 ## 常见问题
@@ -348,7 +193,6 @@ audioEffectStore.setAudioReverbType(type: .none)
 - **耳返音量 (EarMonitorVolume)：**通过 `AudioEffectStore.setVoiceEarMonitorVolume()`** 设置。它只**决定了**您自己**在耳机里听到的监听声音大小，**不会**影响观众。
 ### **新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？**
 `AudioEffectStore`和`DeviceStore`是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用`reset()`方法重置。
@@ -362,12 +206,6 @@ audioEffectStore.setAudioReverbType(type: .none)
 3. **麦克风是否开启**：确认 `DeviceStore` 中的麦克风是开启状态（即已调用 `openLocalMicrophone`）。
 ### **变声效果 和混响效果 可以同时生效吗？**
 可以。`AudioChangerType` 和 `AudioReverbType` 是可以叠加生效的。例如，您可以同时设置 `.littleGirl` 变声和 `.ktv` 混响。

package/resource/doc/livekit/{voice → core-sdk/voice}/ios/voice-barrage.md RENAMED Viewed

@@ -1,8 +1,5 @@
 本篇文档旨在指导 iOS 开发者如何使用 `AtomicXCore` 框架中的 `BarrageStore` 模块，为您的直播应用快速集成功能丰富、性能卓越的弹幕系统。
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182232/a942e665b63f11f0a6c652540044a08e.png)
 ## 核心功能
 `BarrageStore` 为您的直播应用提供了一套完整的弹幕解决方案，核心功能包括：
@@ -14,50 +11,20 @@
 - 在本地消息列表中插入系统提示（例如，“欢迎 XX 进入直播间”）。
 ## 核心概念解析
 在开始集成之前，我们先通过下表了解一下 BarrageStore 相关的几个核心概念：
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**核心概念**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**核心职责与描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >[Barrage](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barrage)</td>
-<td rowspan="1" colSpan="1" >`struct`</td>
-<td rowspan="1" colSpan="1" >代表一条弹幕消息的数据模型。它包含了发送者信息 (`sender`)、消息内容 (`textContent` 或 `data`)、消息类型 (`messageType`) 等所有关键信息。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >[BarrageState](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestate)</td>
-<td rowspan="1" colSpan="1" >`struct`</td>
-<td rowspan="1" colSpan="1" >代表弹幕模块的当前状态。其核心属性 `messageList` 是一个 `[Barrage]` 数组，按时间顺序存储了当前直播间的所有弹幕消息，是UI渲染的数据源。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >[BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)</td>
-<td rowspan="1" colSpan="1" >`class`</td>
-<td rowspan="1" colSpan="1" >这是与弹幕功能交互的核心管理类。通过它，您可以发送消息 (`sendTextMessage`, `sendCustomMessage`)，并通过订阅其 `state` 属性来接收和监听所有弹幕消息的更新。</td>
-</tr>
-</table>
+| **核心概念** | **类型** | **核心职责与描述** |
+| --- | --- | --- |
+| [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：组件集成
-请参考 [开始直播](https://write.woa.com/document/192834898445422592) 集成 **AtomicXCore**，完成接入。
+请参考 开始直播 集成 **AtomicXCore**，完成接入。
 ### 步骤2：初始化并监听弹幕
@@ -68,23 +35,23 @@ import AtomicXCore // 确保导入核心库
 import Combine     // 用于处理响应式编程
 class BarrageManager {
     private let liveId: String
     private let barrageStore: BarrageStore
     private var cancellables = Set<AnyCancellable>()
     // 对外暴露【全量】消息列表的发布者，方便UI层订阅
     let messagesPublisher = PassthroughSubject<[Barrage], Never>()
     init(liveId: String) {
         self.liveId = liveId
         // 1. 通过 liveId 获取 BarrageStore 的单例
         self.barrageStore = BarrageStore.create(liveID: liveId)
         // 2. 初始化后立即开始监听弹幕消息
         subscribeToBarrageUpdates()
     }
     private func subscribeToBarrageUpdates() {
         barrageStore.state
             .subscribe() // 订阅 BarrageState 的所有变化
@@ -104,7 +71,7 @@ class BarrageManager {
 调用 `sendTextMessage` 方法向直播间内的所有用户广播一条纯文本消息。
 ``` swift
 extension BarrageManager {
     /// 发送一条文本弹幕
     func sendTextMessage(text: String) {
         // 建议：增加非空校验，避免发送无效消息
@@ -112,7 +79,7 @@ extension BarrageManager {
             print("弹幕内容不能为空")
             return
         }
         // 调用核心API发送消息
         barrageStore.sendTextMessage(text: text, extensionInfo: nil) { result in
             // 在回调中处理发送结果，例如给用户提示
@@ -128,40 +95,11 @@ extension BarrageManager {
 ```
 #### **接口参数**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`text`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >要发送的文本内容。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`extensionInfo`</td>
-<td rowspan="1" colSpan="1" >`[String: String]?`</td>
-<td rowspan="1" colSpan="1" >附加的扩展信息，可用于业务自定义。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`completion`</td>
-<td rowspan="1" colSpan="1" >`CompletionClosure?`</td>
-<td rowspan="1" colSpan="1" >发送完成后的回调，包含成功或失败的结果。</td>
-</tr>
-</table>
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `text` | `String` | 要发送的文本内容。 |
+| `extensionInfo` | `[String: String]?` | 附加的扩展信息，可用于业务自定义。 |
+| `completion` | `CompletionClosure?` | 发送完成后的回调，包含成功或失败的结果。 |
 ### 步骤4：发送自定义弹幕
@@ -172,8 +110,8 @@ extension BarrageManager {
     /// 发送一条自定义弹幕，例如用于发送礼物
     func sendGiftMessage(giftId: String, giftCount: Int) {
         // 1. 定义一个能识别业务的ID
-        let businessId = "live_gift"
+        let businessId = "live_gift"
         // 2. 将业务数据编码为 JSON 字符串
         let giftData: [String: Any] = ["gift_id": giftId, "gift_count": giftCount]
         guard let jsonData = try? JSONSerialization.data(withJSONObject: giftData),
@@ -181,7 +119,7 @@ extension BarrageManager {
             print("无法将礼物数据编码为JSON")
             return
         }
         // 3. 调用核心API发送自定义消息
         barrageStore.sendCustomMessage(businessID: businessId, data: jsonString) { result in
             switch result {
@@ -196,47 +134,18 @@ extension BarrageManager {
 ```
 #### **接口参数**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`businessId`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`data`</td>
-<td rowspan="1" colSpan="1" >`String`</td>
-<td rowspan="1" colSpan="1" >业务数据，通常为 JSON 格式的字符串。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`completion`</td>
-<td rowspan="1" colSpan="1" >`CompletionClosure?`</td>
-<td rowspan="1" colSpan="1" >发送完成后的回调。</td>
-</tr>
-</table>
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `businessId` | `String` | 业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。 |
+| `data` | `String` | 业务数据，通常为 JSON 格式的字符串。 |
+| `completion` | `CompletionClosure?` | 发送完成后的回调。 |
 ### 步骤5：在本地插入提示消息
 在当前用户的消息列表中插入一条本地消息，这条消息不会被发送到直播间的其他用户。这非常适合用来显示系统欢迎、警告或操作提示等信息。
 ``` swift
 extension BarrageManager {
     /// 在本地消息列表中插入一条欢迎提示
     func showWelcomeMessage(for user: LiveUserInfo) {
         // 1. 创建一条 Barrage 消息
@@ -244,7 +153,7 @@ extension BarrageManager {
         welcomeTip.messageType = .text // 可以复用 text 类型来显示
         welcomeTip.textContent = "欢迎 \(user.userName) 进入直播间！"
         // sender 可以留空或设置为一个系统用户的标识
         // 2. 调用API将其插入本地列表
         barrageStore.appendLocalTip(message: welcomeTip)
     }
@@ -252,24 +161,9 @@ extension BarrageManager {
 ```
 #### **接口参数**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**参数**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >`message`</td>
-<td rowspan="1" colSpan="1" >`Barrage`</td>
-<td rowspan="1" colSpan="1" >要在本地插入的消息对象。SDK 会将此消息对象追加到 BarrageState 的 messageList 中。</td>
-</tr>
-</table>
+| **参数** | **类型** | **描述** |
+| --- | --- | --- |
+| `message` | `Barrage` | 要在本地插入的消息对象。SDK 会将此消息对象追加到 BarrageState 的 messageList 中。 |
 ### 步骤6：管理用户发言（禁言与解禁）
@@ -310,7 +204,7 @@ import AtomicXCore
 let liveListStore = LiveListStore.shared
 // 2. 获取当前直播间信息，并修改全体禁言状态
-var currentLiveInfo = liveListStore.state.value.currentLive
+var currentLiveInfo = liveListStore.state.value.currentLive
 currentLiveInfo.isMessageDisable = true // true为全体禁言, false为关闭
 // 3. 调用更新接口，并指定修改的标志位
@@ -392,7 +286,7 @@ class BarrageUIManager {
 SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 UI 层做了节流，数据层持有的这个巨大数组也会持续占用内存，最终导致应用闪退。
-#### 优化方案：固定容量的循环数组 (Circular Buffer)
+#### 优化方案：固定容量的循环数组 (Circular Buffer)
 **只让您自己的数据源（DataSource）持有有限数量的消息**。无论 SDK 返回的全量列表有多大，您的应用只截取其中最新的部分用于显示。
@@ -406,7 +300,7 @@ class BarrageUIManager {
     private func refreshUIIfNeeded() {
         guard let fullList = self.latestMessageList, let tableView = self.tableView else { return }
-        self.latestMessageList = nil
+        self.latestMessageList = nil
         // 关键点：截取最新的N条消息
         let cappedList = Array(fullList.suffix(self.capacity))
@@ -487,7 +381,6 @@ class BarrageCell: UITableViewCell {
 3. **接收端**: 在接收到弹幕消息后，检查其 `messageType` 是否为 `.custom` 以及 `businessId` 是否匹配。如果匹配，则解析 `data` 字符串（通常是解析JSON），根据解析出的数据（例如 `color、text`）来渲染您的自定义UI样式。
 ### 我在不同的类、不同的文件中都调用了 `BarrageStore.create(liveID: "some_id")`，这会创建出多个实例导致混乱吗？
 完全不会。`AtomicXCore` 内部机制会确保只要您传入的 `liveId` 相同，获取到的永远是同一个与该直播间绑定的 `BarrageStore` 实例。您可以在需要的地方随用随取，无需手动管理单例。
@@ -503,7 +396,6 @@ class BarrageCell: UITableViewCell {
 4. **网络问题**：检查设备当前的网络连接是否正常。消息发送依赖于网络。
 ### 新观众进入直播间时，如何让他们看到加入前的历史弹幕消息？
 `AtomicXCore` 支持拉取历史弹幕消息，但这需要您在**服务端控制台**进行一项简单的配置。配置完成后，SDK 会自动处理后续的一切，您无需编写额外的代码。
@@ -513,17 +405,10 @@ class BarrageCell: UITableViewCell {
 2. 在左侧导航栏按照路径：**消息服务 Chat** >** 功能配置 **>** 群组配置 **> **群功能配置** >** 直播群新成员查看入群前消息量配置**进行导航。
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/afe1de07a9a211f0a0a052540099c741.png)
 3. 修改“新成员可查看最近消息数”，最大支持 **50** 条。
    **步骤2：客户端无感获取 **
-   完成上述配置后，您的客户端代码**无需做任何改动**。
+   完成上述配置后，您的客户端代码**无需做任何改动**。
    当新用户加入直播间时，`AtomicXCore` 的底层 会自动拉取您配置的历史消息数量。这些历史消息会和实时消息一样，通过您已实现的 `BarrageStore.state` 订阅通道推送给您的UI层。您的应用会像接收实时弹幕一样，自然地接收并展示这些历史弹幕。