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

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

@@ -3,7 +3,7 @@
 ## 核心功能
 
 通过组合 `AudioEffectStore` 和 `DeviceStore`，您将能实现以下核心功能：
-- **人声音量调节**：控制本地音频上行的采集音量大小，即观众听到的主播声音大小。
+- **人声音量调节**：控制本地音频上行的采集音量大小，即观众听到主播声音的大小。
 
 - **耳返功能**：允许主播或连麦用户通过耳机实时听到自己的声音，用于监听和矫正发音。
 
@@ -12,27 +12,28 @@
 - **混响效果**：模拟不同环境的声场效果，例如 KTV、金属声、低沉、洪亮等。
 
 ## 概念说明
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| [AudioEffectState](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectState-class.html) | `class` | 代表音效模块的当前状态，通常用于UI渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。所有属性均为 `ValueListenable` 类型，支持订阅监听。 |
-| [AudioEffectStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectStore-class.html) | `class` | 代表音效模块**单例数据管理类**。通过它您可以调用修改音效接口，当您调用接口后，相应的 `audioEffectState` 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
-| [DeviceState](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceState-class.html) | `class` | 代表设备模块的当前状态，通常用于UI渲染。核心属性包括摄像头、麦克风的设备状态、采集音量等。所有属性均为 `ValueListenable` 类型，支持订阅监听。 |
-| [DeviceStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html) | `class` | 代表设备模块**单例数据管理类**。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的 `state` 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|[AudioEffectState](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectState-class.html)|`class`|代表音效模块的当前状态，通常用于 UI 渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。所有属性均为 `ValueListenable` 类型，支持订阅监听。|
+|[AudioEffectStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectStore-class.html)|`class`|代表音效模块**单例数据管理类**。通过它您可以调用修改音效接口，当您调用接口后，相应的 `audioEffectState` 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。|
+|[DeviceState](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceState-class.html)|`class`|代表设备模块的当前状态，通常用于 UI 渲染。核心属性包括摄像头、麦克风的设备状态、采集音量等。所有属性均为 `ValueListenable` 类型，支持订阅监听。|
+|[DeviceStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html)|`class`|代表设备模块**单例数据管理类**。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的 `state` 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 快速接入 集成 **AtomicXCore**。
+请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：获取 Store 实例
 
-`AudioEffectStore` 和 `DeviceStore` 是单例对象，您可以直接通过 `shared` 属性在项目的任何位置获取实例。
-``` swift
+`AudioEffectStore` 和 `DeviceStore` 是单例对象，您可以直接通过 `shared` 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源 UI demo 项目中的 [audio_effect_panel_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/component/audio_effect/audio_effect_panel_widget.dart) 文件来了解完整的实现逻辑。
+``` java
 import 'package:flutter/material.dart';
-import 'package:atomic_x_core/atomic_x_core.dart';
+import 'package:atomic_x_core/atomicxcore.dart';
 
-class AudioEffectManager {
+class _AudioEffectPanelWidgetState {
   final _audioEffectStore = AudioEffectStore.shared;
   final _deviceStore = DeviceStore.shared;
 }
@@ -51,14 +52,14 @@ class AudioEffectManager {
 #### 实现方式
 1. **开关耳返**：您可以使用 `Switch` 控件实现开关耳返功能。
 
-2. **设置耳返音量值**：您可以使用 `Slider` 控件实现左右拖动滑块来调节音量的功能，并将 `Slider` 的值映射成音量值，调用 `setVoiceEarMonitorVolume(volume)`。请注意，该接口接收的参数范围是 `[0, 150]`，所以您需要将 UI 控件的值（例如 Slider 的 `[0.0, 1.0]`）映射到 `[0, 150]` 的范围。
+2. **设置耳返音量值**：您可以使用 `Slider` 控件实现左右拖动滑块来调节音量的功能，并将 `Slider` 的值映射成音量值，调用 `setVoiceEarMonitorVolume(volume)`。请注意，该接口接收的参数范围是 `[0, 150]`，所以您需要将 UI 控件的值（例如 Slider 的 `0.0 - 1.0`）映射到 `0 - 150` 的范围。
 
 3. **监听状态更新 UI**：您可以订阅实时的耳返状态值更新 UI。
 
 #### 代码示例
-``` swift
+``` java
 import 'package:flutter/material.dart';
-import 'package:atomic_x_core/atomic_x_core.dart';
+import 'package:atomic_x_core/atomicxcore.dart';
 
 /// 耳返控制组件
 class EarMonitorWidget extends StatelessWidget {
@@ -111,28 +112,28 @@ class EarMonitorWidget extends StatelessWidget {
 ```
 
 #### 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)` 方法传入音量值即可。
 
 #### 实现方式
-1. **设置采集音量值**：您可以使用 `Slider` 控件实现左右拖动滑块来调节音量的功能，并将 `Slider` 的值映射成音量值后调用 `setCaptureVolume(volume)`。请注意，该接口接收的参数范围是 `[0, 150]`，所以您需要将 UI 控件的值（例如 Slider 的 `[0.0, 1.0]`）映射到 `[0, 150]` 的范围。
+1. **设置采集音量值**：您可以使用 `Slider` 控件实现左右拖动滑块来调节音量的功能，并将 `Slider` 的值映射成音量值后调用 `setCaptureVolume(volume)`。请注意，该接口接收的参数范围是 `[0, 150]`，所以您需要将 UI 控件的值（例如 Slider 的 `0.0 - 1.0`）映射到 `0 - 150` 的范围。
 
 2. **监听状态更新 UI**：您可以订阅实时的音量状态值更新 UI。
 
 #### 代码示例
-``` swift
+``` java
 import 'package:flutter/material.dart';
-import 'package:atomic_x_core/atomic_x_core.dart';
+import 'package:atomic_x_core/atomicxcore.dart';
 
 /// 人声音量控制组件
 class CaptureVolumeWidget extends StatelessWidget {
@@ -165,18 +166,18 @@ class CaptureVolumeWidget extends StatelessWidget {
 ```
 
 #### 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 枚举值即可切换效果。
 
 #### 代码示例
-``` swift
+``` java
 import 'package:flutter/material.dart';
-import 'package:atomic_x_core/atomic_x_core.dart';
+import 'package:atomic_x_core/atomicxcore.dart';
 
 /// 变声效果选择组件
 class VoiceChangerWidget extends StatelessWidget {
@@ -238,18 +239,19 @@ class VoiceChangerWidget extends StatelessWidget {
 ```
 
 #### setAudioChangerType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `type` | [AudioChangerType](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioChangerType.html) | 变声效果枚举。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`type`|[AudioChangerType](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioChangerType.html)|变声效果枚举。|
 
 ### 步骤6：实现混响效果
 
 当主播希望给自己的声音添加混响效果时，您可以调用 `setAudioReverbType(type)` 方法，传入相应的 Type 枚举值即可切换效果。
 
 #### 代码示例
-``` swift
+``` java
 import 'package:flutter/material.dart';
-import 'package:atomic_x_core/atomic_x_core.dart';
+import 'package:atomic_x_core/atomicxcore.dart';
 
 /// 混响效果选择组件
 class ReverbWidget extends StatelessWidget {
@@ -319,16 +321,17 @@ class ReverbWidget extends StatelessWidget {
 ```
 
 #### setAudioReverbType 接口参数
-| **参数名** | **类型** | **描述** |
-| --- | --- | --- |
-| `type` | [AudioReverbType](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioReverbType.html) | 混响效果枚举。 |
+
+|**参数名**|**类型**|**描述**|
+|---------|---------|---------|
+|`type`|[AudioReverbType](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioReverbType.html)|混响效果枚举。|
 
 ### 步骤7：重置音效设置
 
 > **重要：**
 >
 
-> `AudioEffectStore` 和 `DeviceStore` 是单例，即音效和设备设置会全局生效，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
+> AudioEffectStore 和 DeviceStore 是单例，即音效和设备设置会全局生效，如果您不希望当前直播间的设置影响到之后创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
 >
 
 以下两种情况您可能需要重置音效设置：
@@ -336,9 +339,9 @@ class ReverbWidget extends StatelessWidget {
 
 2. **需要重置所有设备和音效设置时**，调用 `store` 的 `reset()` 方法实现音效重置。
 
-   ``` swift
+   ``` java
    import 'package:flutter/material.dart';
-   import 'package:atomic_x_core/atomic_x_core.dart';
+   import 'package:atomic_x_core/atomicxcore.dart';
 
    /// 音效重置组件
    class AudioEffectResetWidget extends StatelessWidget {
@@ -360,9 +363,9 @@ class ReverbWidget extends StatelessWidget {
    ```
 
 ## 完整示例
-``` swift
+``` java
 import 'package:flutter/material.dart';
-import 'package:atomic_x_core/atomic_x_core.dart';
+import 'package:atomic_x_core/atomicxcore.dart';
 
 /// 音效设置页面
 class AudioEffectPage extends StatelessWidget {
@@ -559,32 +562,33 @@ class AudioEffectPage extends StatelessWidget {
 
 ## API 文档
 
-关于 [AudioEffectStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectStore-class.html) 和 [DeviceStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html) 及其相关类的所有公开接口、属性的详细信息，请参考 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter) 框架的官方 API 文档。
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **AudioEffectStore** | 音效管理：进行音效设置，并获取实时音效状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectStore-class.html) |
-| **DeviceStore** | 设备管理：进行摄像头、麦克风操作，并获取实时设备状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html) |
+关于 [AudioEffectStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectStore-class.html) 和 [DeviceStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html) 及其相关类的所有公开接口、属性的详细信息，请参阅 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter/index.html) 框架的官方 API 文档。
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**AudioEffectStore**|音效管理：进行音效设置，并获取实时音效状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_audio_effect_store/AudioEffectStore-class.html)|
+|**DeviceStore**|设备管理：进行摄像头、麦克风操作，并获取实时设备状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_device_device_store/DeviceStore-class.html)|
 
 ## 常见问题
 
-### 音效和设备接口的调用时机有没有要求？
+### 音效和设备接口的调用时机是否有要求？
 
 没有限制。`AudioEffectStore` 和 `DeviceStore` 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。
 
-### “人声音量” 和“耳返音量” 有什么区别？
+### "人声音量" 和"耳返音量" 有什么区别？
 
 这是一个非常重要且易混淆的概念，区别如下：
-- **人声音量 (CaptureVolume)：**通过 `DeviceStore.shared.setCaptureVolume()` 设置。它决定了观众能听到的您的声音大小。
+- **人声音量 (CaptureVolume)：**通过 `DeviceStore.shared.setCaptureVolume()` 设置。它决定了观众能听到主播的声音大小。
 
-- **耳返音量 (EarMonitorVolume)：**通过 `AudioEffectStore.shared.setVoiceEarMonitorVolume()` 设置。它只决定了您自己在耳机里听到的监听声音大小，不会影响观众。
+- **耳返音量 (EarMonitorVolume)：**通过 `AudioEffectStore.shared.setVoiceEarMonitorVolume()` 设置。它只决定了主播在耳机里听到的监听声音大小，**不会**影响观众。
 
 ### 新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？
 
 `AudioEffectStore` 和 `DeviceStore` 是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用 `reset()` 方法重置。
 
-### 耳返功能无法正常工作
+### 为什么我开启了"耳返"，但是听不到自己的声音？
 
-请按照以下步骤检查：
+请您按照以下步骤检查：
 1. **是否插入耳机**：耳返功能绝大多数情况下依赖耳机才能生效，请确保已连接有线或蓝牙耳机。
 
 2. **音量是否为0**：检查“耳返音量”是否被设置为 0。

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

@@ -12,19 +12,21 @@
 - 在本地消息列表中插入系统提示（例如，"欢迎 XX 进入直播间"）。
 
 ## 核心概念解析
-| **核心概念** | **类型** | **核心职责与描述** |
-| --- | --- | --- |
-| [Barrage](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/Barrage-class.html) | `class` | 代表一条弹幕消息的数据模型。它包含了发送者信息 (`sender`)、消息内容 (`textContent` 或 `data`)、消息类型 (`messageType`) 等所有关键信息。 |
-| [BarrageState](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageState-class.html) | `class` | 代表弹幕模块的当前状态。其核心属性 `messageList` 是一个 `ValueListenable<List<Barrage>>`，按时间顺序存储了当前直播间的所有弹幕消息，是 UI 渲染的数据源。 |
-| [BarrageStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageStore-class.html) | `class` | 这是与弹幕功能交互的核心管理类。通过它，您可以发送消息 (`sendTextMessage`, `sendCustomMessage`)，并通过监听其 `barrageState.messageList` 属性来接收和监听所有弹幕消息的更新。 |
+
+|**核心概念**|**类型**|**核心职责与描述**|
+|---------|---------|---------|
+|[Barrage](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/Barrage-class.html)|`class`|代表一条弹幕消息的数据模型。它包含了发送者信息 (`sender`)、消息内容 (`textContent` 或 `data`)、消息类型 (`messageType`) 等所有关键信息。|
+|[BarrageState](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageState-class.html)|`class`|代表弹幕模块的当前状态。其核心属性 `messageList` 是一个 `ValueListenable<List<Barrage>>`，按时间顺序存储了当前直播间的所有弹幕消息，是 UI 渲染的数据源。|
+|[BarrageStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_barrage_barrage_store/BarrageStore-class.html)|`class`|这是与弹幕功能交互的核心管理类。通过它，您可以发送消息 (`sendTextMessage`, `sendCustomMessage`)，并通过监听其 `barrageState.messageList` 属性来接收和监听所有弹幕消息的更新。|
 
 ## 实现步骤
 
 ### 步骤1：组件集成
+- **视频直播**：请参考 开播与观看 集成 **AtomicXCore**，完成接入。
 
-请参考 快速接入 集成 **AtomicXCore**，完成接入。
+- **语聊房**：请参考 开播与收听 集成 **AtomicXCore**，完成接入。
 
-完成集成后回到当前工程。
+   完成集成后回到当前工程。
 
 ### 步骤2：初始化并监听弹幕
 
@@ -98,10 +100,11 @@ extension BarrageManagerSend on BarrageManager {
 ```
 
 **接口参数：**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `text` | `String` | 要发送的文本内容。 |
-| `extensionInfo` | `Map<String, String>?` | 附加的扩展信息，可用于业务自定义。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`text`|`String`|要发送的文本内容。|
+|`extensionInfo`|`Map<String, String>?`|附加的扩展信息，可用于业务自定义。|
 
 ### 步骤4：发送自定义弹幕
 
@@ -138,10 +141,11 @@ extension BarrageManagerCustom on BarrageManager {
 ```
 
 **接口参数：**
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `businessID` | `String` | 业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。 |
-| `data` | `String` | 业务数据，通常为 JSON 格式的字符串。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`businessID`|`String`|业务唯一标识符，例如 "live_gift"，用于接收端区分不同的自定义消息。|
+|`data`|`String`|业务数据，通常为 JSON 格式的字符串。|
 
 ### 步骤5：在本地插入提示消息
 
@@ -374,7 +378,7 @@ SDK 会以极高频率返回完整的弹幕列表。如果每次都重建 UI，
 
 #### **优化方案: **批处理与流量削峰 (Batch Processing & Debouncing)
 
-不必响应每一次的数据更新，而是设定一个时间阈值（例如300毫秒）。只在距离上次 UI 刷新超过这个阈值后，才执行下一次刷新操作。这能将每秒数十次的 UI重绘，降低到每秒3-4次，极大提升流畅度。
+不必响应每一次的数据更新，而是设定一个时间阈值（例如300毫秒）。只在距离上次 UI 刷新超过这个阈值后，才执行下一次刷新操作。这能将每秒数十次的 UI 重绘，降低到每秒3-4次，极大提升流畅度。
 ``` java
 class BarrageUIManager {
   List<Barrage>? _latestMessageList;
@@ -419,7 +423,7 @@ class BarrageUIManager {
 
 #### 技术挑战
 
-SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 UI 层做了节流，数据层持有的这个巨大数组也会持续侵占内存，最终导致应用闪退。
+SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使 UI 层做了节流，数据层持有的这个巨大数组也会持续占用内存，最终导致应用闪退。
 
 #### **优化方案**：固定容量的循环数组 (Circular Buffer)
 
@@ -480,12 +484,20 @@ void _refreshUIIfNeeded() {
 
 `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：客户端无感获取 **
 

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

@@ -13,7 +13,7 @@
 
 ### 步骤1：组件集成
 
-请参考 快速接入 集成 **AtomicXCore**。
+请参考 开播与收听 集成 **AtomicXCore**。
 
 > **说明：**
 >
@@ -21,7 +21,7 @@
 > 在开始实现连麦功能之前，您需要获取 `liveId`（直播间唯一标识），用于区分不同的直播房间。获取方式如下
 >
 > - **主播端**：通过 `LiveListStore.shared.createLive(liveInfo)` 创建直播时指定。
-> - **观众端**：通过`LiveListState.liveList.value`中的 `liveInfo` 获取，或由主播分享直播间 ID 获取。
+> - **观众端**：通过 `LiveListState.liveList.value` 中的 `liveInfo` 获取，或由主播分享直播间 ID 获取。
 
 ### 步骤2：实现观众申请上麦
 
@@ -383,15 +383,17 @@ void dispose() {
 ```
 
 #### closeRemoteMicrophone 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被操作的用户 `userID`。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被操作的用户 `userID`。|
 
 #### openRemoteMicrophone 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被操作的用户 `userID`。 |
-| `policy` | `DeviceControlPolicy` | 打开麦克风的策略。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被操作的用户 `userID`。|
+|`policy`|`DeviceControlPolicy`|打开麦克风的策略。|
 
 ### 主播将麦上用户踢下麦位
 
@@ -421,9 +423,10 @@ _guestListener = GuestListener(
 ```
 
 #### kickUserOutOfSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `userID` | `String` | 被踢下麦的用户 `userID`。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`userID`|`String`|被踢下麦的用户 `userID`。|
 
 ### 主播锁定和解锁麦位
 
@@ -450,14 +453,16 @@ if (result2.isSuccess) {
 ```
 
 #### lockSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `seatIndex` | `int` | 需要锁定的麦位索引。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`seatIndex`|`int`|需要锁定的麦位索引。|
 
 #### unlockSeat 接口参数：
-| **参数** | **类型** | **描述** |
-| --- | --- | --- |
-| `seatIndex` | `int` | 需要解锁的麦位索引。 |
+
+|**参数**|**类型**|**描述**|
+|---------|---------|---------|
+|`seatIndex`|`int`|需要解锁的麦位索引。|
 
 ### 移动麦位
 
@@ -483,30 +488,31 @@ if (result.isSuccess) {
 ```
 
 #### moveUserToSeat 接口参数：
-| **参数** | **类型** | **描述** |
+| <strong>参数</strong> | <strong>类型</strong> | <strong>描述</strong> |
 | --- | --- | --- |
-| `userID` | `String` | 需要移麦的用户 `userID`。 |
-| `targetIndex` | `int` | 目标麦位索引。 |
-| `policy` | `MoveSeatPolicy` | 目标麦位已被占用时的处理策略:<br>- `abortWhenOccupied`：目标麦位有人时放弃移动（默认策略）<br>- `forceReplace`：强制替换目标麦位上的用户，被替换的用户将会被踢下麦。<br>- `swapPosition`：与目标麦位用户交换。 |
+| <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>：与目标麦位用户交换。 |
 
 ## API 文档
 
 关于 [CoGuestStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html) 和 [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatStore-class.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Flutter) 框架的官方 API 文档。本指南使用到的相关 Store 如下：
-| **Store/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **CoGuestStore** | 观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html) |
-| **LiveSeatStore** | 麦位管理：静音/解除静音，锁定/解锁麦位，踢人下麦、远程控制麦上用户麦克风，麦列表状态监听。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatStore-class.html) |
+
+|**Store/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**CoGuestStore**|观众连麦管理：连麦申请 / 邀请 / 同意 / 拒绝，连麦成员权限控制（麦克风 / 摄像头），状态同步。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_guest_store/CoGuestStore-class.html)|
+|**LiveSeatStore**|麦位管理：静音/解除静音，锁定/解锁麦位，踢人下麦、远程控制麦上用户麦克风，麦列表状态监听。|[API 文档](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_live_seat_store/LiveSeatStore-class.html)|
 
 ## 常见问题
 
 ### 语音房连麦和视频直播连麦的实现有何不同？
 
 两者的主要区别在于业务形态与 UI 展现：
-- 视频直播：核心是视频画面。您会使用 `LiveCoreWidget` 作为核心组件来渲染主播和连麦观众的视频流。UI 的重点是处理视频画面的布局、大小，以及通过 `VideoViewDelegate` 在视频流上添加挂件（如昵称、占位图）。您可以同时打开摄像头、麦克风。
+- 视频直播：核心是视频画面。您会使用 `LiveCoreWidget` 作为核心组件来渲染主播和连麦观众的视频流。UI 的重点是处理视频画面的布局、大小，以及通过 `VideoViewDelegate` 在视频流上添加挂件（例如昵称、占位图）。您可以同时打开摄像头、麦克风。
 
 - 语音房（语聊房）：核心是麦位网格。您不会使用 `LiveCoreWidget`，而是会基于 `LiveSeatStore` 的 `liveSeatState`（特别是 `seatList`）来构建一个网格 UI（例如 `GridView`）。UI 的重点是实时显示每个麦位 `SeatInfo` 的状态：是否有人、是否静音、是否被锁定，以及是否正在说话。您只需要打开麦克风。
 
-### 如何在 UI 上实时刷新麦位信息（如是否有人、是否静音）？
+### 如何在 UI 上实时刷新麦位信息（例如是否有人、是否静音）？
 
 您应该订阅 `LiveSeatState` 中的 `seatList` 属性，它是一个 `ValueListenable<List<SeatInfo>>` 类型的响应式数据，每当数组变化时都会通知您重新渲染麦位列表。遍历此数组，您可以：
 - 通过 `seatInfo.userInfo` 来获取麦位上的用户信息。