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

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

@@ -1,4 +1,4 @@
-本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的  `AudioEffectStore` 和 `DeviceStore` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
+本篇文档旨在指导您如何使用 `AtomicXCore` 框架中的 `AudioEffectStore` 和 `DeviceStore` 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。
 
 ## 核心功能
 
@@ -7,29 +7,29 @@
 
 - **耳返功能**：允许主播或连麦用户通过耳机实时听到自己的声音，用于监听和矫正发音。
 
-- **变声效果**：提供多种趣味变声选项，如萝莉、大叔、熊孩子等。
+- **变声效果**：提供多种趣味变声选项，例如萝莉、大叔、熊孩子等。
 
-- **混响效果**：模拟不同环境的声场效果，如 KTV、金属声、低沉、洪亮等。
+- **混响效果**：模拟不同环境的声场效果，例如 KTV、金属声、低沉、洪亮等。
 
 ## 概念说明
-| **核心概念** | **类型** | **核心职责与描述** |
+| <strong>核心概念</strong> | <strong>类型</strong> | <strong>核心职责与描述</strong> |
 | --- | --- | --- |
-| `AudioChangerType` | `enum class` | 变声效果枚举，例如，“小孩”，“男人”等。 |
-| `AudioReverbType` | `enum class` | 混响效果枚举，例如，“ktv”，“礼堂”等。 |
-| `AudioEffectState` | `data class` | 代表音效模块的当前状态，通常用于UI渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。 |
-| `AudioEffectStore` | `abstract class` | 代表音效模块**单例数据管理类**。通过它您可以调用修改音效接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个state响应式数据来接收和监听状态更新。 |
-| `DeviceState` | `data class` | 代表设备模块的当前状态，通常用于UI渲染。核心属性包括摄像头、麦克风的设备状态。 |
-| `DeviceStore` | `abstract class` | 代表设备模块**单例数据管理类**。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的`state`属性会自动更新，可以通过订阅这个state响应式数据来接收和监听状态更新。 |
+| <code>AudioChangerType</code> | <code>enum class</code> | 变声效果枚举，例如，“小孩”，“男人”等。 |
+| <code>AudioReverbType</code> | <code>enum class</code> | 混响效果枚举，例如，“ktv”，“礼堂”等。 |
+| <code>AudioEffectState</code> | <code>data class</code> | 代表音效模块的当前状态，通常用于 UI 渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。 |
+| <code>AudioEffectStore</code> | <code>abstract class</code> | 代表音效模块<strong>单例数据管理类</strong>。通过它您可以调用修改音效接口，当您调用接口后，相应的 <code>state</code> 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
+| <code>DeviceState</code> | <code>data class</code> | 代表设备模块的当前状态，通常用于 UI 渲染。核心属性包括摄像头、麦克风的设备状态。 |
+| <code>DeviceStore</code> | <code>abstract class</code> | 代表设备模块<strong>单例数据管理类</strong>。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的 <code>state</code> 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 快速接入 集成 **AtomicXCore。**
+请参考 开播与收听 集成 **AtomicXCore。**
 
 ### 步骤2：获取 Store 实例
 
-`AudioEffectStore` 和 `DeviceStore`是单例对象，您可以直接通过 shared 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源UI demo项目中的 [AudioEffectPanel.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/component/audioeffect/AudioEffectPanel.kt) 文件来了解完整的实现逻辑。
+`AudioEffectStore` 和 `DeviceStore` 是单例对象，您可以直接通过 shared 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源 UI Demo 项目中的 [AudioEffectPanel.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/component/audioeffect/AudioEffectPanel.kt) 文件来了解完整的实现逻辑。
 ``` java
 import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
 import io.trtc.tuikit.atomicxcore.api.device.DeviceStore
@@ -49,11 +49,11 @@ val deviceStore = DeviceStore.shared()
 >
 
 #### 实现方式:
-1. **开关耳返**：您可以使用`Switch`控件实现开关耳返功能。
+1. **开关耳返**：您可以使用 `Switch` 控件实现开关耳返功能。
 
-2. **设置耳返音量值**：您可以使用 `SeekBar` 控件实现左右拖动滑块来调节音量的功能，并将 `SeekBar` 的值映射成音量值，调用`setOutputVolume(volume)。`请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
+2. **设置耳返音量值**：您可以使用 `SeekBar` 控件实现左右拖动滑块来调节音量的功能，并将 `SeekBar` 的值映射为音量值，调用 `setOutputVolume(volume)。`请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值（例如 UISlider 的 `0 - 1.0`）映射到 `0 - 150` 的范围。
 
-3. **监听状态更新UI**：您可以订阅实时的耳返状态值更新 `UI`。
+3. **监听状态更新 UI**：您可以订阅实时的耳返状态值更新 `UI`。
 
 #### 代码示例:
 ``` java
@@ -81,21 +81,21 @@ CoroutineScope(Dispatchers.Main).launch {
 ```
 
 #### setVoiceEarMonitorEnable 接口参数
-| **参数名** | **类型** | **描述** |
+| <strong>参数名</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `enable` | `Boolean` | 是否开启耳返。<br>- true：开启<br>- false：关闭 |
+| <code>enable</code> | <code>Boolean</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. **设置采集音量值**：您可以使用 `SeekBar` 控件实现左右拖动滑块来调节音量的功能，并将 `SeekBar` 的值映射成音量值后调用`setCaptureVolume(80)。`请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 `UI` 控件的值（例如 `SeekBar` 的 `0 - 150`）映射到 `0 - 150` 的范围。
+1. **设置采集音量值**：您可以使用 `SeekBar` 控件实现左右拖动滑块来调节音量的功能，并将 `SeekBar` 的值映射成音量值后调用 `setCaptureVolume(80)。`请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 `UI` 控件的值（例如 `SeekBar` 的 `0 - 150`）映射到 `0 - 150` 的范围。
 
 2. **监听状态更新 UI**：您可以订阅实时的音量状态值更新 UI。
 
@@ -120,13 +120,13 @@ CoroutineScope(Dispatchers.Main).launch {
 ```
 
 #### 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 枚举值即可切换效果。
 
 #### 示例代码：
 ``` java
@@ -141,13 +141,14 @@ audioEffectStore.setAudioChangerType(AudioChangerType.NONE)
 ```
 
 #### setAudioChangerType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `type` | `AudioChangerType` | 变声效果枚举。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`type`|`AudioChangerType`|变声效果枚举。|
 
 ### 步骤6：实现混响效果
 
-当主播希望给自己的声音添加混响效果时，您可以调用`setAudioReverbType(type)` 方法，传入相应的Type 枚举值即可切换效果。
+当主播希望给自己的声音添加混响效果时，您可以调用 `setAudioReverbType(type)` 方法，传入相应的 Type 枚举值即可切换效果。
 ``` java
 import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
 import io.trtc.tuikit.atomicxcore.api.device.AudioReverbType
@@ -160,9 +161,10 @@ audioEffectStore.setAudioReverbType(AudioReverbType.NONE)
 ```
 
 #### setAudioReverbType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `type` | `AudioReverbType` | 混响效果枚举。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`type`|`AudioReverbType`|混响效果枚举。|
 
 ### 步骤7：重置音效设置
 
@@ -175,7 +177,7 @@ audioEffectStore.setAudioReverbType(AudioReverbType.NONE)
 以下两种情况您可能需要重置音效设置：
 1. 当前直播间结束时，需要重置音效设置。
 
-2. 您需要提供“一键恢复”的功能，可以通过调用 `store` 的`reset()` 方法实现。
+2. 您需要提供“一键恢复”的功能，可以通过调用 `store` 的 `reset()` 方法实现。
 
    ``` java
    import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
@@ -190,16 +192,17 @@ audioEffectStore.setAudioReverbType(AudioReverbType.NONE)
 ## API 文档
 
 关于 [AudioEffectStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-effect-store/index.html) 和 [DeviceStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html) 及其相关类的所有公开接口、属性的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **AudioEffectStore** | 音效管理：进行音效设置，并获取实时音效状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-effect-store/index.html) |
-| **DeviceStore ** | 设备管理：进行摄像头、麦克风操作，并获取实时设备状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**AudioEffectStore**|音效管理：进行音效设置，并获取实时音效状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-effect-store/index.html)|
+|**DeviceStore **|设备管理：进行摄像头、麦克风操作，并获取实时设备状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html)|
 
 ## 常见问题
 
 ### 音效和设备接口的调用时机有没有要求？
 
-没有限制。`AudioEffectStore`和`DeviceStore` 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（如设置变声、混响或耳返），设置会立即生效并被保留。
+没有限制。`AudioEffectStore` 和 `DeviceStore` 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。
 
 ### **“人声音量” 和“耳返音量” 有什么区别？**
 
@@ -210,7 +213,7 @@ audioEffectStore.setAudioReverbType(AudioReverbType.NONE)
 
 ### **新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？**
 
-`AudioEffectStore`和`DeviceStore`是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用`reset()`方法重置。
+`AudioEffectStore` 和 `DeviceStore` 是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用 `reset()` 方法重置。
 
 ### **为什么我开启了“耳返”，但是听不到自己的声音？**
 

package/resource/{doc → knowledge}/livekit/core-sdk/voice/android/voice-barrage.md

@@ -7,24 +7,26 @@
 
 - 发送文本弹幕与观众互动。
 
-- 发送自定义业务弹幕，以支持礼物、点赞等复杂场景。
+- 发送自定义业务弹幕，以支持系统公告、后台通知等场景。
 
 - 在本地消息列表中插入系统提示（例如，"欢迎 XX 进入直播间"）。
 
 ## 核心概念解析
 
 在开始集成之前，我们先通过下表了解一下 BarrageStore 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| [Barrage](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.barrage/-barrage/index.html) | `data class` | 代表一条弹幕消息的数据模型。它包含了发送者信息 (`sender`)、消息内容 (`textContent` 或 `data`)、消息类型 (`messageType`) 等所有关键信息。 |
-| [BarrageState](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.barrage/-barrage-state/index.html) | `data class` | 代表弹幕模块的当前状态。其核心属性 `messageList` 是一个`StateFlow`，按时间顺序存储了当前直播间的所有弹幕消息，是UI渲染的数据源。 |
-| [BarrageStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.barrage/-barrage-store/index.html) | `abstract class` | 这是与弹幕功能交互的核心管理类。通过它，您可以发送消息 (`sendTextMessage`, `sendCustomMessage`)，并通过订阅其 `state` 属性来接收和监听所有弹幕消息的更新。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|[Barrage](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.barrage/-barrage/index.html)|`data class`|代表一条弹幕消息的数据模型。它包含了发送者信息 (`sender`)、消息内容 (`textContent` 或 `data`)、消息类型 (`messageType`) 等所有关键信息。|
+|[BarrageState](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.barrage/-barrage-state/index.html)|`data class`|代表弹幕模块的当前状态。其核心属性 `messageList` 是一个 `StateFlow`，按时间顺序存储了当前直播间的所有弹幕消息，是 UI 渲染的数据源。|
+|[BarrageStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.barrage/-barrage-store/index.html)|`abstract class`|这是与弹幕功能交互的核心管理类。通过它，您可以发送消息 (`sendTextMessage`, `sendCustomMessage`)，并通过订阅其 `state` 属性来接收和监听所有弹幕消息的更新。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 开始直播 集成 **AtomicXCore**，完成接入。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：初始化并监听弹幕
 
@@ -46,8 +48,10 @@ class BarrageManager(
     val messagesFlow: StateFlow<List<Barrage>> = _messagesFlow.asStateFlow()
 
     init {
-        // 初始化后立即开始监听弹幕消息
+        // 初始化后立即开始监听弹幕文本消息
         subscribeToBarrageUpdates()
+        // 初始化后立即开始监听自定义消息
+        subscribeToCustomMessage()
     }
 
     private fun subscribeToBarrageUpdates() {
@@ -60,12 +64,27 @@ class BarrageManager(
                 }
         }
     }
+
+    private fun subscribeToCustomMessage() {
+        scope.launch {
+            barrageStore.customMessageEvent.collect { event ->
+                // 当 收到自定义弹幕消息时，通过 customMessageEvent 事件 将自定义弹幕消息数据传递给UI层
+                when (event) {
+                    is CustomMessageEvent.CustomMessageReceived -> {
+                        val barrage = event.barrage
+                        // 收到自定义弹幕消息后处理自己的业务逻辑
+                        _messagesFlow.value = _messagesFlow.value + barrage
+                    }
+                }
+            }
+        }
+    }
 }
 ```
 
 ### 步骤3：发送文本弹幕
 
-调用 `sendTextMessage` 方法向直播间内的所有用户广播一条纯文本消息。
+调用 `sendTextMessage` 方法向直播间内的所有用户广播一条纯文本消息。接收方会在步骤2中触发 messageList 的更新。
 ``` kotlin
 import io.trtc.tuikit.atomicxcore.api.CompletionHandler
 import io.trtc.tuikit.atomicxcore.api.barrage.BarrageStore
@@ -104,15 +123,16 @@ class BarrageManager(
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `text` | `String?` | 要发送的文本内容。 |
-| `extensionInfo` | `Map<String, String>?` | 附加的扩展信息，可用于业务自定义。 |
-| `completion` | `CompletionHandler?` | 发送完成后的回调，包含成功或失败的结果。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`text`|`String?`|要发送的文本内容。|
+|`extensionInfo`|`Map<String, String>?`|附加的扩展信息，可用于业务自定义。|
+|`completion`|`CompletionHandler?`|发送完成后的回调，包含成功或失败的结果。|
 
 ### 步骤4：发送自定义弹幕
 
-发送一条包含自定义业务逻辑的消息，例如礼物、点赞或游戏化互动指令。这条消息对其他客户端来说是透明的，需要业务层自行解析。
+发送一条包含自定义业务逻辑的消息，例如系统公告、后台通知等场景。接收方会在步骤2 中触发 CustomMessageReceived 事件。这条消息对其他客户端来说是透明的，需要业务层自行解析并处理。
 ``` kotlin
 class BarrageManager(
     private val liveId: String
@@ -137,7 +157,7 @@ class BarrageManager(
         }
 
         // 3. 调用核心API发送自定义消息
-        barrageStore.sendCustomMessage(
+        this.barrageStore.sendCustomMessage(
             businessId,
             jsonString,
             object : CompletionHandler {
@@ -155,11 +175,12 @@ class BarrageManager(
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `businessId` | `String` | 业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。 |
-| `data` | `String` | 业务数据，通常为 JSON 格式的字符串。 |
-| `completion` | `CompletionHandler?` | 发送完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`businessId`|`String`|业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。|
+|`data`|`String`|业务数据，通常为 JSON 格式的字符串。|
+|`completion`|`CompletionHandler?`|发送完成后的回调。|
 
 ### 步骤5：在本地插入提示消息
 
@@ -179,15 +200,16 @@ class BarrageManager(
         )
 
         // 2. 调用API将其插入本地列表
-        barrageStore.appendLocalTip(welcomeTip)
+        this.barrageStore.appendLocalTip(welcomeTip)
     }
 }
 ```
 
 #### **接口参数**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `message` | `Barrage` | 要在本地插入的消息对象。SDK 会将此消息对象追加到 BarrageState 的 messageList 中。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`message`|`Barrage`|要在本地插入的消息对象。SDK 会将此消息对象追加到 BarrageState 的 messageList 中。|
 
 ### 步骤6：管理用户发言（禁言与解禁）
 
@@ -201,7 +223,7 @@ import io.trtc.tuikit.atomicxcore.api.*
 import io.trtc.tuikit.atomicxcore.api.live.LiveAudienceStore
 
 // 1. 获取与当前直播间绑定的 LiveAudienceStore 实例
-val audienceStore = LiveAudienceStore.create(liveId)
+val audienceStore = LiveAudienceStore.create("your_live_id_here")
 
 // 2. 定义要操作的用户ID和禁言状态
 val userIdToMute = "user_id_to_be_muted"
@@ -267,11 +289,11 @@ liveListStore.updateLiveInfo(
 
 #### 技术挑战
 
-SDK会以极高频率返回完整的弹幕列表。如果每次都调用 `adapter.notifyDataSetChanged()`，主线程会被密集的 UI 布局和渲染操作阻塞，导致界面卡顿。
+SDK 会以极高频率返回完整的弹幕列表。如果每次都调用 `adapter.notifyDataSetChanged()`，主线程会被密集的 UI 布局和渲染操作阻塞，导致界面卡顿。
 
 #### 优化方案：批处理与流量削峰 (Batch Processing & Debouncing)
 
-不必响应每一次的数据更新，而是设定一个时间阈值（例如300毫秒）。只在距离上次UI刷新超过这个阈值后，才执行下一次刷新操作。这能将每秒数十次的 `notifyDataSetChanged()` 调用，降低到每秒3-4次，极大提升流畅度。
+不必响应每一次的数据更新，而是设定一个时间阈值（例如300毫秒）。只在距离上次 UI 刷新超过这个阈值后，才执行下一次刷新操作。这能将每秒数十次的 `notifyDataSetChanged()` 调用，降低到每秒3-4次，极大提升流畅度。
 
 #### 代码示例
 
@@ -363,7 +385,7 @@ class BarrageUIManager(
 
 渲染包含多图文、自定义字体或复杂布局的视图，比渲染纯文本耗时更长。在列表中高频渲染这些复杂视图，会加重主线程的计算压力，导致列表滚动时出现卡顿。
 
-#### 优化方案：异步绘制 (Asynchronous Drawing)
+#### 优化方案：异步绘制 (Asynchronous drawing)
 
 将视图内容的绘制过程从主线程剥离，放到后台线程去完成。主线程只负责最终的"贴图"操作，即显示已经绘制好的位图。这极大地减轻了主线程的计算压力。
 
@@ -375,7 +397,7 @@ import android.view.LayoutInflater
 import androidx.asynclayoutinflater.view.AsyncLayoutInflater
 import androidx.recyclerview.widget.RecyclerView
 
-// 在你的自定义弹幕ViewHolder中
+// 在您的自定义弹幕ViewHolder中
 class BarrageViewHolder(
     itemView: View
 ) : RecyclerView.ViewHolder(itemView) {
@@ -393,7 +415,7 @@ class BarrageViewHolder(
     }
 
     fun bind(viewModel: BarrageViewModel) {
-        // 在这里设置你的TextView文本、ImageView图片等
+        // 在这里设置您的TextView文本、ImageView图片等
         // 由于使用了异步布局加载，这些内容的最终渲染会尽量在后台完成
     }
 
@@ -421,7 +443,7 @@ class BarrageViewHolder(
    ```
 2. **发送端:** 在发送时，将这个 JSON 结构转换为字符串，并通过 `sendCustomMessage` 的 `data` 参数发送出去。`businessID` 可以设置为一个能代表您业务的唯一标识，例如 "`barrage_style_v1`"。
 
-3. **接收端**: 在接收到弹幕消息后，检查其 `messageType` 是否为 `BarrageType.CUSTOM` 以及 `businessID` 是否匹配。如果匹配，则解析 `data` 字符串（通常是解析 JSON），根据解析出的数据（例如 `color、text`）来渲染您的自定义UI样式。
+3. **接收端**: 在接收到弹幕消息后，检查其 `messageType` 是否为 `BarrageType.CUSTOM` 以及 `businessID` 是否匹配。如果匹配，则解析 `data` 字符串（通常是解析 JSON），根据解析出的数据（例如 `color、text`）来渲染您的自定义 UI 样式。
 
 ### 我在不同的类、不同的文件中都调用了 `BarrageStore.create(liveID = "some_id")`，这会创建出多个实例导致混乱吗？
 
@@ -440,14 +462,22 @@ class BarrageViewHolder(
 
 ### 新观众进入直播间时，如何让他们看到加入前的历史弹幕消息？
 
-`AtomicXCore` 支持拉取历史弹幕消息，但这需要您在**服务端控制台**进行一项简单的配置。配置完成后，SDK会自动处理后续的一切，您无需编写额外的代码。
+`AtomicXCore` 支持拉取历史弹幕消息，但这需要您在**服务端控制台**进行一项简单的配置。配置完成后，SDK 会自动处理后续的一切，您无需编写额外的代码。
+
+**步骤1：在控制台进行配置**
+
+根据您的应用创建方式，选择对应的控制台进行配置（实时音视频控制台或即时通信 IM 控制台）。
+
+在控制台的配置页面中，找到**查看直播间历史消息**选项，修改其配置（最大支持 **50** 条消息）。
+- 若您的应用在 [实时音视频控制台](https://console.cloud.tencent.com/trtc/app) 创建，配置步骤如下：
+
+   左侧导航栏选择**应用管理** > **功能配置 **>** LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
 
-**步骤1：在 IM 控制台进行配置**
-1. 登录您的 [即时通信 IM 控制台](https://cloud.tencent.com/login?s_url=https%3A%2F%2Fconsole.cloud.tencent.com%2Fim)。
+- 若您的应用在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/rtc-config) 创建，配置步骤如下：
 
-2. 在左侧导航栏，按照路径**消息服务 Chat** >** 功能配置 **> **群组配置** >** 群功能配置** > **直播群新成员查看入群前消息量配置**进行导航。
+   左侧导航栏选择**音视频服务 RTC**，选择对应的应用后，单击**在线直播/语音聊天室(TUILiveKit) > 配置**。
 
-3. 修改"新成员可查看最近消息数"，最大支持 **50** 条。
+   进入 **LiveKit 功能配置**后，单击**查看直播间历史消息** > **编辑**。
 
    **步骤2：客户端无感获取**
 

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

@@ -1,8 +1,8 @@
-**AtomicXCore** 提供了 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-guest-store/index.html) 和 [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/index.html)模块，用于管理观众连麦的完整业务流程。您无需关心复杂的状态同步和信令交互，只需调用几个简单的方法，即可为您的直播添加强大的观众与主播音视频互动功能。本文档将指导您如何使用 `CoGuestStore `和 `LiveSeatStore` 在 `Android` 应用中快速实现语音连麦功能。
+**AtomicXCore** 提供了 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-guest-store/index.html) 和 [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/index.html) 模块，用于管理观众连麦的完整业务流程。您无需关心复杂的状态同步和信令交互，只需调用几个简单的方法，即可为您的直播添加强大的观众与主播音视频互动功能。本文档将指导您如何使用 `CoGuestStore `和 `LiveSeatStore` 在 `Android` 应用中快速实现语音连麦功能。
 
 ## 核心场景
 
-`CoGuestStore`和`LiveSeatStore`支持以下几个主流的场景：
+`CoGuestStore` 和 `LiveSeatStore` 支持以下几个主流的场景：
 - **观众申请上麦**：观众主动发起连麦请求，主播在收到请求后进行同意或拒绝。
 
 - **主播邀请上麦**：主播可以主动向直播间内的任意一位观众发起连麦邀请。
@@ -13,7 +13,7 @@
 
 ### 步骤1：组件集成
 
-请参考 快速接入 集成 **AtomicXCore**。
+请参考 开播与收听 集成 **AtomicXCore**。
 
 ### 步骤2：实现观众申请上麦
 
@@ -59,13 +59,13 @@
        val guestListener = object : GuestListener() {
            override fun onGuestApplicationResponded(isAccept: Boolean, hostUser: LiveUserInfo) {
                if (isAccept) {
-                   print("主播 ${hostUser.userName} 同意了你的申请，准备上麦")
+                   print("主播 ${hostUser.userName} 同意了您的申请，准备上麦")
                    // 1. 打开摄像头、麦克风
                    DeviceStore.shared().openLocalCamera(true, null)
                    DeviceStore.shared().openLocalMicrophone(null)
                    // 2. 在此更新 UI，例如关闭申请按钮，显示连麦中的状态
                } else {
-                   print("主播 ${hostUser.userName} 拒绝了你的申请")
+                   print("主播 ${hostUser.userName} 拒绝了您的申请")
                    // 弹窗提示用户申请被拒绝
                }
            }
@@ -224,9 +224,9 @@
    // 在 hostListener 的实现中添加
    override fun onHostInvitationResponded(isAccept: Boolean, guestUser: LiveUserInfo) {
        if (isAccept) {
-           print("观众 ${guestUser.userName} 接受了你的邀请")
+           print("观众 ${guestUser.userName} 接受了您的邀请")
        } else {
-           print("观众 ${guestUser.userName} 拒绝了你的邀请")
+           print("观众 ${guestUser.userName} 拒绝了您的邀请")
        }
    }
    ```
@@ -302,9 +302,10 @@ seatStore.unmuteMicrophone(null) //解除静音
 ```
 
 #### unmuteMicrophone 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `completion` | `CompletionHandler?` | 操作完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`completion`|`CompletionHandler?`|操作完成后的回调。|
 
 ### 主播远程控制麦上用户开麦或关麦
 
@@ -366,16 +367,18 @@ seatStore.addLiveSeatEventListener(seatListener)
 ```
 
 #### closeRemoteMicrophone 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被操作的用户`userID`。 |
-| `completion` | `CompletionHandler?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被操作的用户 `userID`。|
+|`completion`|`CompletionHandler?`|请求完成后的回调。|
 
 #### openRemoteMicrophone 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被操作的用户`userID`。 |
-| `completion` | `CompletionHandler?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被操作的用户 `userID`。|
+|`completion`|`CompletionHandler?`|请求完成后的回调。|
 
 ### 主播将麦上用户踢下麦位
 
@@ -405,17 +408,18 @@ override fun onKickedOffSeat(seatIndex: Int, hostUser: LiveUserInfo) {
 ```
 
 #### kickUserOutOfSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被踢下麦用户`userID`。 |
-| `completion` | `CompletionHandler?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被踢下麦用户 `userID`。|
+|`completion`|`CompletionHandler?`|请求完成后的回调。|
 
 ### 主播锁定和解锁麦位
 
 主播可以锁定或解锁某个麦位。
 
 #### 实现方式：
-1. **锁定麦位**：主播可调用 `lockSeat` 方法锁定指定索引的麦位，麦位被锁定后，观众无法通过 `applyForSeat` 或`takeSeat` 占用该麦位。
+1. **锁定麦位**：主播可调用 `lockSeat` 方法锁定指定索引的麦位，麦位被锁定后，观众无法通过 `applyForSeat` 或 `takeSeat` 占用该麦位。
 
 2. **解锁麦位**：调用 `unlockSeat` 可以解锁麦位，解锁后该麦位可以再次被占用。
 
@@ -443,25 +447,27 @@ seatStore.unlockSeat(2, object : CompletionHandler {
 ```
 
 #### lockSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `seatIndex` | `Int` | 需要锁定的麦位索引。 |
-| `completion` | `CompletionHandler?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`seatIndex`|`Int`|需要锁定的麦位索引。|
+|`completion`|`CompletionHandler?`|请求完成后的回调。|
 
 #### unlockSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `seatIndex` | `Int` | 需要解锁的麦位索引。 |
-| `completion` | `CompletionHandler?` | 请求完成后的回调。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`seatIndex`|`Int`|需要解锁的麦位索引。|
+|`completion`|`CompletionHandler?`|请求完成后的回调。|
 
 ### 移动麦位
 
-主播和普通上麦用户可以调用`moveUserToSeat`移动麦位。
+主播和普通上麦用户可以调用 `moveUserToSeat` 移动麦位。
 
 #### 实现方式：
-1. **主播移动麦位**：主播可以调用此接口将任意用户移动到指定麦位。此时 `userID` 传入目标用户的 ID，`targetIndex`是目标麦位索引，`policy` 参数来指定如果目标麦位有人时的移动策略，详见接口参数说明。
+1. **主播移动麦位**：主播可以调用此接口将任意用户移动到指定麦位。此时 `userID` 传入目标用户的 ID，`targetIndex` 是目标麦位索引，`policy` 参数来指定如果目标麦位有人时的移动策略，详见接口参数说明。
 
-2. **普通上麦用户移动自己麦位**：普通上麦用户也可以调用此接口来移动自己。此时 `userID` 必须传入用户自己的 ID，`targetIndex` 传入想去的新麦位索引，此时`policy` 参数无效，如果目标麦位有人时会报错并停止移动。
+2. **普通上麦用户移动自己麦位**：普通上麦用户也可以调用此接口来移动自己。此时 `userID` 必须传入用户自己的 ID，`targetIndex` 传入想去的新麦位索引，此时 `policy` 参数无效，如果目标麦位有人时会报错并停止移动。
 
 #### 示例代码：
 ``` java
@@ -482,20 +488,21 @@ seatStore.moveUserToSeat("userC",
 ```
 
 #### moveUserToSeat 接口参数：
-| **参数** | **类型** | **描述** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `userID` | `String` | 需要移麦的用户`userID`。 |
-| `targetIndex` | `Int` | 目标麦位索引。 |
-| `policy` | `MoveSeatPolicy?` | 目标麦位有人时的移动策略枚举：<br>- `abortWhenOccupied`：目标麦位有人时放弃移动（默认策略）​​<br>- `forceReplace`：强制替换目标麦位上的用户​​，被替换的用户将会被踢下麦<br>- `swapPosition`：与目标麦位用户交换位置​​。 |
-| `completion` | `CompletionHandler?` | 请求完成后的回调。 |
+| <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>CompletionHandler?</code> | 请求完成后的回调。 |
 
 ## API 文档
 
 关于 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-guest-store/index.html) 和 [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/index.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| CoGuestStore | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-guest-store/index.html) |
-| LiveSeatStore | 麦位管理：静音/解除静音，锁定/解锁麦位，踢人下麦、远程控制麦上用户麦克风，麦列表状态监听 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/index.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|CoGuestStore|观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-guest-store/index.html)|
+|LiveSeatStore|麦位管理：静音/解除静音，锁定/解锁麦位，踢人下麦、远程控制麦上用户麦克风，麦列表状态监听|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-seat-store/index.html)|
 
 ## 常见问题
 
@@ -532,8 +539,8 @@ seatStore.moveUserToSeat("userC",
 
    推荐的工作流程：您应该遵循“设备只开一次，麦上只用静音切换”的原则
 
-1. **上麦时**：当观众成功上麦，调用一次 `openLocalMicrophone`来启动设备。
+1. **上麦时**：当观众成功上麦，调用一次 `openLocalMicrophone` 来启动设备。
 
-2. **在麦上时**：用户在麦位上所有的“开麦”和“闭麦”操作，都应该调用 `unmuteMicrophone`和 `muteMicrophone`来控制上行音频流的通断。
+2. **在麦上时**：用户在麦位上所有的“开麦”和“闭麦”操作，都应该调用 `unmuteMicrophone` 和 `muteMicrophone` 来控制上行音频流的通断。
 
-3. **下麦时**：当用户下麦（例如调用 `disconnect`），调用`closeLocalMicrophone`来释放设备。
+3. **下麦时**：当用户下麦（例如调用 `disconnect`），调用 `closeLocalMicrophone` 来释放设备。