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

package/resource/{doc → knowledge}/livekit/core-sdk/live/android/live-audience-list.md

@@ -1,4 +1,4 @@
-`LiveAudienceStore` 是 `AtomicXCore` 中专门负责管理直播间观众信息的模块。通过`LiveAudienceStore`，您可以为您的直播应用构建一套完整的观众列表及管理系统。
+`LiveAudienceStore` 是 `AtomicXCore` 中专门负责管理直播间观众信息的模块。通过 `LiveAudienceStore`，您可以为您的直播应用构建一套完整的观众列表及管理系统。
 
 ## 核心功能
 - **实时观众列表**：获取并展示当前在直播间内的所有观众信息。
@@ -14,18 +14,20 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 LiveAudienceStore 相关的几个核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| `LiveUserInfo` | data class | 代表一个观众（用户）的基础信息模型。它包含了用户的唯一标识 (`userID`)、昵称 (`userName`) 和头像地址 (`avatarURL`)。 |
-| `LiveAudienceState` | data class | 代表观众模块的当前状态。其核心属性 `audienceList` 是一个 StateFlow，存储了观众列表的实时状态；`audienceCount` 则代表当前观众总数的实时状态。 |
-| `LiveAudienceListener` | abstract class | 代表观众动态的实时事件。分为 `onAudienceJoined` (观众加入) 和 `onAudienceLeft` (观众离开) 两种，用于实现对观众列表的增量更新。 |
-| `LiveAudienceStore` | abstract class | 这是与观众列表功能交互的核心管理类。通过它，您可以获取观众列表快照、执行管理操作，并通过订阅其 `LiveAudienceListener` 来接收实时动态。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|`LiveUserInfo`|data class|代表一个观众（用户）的基础信息模型。它包含了用户的唯一标识 (`userID`)、昵称 (`userName`) 和头像地址 (`avatarURL`)。|
+|`LiveAudienceState`|data class|代表观众模块的当前状态。其核心属性 `audienceList` 是一个 StateFlow，存储了观众列表的实时状态；`audienceCount` 则代表当前观众总数的实时状态。|
+|`LiveAudienceListener`|abstract class|代表观众动态的实时事件。分为 `onAudienceJoined` (观众加入) 和 `onAudienceLeft` (观众离开) 两种，用于实现对观众列表的增量更新。|
+|`LiveAudienceStore`|abstract class|这是与观众列表功能交互的核心管理类。通过它，您可以获取观众列表快照、执行管理操作，并通过订阅其 `LiveAudienceListener` 来接收实时动态。|
 
 ## 实现指南
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 开始直播 集成 **AtomicXCore**，完成接入。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：初始化并获取观众列表
 
@@ -80,7 +82,7 @@ class AudienceManager(
 
 ### 步骤3：监听观众列表状态与实时动态
 
-订阅 `audienceStore` 的 `liveAudienceState` 和添加 `LiveAudienceListener`，以接收全量列表快照和实时的观众进出事件，从而驱动UI更新。
+订阅 `audienceStore` 的 `liveAudienceState` 和添加 `LiveAudienceListener`，以接收全量列表快照和实时的观众进出事件，从而驱动 UI 更新。
 ``` kotlin
 class AudienceManager {
     /// 订阅 state，用于获取观众总数和列表快照
@@ -100,27 +102,30 @@ class AudienceManager {
         }
     }
 
-    /// 订阅 event，用于处理观众的实时进出事件
-    private fun subscribeToAudienceEvents() {
-        audienceStore.addLiveAudienceListener(object : LiveAudienceListener() {
-            override fun onAudienceJoined(newAudience: LiveUserInfo) {
-                println("观众 ${newAudience.userName} 加入了直播间")
-                // 增量更新：在当前列表末尾添加新观众
-                val currentList = _audienceList.value.toMutableList()
-                if (!currentList.any { it.userID == newAudience.userID }) {
-                    currentList.add(newAudience)
-                    _audienceList.value = currentList
-                }
-            }
-
-            override fun onAudienceLeft(departedAudience: LiveUserInfo) {
-                println("观众 ${departedAudience.userName} 离开了直播间")
-                // 增量更新：从当前列表中移除离开的观众
-                val currentList = _audienceList.value.toMutableList()
-                currentList.removeAll { it.userID == departedAudience.userID }
+    private val liveAudienceListener = object : LiveAudienceListener() {
+        override fun onAudienceJoined(audience: LiveUserInfo) {
+            println("观众 ${newAudience.userName} 加入了直播间")
+            // 增量更新：在当前列表末尾添加新观众
+            val currentList = _audienceList.value.toMutableList()
+            if (!currentList.any { it.userID == newAudience.userID }) {
+                currentList.add(newAudience)
                 _audienceList.value = currentList
             }
-        })
+        }
+
+        override fun onAudienceLeft(departedAudience: LiveUserInfo) {
+            println("观众 ${departedAudience.userName} 离开了直播间")
+            // 增量更新：从当前列表中移除离开的观众
+            val currentList = _audienceList.value.toMutableList()
+            currentList.removeAll { it.userID == departedAudience.userID }
+            _audienceList.value = currentList
+        }
+
+    }
+
+    /// 订阅 event，用于处理观众的实时进出事件
+    private fun subscribeToAudienceEvents() {
+        audienceStore.addLiveAudienceListenerliveAudienceListener)
     }
 }
 ```
@@ -208,27 +213,29 @@ class LiveRoomManager(
         setupWelcomeMessageFlow()
     }
 
+    private val liveAudienceListener = object : LiveAudienceListener() {
+        override fun onAudienceJoined(audience: LiveUserInfo) {
+            // 3. 创建一条本地提示消息
+            val welcomeTip = Barrage().apply {
+                liveID = liveId
+                messageType = BarrageType.TEXT
+                textContent = "欢迎 ${audience.userName} 进入直播间！"
+            }
+
+            // 4. 获取 BarrageStore 的实例 (得益于内部机制，这会是同一个实例)
+            val barrageStore = BarrageStore.create(liveId)
+
+            // 5. 调用 BarrageStore 的接口将其插入弹幕列表
+            barrageStore.appendLocalTip(welcomeTip)
+        }
+    }
+
     private fun setupWelcomeMessageFlow() {
         // 1. 获取 LiveAudienceStore 的实例
         val audienceStore = LiveAudienceStore.create(liveId)
 
-        // 2. 获取 BarrageStore 的实例 (得益于内部机制，这会是同一个实例)
-        val barrageStore = BarrageStore.create(liveId)
-
-        // 3. 订阅观众事件
-        audienceStore.addLiveAudienceListener(object : LiveAudienceListener() {
-            override fun onAudienceJoined(audience: LiveUserInfo) {
-                // 4. 创建一条本地提示消息
-                val welcomeTip = Barrage().apply {
-                    liveID = liveId
-                    messageType = BarrageType.TEXT
-                    textContent = "欢迎 ${audience.userName} 进入直播间！"
-                }
-
-                // 5. 调用 BarrageStore 的接口将其插入弹幕列表
-                barrageStore.appendLocalTip(welcomeTip)
-            }
-        })
+        // 2. 订阅观众事件
+        audienceStore.addLiveAudienceListener(liveAudienceListener)
     }
 }
 ```
@@ -236,11 +243,12 @@ class LiveRoomManager(
 ## API 文档
 
 关于 [LiveAudienceStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-audience-store/index.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicX Core](https://tencent-rtc.github.io/TUIKit_Android/index.html) 框架的官方 API 文档。本文档使用到的相关 Store 如下：
-| Store/Component | 功能描述 | API 文档 |
-| --- | --- | --- |
-| LiveCoreView | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](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) |
-| LiveAudienceStore | 观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。 | [API 文档](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) |
-| BarrageStore | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](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) |
+
+|Store/Component|功能描述|API 文档|
+|---------|---------|---------|
+|LiveCoreView|直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。|[API 文档](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)|
+|LiveAudienceStore|观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。|[API 文档](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)|
+|BarrageStore|弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。|[API 文档](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)|
 
 ## 常见问题
 
@@ -261,4 +269,4 @@ class LiveRoomManager(
 
       **这对开发者意味着什么？**
 
-      `audienceCount` 是一个非常接近实时的**高精度估算值**，但在极端高并发场景下，它可能存在短暂的延迟或数据丢失。因此，我们建议您将其用于**UI展示**，而不应作为计费、统计等需要绝对精准场景的唯一依据。
+      `audienceCount` 是一个非常接近实时的**高精度估算值**，但在极端高并发场景下，它可能存在短暂的延迟或数据丢失。因此，我们建议您将其用于 **UI 展示**，而不应作为计费、统计等需要绝对精准场景的唯一依据。

package/resource/{doc → knowledge}/livekit/core-sdk/live/android/live-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 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,9 +49,9 @@ 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`。
 
@@ -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：重置音效设置
 
@@ -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/live/android/live-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次，极大提升流畅度。
 
 #### 代码示例
 
@@ -322,7 +344,7 @@ class BarrageAdapter(dataSource: ArrayList<Barrage>): RecyclerView.Adapter<Recyc
 
 #### 技术挑战
 
-SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 UI 层做了节流，数据层持有的这个巨大数组也会持续侵占内存，最终导致应用闪退。
+SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 UI 层做了节流，数据层持有的这个巨大数组也会持续占用内存，最终导致应用闪退。
 
 #### 优化方案：固定容量的循环数组 (Circular Buffer)
 
@@ -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/live/android/live-base-beauty.md

@@ -14,16 +14,17 @@
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 BaseBeautyStore 相关的核心概念：
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| `BaseBeautyState` | `data class` | 代表基础美颜模块的当前状态。包含了当前生效的磨皮 (`smoothLevel`)、美白 (`whitenessLevel`) 和红润 (`ruddyLevel`) 的强度值。 |
-| `BaseBeautyStore` | `abstract class` | 这是与基础美颜功能交互的核心管理类。它是一个全局单例 (`shared`)，负责所有基础美颜参数的设置、重置和状态同步。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|`BaseBeautyState`|`data class`|代表基础美颜模块的当前状态。包含了当前生效的磨皮 (`smoothLevel`)、美白 (`whitenessLevel`) 和红润 (`ruddyLevel`) 的强度值。|
+|`BaseBeautyStore`|`abstract class`|这是与基础美颜功能交互的核心管理类。它是一个全局单例 (`shared`)，负责所有基础美颜参数的设置、重置和状态同步。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 开始直播 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
 
 ### 步骤2：获取实例并监听状态
 
@@ -151,12 +152,13 @@ class BeautyManager() {
 ### 基础美颜与高级美颜对比
 
 AtomicXCore 也提供了高级美颜支持，以满足不同场景的需求：
-| **对比项** | **基础美颜 (BaseBeautyStore)** | **高级美颜 (TEBeautyKit 需额外集成)** |
-| --- | --- | --- |
-| 核心功能 | 磨皮、美白、红润 | 包含基础美颜，并增加 V脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果 |
-| 计费 | 免费 (包含在 AtomicXCore 授权内) | 付费（需要额外购买腾讯特效 SDK License） |
-| 集成方式 | 默认内置，直接使用 `BaseBeautyStore.shared()` | 需要额外集成 `TEBeautyKit` 组件并进行鉴权 |
-| 推荐场景 | 对美颜要求不高，需要快速实现基础美颜功能的场景 | 对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景 |
+
+|**对比项**|**基础美颜 (BaseBeautyStore)**|**高级美颜 (TEBeautyKit 需额外集成)**|
+|---------|---------|---------|
+|核心功能|磨皮、美白、红润。|包含基础美颜，并增加 V 脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果。|
+|计费|免费 (包含在 AtomicXCore 授权内)。|付费（需要额外购买腾讯特效 SDK License）。|
+|集成方式|默认内置，直接使用 `BaseBeautyStore.shared()`。|需要额外集成 `TEBeautyKit` 组件并进行鉴权。|
+|推荐场景|对美颜要求不高，需要快速实现基础美颜功能的场景。|对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景。|
 
 ### 集成高级美颜
 
@@ -165,10 +167,11 @@ AtomicXCore 也提供了高级美颜支持，以满足不同场景的需求：
 ## API 文档
 
 关于 [BaseBeautyStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-base-beauty-store/index.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Android/index.html) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| Store/Component | 功能描述 | API 文档 |
-| --- | --- | --- |
-| BaseBeautyStore | 基础美颜：调节磨皮 / 美白 / 红润（0-9 级），重置美颜状态，同步效果参数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-base-beauty-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 文档|
+|---------|---------|---------|
+|BaseBeautyStore|基础美颜：调节磨皮 / 美白 / 红润（0-9 级），重置美颜状态，同步效果参数。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-base-beauty-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)|
 
 ## 常见问题