@tencentcloud/sdk-mcp 1.3.9 → 1.4.1

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

@@ -1,8 +1,5 @@
 `LiveListStore` 是 `AtomicXCore` 中负责管理直播房间列表、创建、加入以及维护房间状态的核心模块。通过`LiveListStore`，您可以为您的应用构建完整的直播生命周期管理。
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100032603567/a3e16b96b00111f0bb7b525400bf7822.png)
-
-
 ## 核心功能
 - **直播列表拉取**：获取当前所有公开的直播间列表，支持分页加载。
 
@@ -14,58 +11,21 @@
 
 - **自定义业务数据**：强大的自定义元数据（`MetaData`）能力，允许您在房间内存储和同步任何业务相关的信息，例如直播状态、音乐信息、自定义角色等 。
 
-
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 `LiveListStore` 相关的几个核心概念：
-<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" >`LiveInfo`</td>
-
-<td rowspan="1" colSpan="1" >`data class`</td>
-
-<td rowspan="1" colSpan="1" >代表一个直播间的所有信息模型。包含了直播ID (`liveID`)、名称 (`liveName`)、房主信息 (`liveOwner`) 以及自定义元数据 (`metaData`) 等。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveListState`</td>
-
-<td rowspan="1" colSpan="1" >`data class`</td>
-
-<td rowspan="1" colSpan="1" >代表直播列表模块的当前状态。其核心属性 liveList 是一个 `StateFlow`，存储了拉取到的直播列表；`currentLive` 则代表用户当前所在的直播间信息。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveListListener`</td>
-
-<td rowspan="1" colSpan="1" >`abstract class`</td>
-
-<td rowspan="1" colSpan="1" >代表直播房间的全局事件。分为 `onLiveEnded` (直播结束) 和 `onKickedOutOfLive` (被踢出直播) 两种，用于处理关键的房间状态变更。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveListStore`</td>
-
-<td rowspan="1" colSpan="1" >`abstract class`</td>
-
-<td rowspan="1" colSpan="1" >代表直播房间的全局事件。分为 `.onLiveEnded` (直播结束) 和 `.onKickedOutOfLive` (被踢出直播) 两种，用于处理关键的房间状态变更。</td>
-</tr>
-</table>
-
+| **核心概念** | **类型** | **核心职责与描述** |
+| --- | --- | --- |
+| `LiveInfo` | `data class` | 代表一个直播间的所有信息模型。包含了直播ID (`liveID`)、名称 (`liveName`)、房主信息 (`liveOwner`) 以及自定义元数据 (`metaData`) 等。 |
+| `LiveListState` | `data class` | 代表直播列表模块的当前状态。其核心属性 liveList 是一个 `StateFlow`，存储了拉取到的直播列表；`currentLive` 则代表用户当前所在的直播间信息。 |
+| `LiveListListener` | `abstract class` | 代表直播房间的全局事件。分为 `onLiveEnded` (直播结束) 和 `onKickedOutOfLive` (被踢出直播) 两种，用于处理关键的房间状态变更。 |
+| `LiveListStore` | `abstract class` | 代表直播房间的全局事件。分为 `.onLiveEnded` (直播结束) 和 `.onKickedOutOfLive` (被踢出直播) 两种，用于处理关键的房间状态变更。 |
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 [开始直播](https://write.woa.com/document/191126372105478144) 集成 **AtomicXCore**，并完成 [主播开播](https://write.woa.com/document/191126372105478144) 和 [观众观看](https://write.woa.com/document/191126372105478144) 的功能实现。
+请参考 开始直播 集成 **AtomicXCore**，并完成 主播开播 和 观众观看 的功能实现。
 
 ### 步骤2：实现观众从直播列表进入直播间
 
@@ -135,7 +95,6 @@ class LiveListActivity : AppCompatActivity() {
         startActivity(intent)
     }
 
-
     // --- RecyclerView 相关方法 ---
     private fun setupUI() {
         recyclerView = findViewById(R.id.recyclerView)
@@ -187,80 +146,16 @@ class LiveListAdapter(
 ```
 
 **LiveInfo 参数说明**
-<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" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >直播间的唯一标识符</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`liveName`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >直播间的标题</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`coverURL`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >直播间的封面图片地址</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`liveOwner`</td>
-
-<td rowspan="1" colSpan="1" >[LiveUserInfo](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-user-info/index.html)</td>
-
-<td rowspan="1" colSpan="1" >房主的个人信息</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`totalViewerCount`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >直播间的总观看人数</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`categoryList`</td>
-
-<td rowspan="1" colSpan="1" >`List<Int>`</td>
-
-<td rowspan="1" colSpan="1" >直播间的分类标签列表</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`notice`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >直播间的公告信息</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`metaData`</td>
-
-<td rowspan="1" colSpan="1" >`Map<String: String>`</td>
-
-<td rowspan="1" colSpan="1" >开发者自定义的元数据，用于实现复杂的业务场景</td>
-</tr>
-</table>
-
+| **参数名** | **类型** | **描述** |
+| --- | --- | --- |
+| `liveID` | `String` | 直播间的唯一标识符 |
+| `liveName` | `String` | 直播间的标题 |
+| `coverURL` | `String` | 直播间的封面图片地址 |
+| `liveOwner` | [LiveUserInfo](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-user-info/index.html) | 房主的个人信息 |
+| `totalViewerCount` | `Int` | 直播间的总观看人数 |
+| `categoryList` | `List<Int>` | 直播间的分类标签列表 |
+| `notice` | `String` | 直播间的公告信息 |
+| `metaData` | `Map<String: String>` | 开发者自定义的元数据，用于实现复杂的业务场景 |
 
 ## 功能进阶
 
@@ -268,9 +163,6 @@ class LiveListAdapter(
 
 在 App 的直播广场页，顶部设有"热门"、"音乐"、"游戏"等分类标签。用户点击不同的标签后，下方的直播列表会动态筛选，只展示对应分类的直播间，从而帮助用户快速发现感兴趣的内容。
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100032603567/ecdcbe1db00311f09e195254007c27c5.png)
-
-
 #### 实现方式
 
 核心是利用 `LiveInfo` 模型中的 `categoryList` 属性。当主播开播设置分类后，`fetchLiveList` 返回的 `LiveInfo` 对象中就会包含这些分类信息。您的 App 在获取到完整的直播列表后，只需在客户端根据用户选择的分类，对这个列表进行一次简单的筛选，然后刷新 UI 即可。
@@ -363,9 +255,6 @@ class LiveListActivity : AppCompatActivity() {
 
 #### 交互流程图
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100032603567/81f42bdcb00411f0a6a2525400e889b2.webp)
-
-
 #### 实现方式
 
 `LiveCoreView` 支持多实例使用，我们为每一个 `RecyclerView.ViewHolder` 都创建一个独立的 `LiveCoreView` 实例。通过监听 `RecyclerView` 的滚动状态，我们可以精确地控制即将出现和已经离开屏幕的 ViewHolder 中的 `LiveCoreView` 何时开始和停止拉流，从而实现“即滑即播、即走即停”的效果。
@@ -388,7 +277,7 @@ import io.trtc.tuikit.atomicxcore.api.view.LiveCoreView
 // 1. 自定义 RecyclerView.ViewHolder，内部包含一个 LiveCoreView
 class LiveFeedViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
     private var liveCoreView: LiveCoreView? = null
-    
+
     fun setLiveInfo(liveInfo: LiveInfo) {
         // 为新的直播信息创建一个新的 LiveCoreView
         liveCoreView = LiveCoreView(itemView.context, viewType = CoreViewType.PLAY_VIEW)
@@ -404,7 +293,7 @@ class LiveFeedViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
     fun startPlay(roomId: String) {
         liveCoreView?.startPreviewLiveStream(roomId, false, callback = null)
     }
-    
+
     fun stopPlay(roomId: String) {
         liveCoreView?.stopPreviewLiveStream(roomId)
     }
@@ -412,7 +301,7 @@ class LiveFeedViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
 
 // 2. 在 Activity 中管理播放逻辑
 class LiveFeedActivity : AppCompatActivity() {
-    
+
     private lateinit var recyclerView: RecyclerView
     private var liveList: List<LiveInfo> = emptyList()
     private var currentPlayingPosition: Int = -1
@@ -456,7 +345,7 @@ class LiveFeedActivity : AppCompatActivity() {
                     currentViewHolder.stopPlay(liveInfo.liveID)
                 }
             }
-            
+
             // 开始新的播放
             val newViewHolder = recyclerView.findViewHolderForAdapterPosition(position)
             if (newViewHolder is LiveFeedViewHolder) {
@@ -466,13 +355,13 @@ class LiveFeedActivity : AppCompatActivity() {
             }
         }
     }
-    
+
     // RecyclerView Adapter
     inner class LiveFeedAdapter(
         private var liveList: List<LiveInfo>,
         private val onItemClick: (Int) -> Unit
     ) : RecyclerView.Adapter<LiveFeedViewHolder>() {
-        
+
         override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): LiveFeedViewHolder {
             val view = LayoutInflater.from(parent.context)
                 .inflate(R.layout.item_live_feed, parent, false)
@@ -496,9 +385,6 @@ class LiveFeedActivity : AppCompatActivity() {
 
 在电商直播中，主播正在讲解一款商品。此时，所有观众的直播画面下方都会弹出一张商品卡片，实时展示该商品的图片、名称和价格。当主播切换讲解下一件商品时，所有观众端的卡片都会自动、同步更新。
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100032603567/5b85e0b5b00611f0995e525400454e06.png)
-
-
 #### 实现方式
 
 主播端将当前商品的结构化信息（建议使用 **JSON **格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需订阅 `LiveListStore.liveState.currentLive`，监听 `metaData` 的变化，一旦发现 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
@@ -534,10 +420,8 @@ class YourAnchorActivity : AppCompatActivity() {
             }
             val jsonString = jsonObject.toString()
 
-
             val metaData = hashMapOf("product_info" to jsonString)
 
-
             // 使用全局单例的 liveListStore 来更新 metaData
             LiveListStore.shared().updateLiveMetaData(
                 metaData,
@@ -612,32 +496,10 @@ class YourAudienceActivity : AppCompatActivity() {
 ## API 文档
 
 关于 [LiveListStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-list-store/index.html) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Android/index.html) 框架的官方 API 文档。本文档使用到的相关 Store 如下：
-<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" >LiveCoreView</td>
-
-<td rowspan="1" colSpan="1" >直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。</td>
-
-<td rowspan="1" colSpan="1" >[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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >LiveListStore</td>
-
-<td rowspan="1" colSpan="1" >直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-list-store/index.html)</td>
-</tr>
-</table>
-
+| 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) |
+| LiveListStore | 直播间全生命周期管理：创建 / 加入 / 离开 / 销毁房间，查询房间列表，修改直播信息（名称、公告等），监听直播状态（例如被踢出、结束）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-live-list-store/index.html) |
 
 ## 常见问题
 

package/resource/doc/livekit/core-sdk/live/flutter/api-reference/AudioEffectStore.md

@@ -0,0 +1,279 @@
+## 简介
+
+**AudioEffectStore** 提供了一套完整的音效管理 API，包括变声效果、混响效果和耳返功能。
+通过该类，主播可以在直播过程中实时调整自己的声音效果，提升直播体验。
+
+> **重要：**
+>
+
+> 使用 **shared** 单例获取 **AudioEffectStore** 实例。设置的音效在退出房间后会自动失效，下次进房需要重新设置。
+>
+
+> **说明：**
+>
+
+> 音效状态更新通过 **audioEffectState** 发布者传递。订阅它以接收有关变声、混响和耳返状态的实时更新。
+>
+
+> **警告：**
+>
+
+> 由于蓝牙耳机的硬件延迟非常高，在主播佩戴蓝牙耳机时无法开启耳返功能。请在用户界面上提示主播佩戴有线耳机。
+>
+
+## 功能特性
+- **变声效果**：支持多种变声特效，如熊孩子、小女孩、大叔等。
+
+- **混响效果**：支持多种混响特效，如KTV、小房间、大会堂等。
+
+- **耳返功能**：主播可在耳机中听到自己的声音，适用于唱歌场景。
+
+- **音量控制**：支持耳返音量的精细调节。
+
+## 可订阅数据
+
+**AudioEffectState** 的字段描述如下：
+| **属性名** | **类型** | **描述** |
+| --- | --- | --- |
+| audioChangerType | ValueListenable<AudioChangerType> | 变声状态。 |
+| audioReverbType | ValueListenable<AudioReverbType> | 混响状态。 |
+| isEarMonitorOpened | ValueListenable<bool> | 耳返开启。 |
+| earMonitorVolume | ValueListenable<int> | 耳返音量，取值范围 0 - 100。<br>如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。 |
+
+## API 列表
+| **函数名** | **描述** |
+| --- | --- |
+| shared | 获取单例实例。 |
+| setAudioChangerType | 设置变声效果。 |
+| setAudioReverbType | 设置混响效果。 |
+| setVoiceEarMonitorEnable | 开启/关闭耳返。 |
+| setVoiceEarMonitorVolume | 设置耳返音量。 |
+| reset | 重置为默认状态。 |
+
+### 获取实例
+
+#### shared
+
+获取单例实例。
+
+### 变声设置
+
+#### setAudioChangerType
+
+设置变声效果
+``` dart
+void setAudioChangerType(AudioChangerType type);
+```
+
+通过该接口您可以设置人声的变声特效。
+
+变声特效可以作用于人声之上，通过声学算法对人声进行二次处理，以获得与原始声音所不同的音色。
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+**调用时机**
+
+进入房间后，且需要使用变声效果时调用。
+
+**注意事项**
+
+> **说明：**
+>
+
+> 设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。
+>
+
+**参数说明**
+| **参数名** | **类型** | **是否必填** | **描述** |
+| --- | --- | --- | --- |
+| type | AudioChangerType | 必填 | 变声效果类型。 |
+
+### 混响设置
+
+#### setAudioReverbType
+
+设置混响效果
+``` dart
+void setAudioReverbType(AudioReverbType type);
+```
+
+通过该接口您可以设置人声的混响效果。
+
+混响特效可以作用于人声之上，通过声学算法对声音进行叠加处理，模拟出各种不同环境下的临场感受。
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+**调用时机**
+
+进入房间后，且需要使用混响效果时调用。
+
+**注意事项**
+
+> **说明：**
+>
+
+> 设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。
+>
+
+**参数说明**
+| **参数名** | **类型** | **是否必填** | **描述** |
+| --- | --- | --- | --- |
+| type | AudioReverbType | 必填 | 混响效果类型。 |
+
+### 耳返设置
+
+#### setVoiceEarMonitorEnable
+
+开启/关闭耳返
+``` dart
+void setVoiceEarMonitorEnable(bool enable);
+```
+
+主播开启耳返后，可以在耳机里听到麦克风采集到的自己发出的声音，该特效适用于主播唱歌的应用场景中。
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+**适用场景**
+
+适用于主播唱歌场景，让主播能够实时听到自己的声音以便调整演唱效果。
+
+**调用时机**
+
+进入房间后，且主播佩戴有线耳机时调用。
+
+**注意事项**
+
+> **警告：**
+>
+
+> 由于蓝牙耳机的硬件延迟非常高，所以在主播佩戴蓝牙耳机时无法开启此特效，请尽量在用户界面上提示主播佩戴有线耳机。
+>
+
+**参数说明**
+| **参数名** | **类型** | **是否必填** | **描述** |
+| --- | --- | --- | --- |
+| enable | bool | 必填 | 是否开启耳返。 |
+
+#### setVoiceEarMonitorVolume
+
+设置耳返音量
+``` dart
+void setVoiceEarMonitorVolume(int volume);
+```
+
+通过该接口您可以设置耳返特效中声音的音量大小。
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+**调用时机**
+
+开启耳返功能后调用。
+
+**注意事项**
+
+> **说明：**
+>
+
+> 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
+>
+
+**参数说明**
+| **参数名** | **类型** | **是否必填** | **描述** |
+| --- | --- | --- | --- |
+| volume | int | 必填 | 耳返音量。（取值范围：0 - 100（超过 100 可能导致爆音））（默认值：100）。 |
+
+### 重置
+
+#### reset
+
+重置为默认状态
+``` dart
+void reset();
+```
+
+将所有音效设置重置为默认值，包括关闭变声效果、关闭混响效果、关闭耳返并重置耳返音量。
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+**调用时机**
+
+需要恢复默认音效设置时调用，例如退出直播间前。
+
+## 数据结构
+
+### AudioChangerType
+
+变声效果类型。
+| **枚举值** | **值** | **说明** |
+| --- | --- | --- |
+| none | 0 | 关闭特效。 |
+| child | 1 | 熊孩子。 |
+| littleGirl | 2 | 小女孩。 |
+| man | 3 | 大叔。 |
+| heavyMetal | 4 | 重金属。 |
+| cold | 5 | 感冒。 |
+| foreigner | 6 | 外语腔。 |
+| trappedBeast | 7 | 困兽。 |
+| fatso | 8 | 肥宅。 |
+| strongCurrent | 9 | 强电流。 |
+| heavyMachinery | 10 | 重机械。 |
+| ethereal | 11 | 空灵。 |
+
+### AudioReverbType
+
+混响效果类型。
+| **枚举值** | **值** | **说明** |
+| --- | --- | --- |
+| none | 0 | 关闭特效。 |
+| ktv | 1 | KTV。 |
+| smallRoom | 2 | 小房间。 |
+| auditorium | 3 | 大会堂。 |
+| deep | 4 | 低沉。 |
+| loud | 5 | 洪亮。 |
+| metallic | 6 | 金属声。 |
+| magnetic | 7 | 磁性。 |
+
+### AudioEffectState
+
+AudioEffectStore 对外提供的音效相关状态数据。
+| **属性** | **类型** | **说明** |
+| --- | --- | --- |
+| audioChangerType | ValueListenable<AudioChangerType> | 变声状态。 |
+| audioReverbType | ValueListenable<AudioReverbType> | 混响状态。 |
+| isEarMonitorOpened | ValueListenable<bool> | 耳返开启。 |
+| earMonitorVolume | ValueListenable<int> | 耳返音量，取值范围 0 - 100。<br>如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。 |
+
+## 使用示例
+``` dart
+// 获取单例实例
+final store = AudioEffectStore.shared;
+
+// 订阅状态变化
+store.audioEffectState.audioChangerType.addListener(() {
+    print("当前变声效果: ${store.audioEffectState.audioChangerType.value}");
+});
+
+store.audioEffectState.audioReverbType.addListener(() {
+    print("当前混响效果: ${store.audioEffectState.audioReverbType.value}");
+});
+
+// 设置变声效果
+store.setAudioChangerType(AudioChangerType.littleGirl);
+
+// 设置混响效果
+store.setAudioReverbType(AudioReverbType.ktv);
+
+// 开启耳返
+store.setVoiceEarMonitorEnable(true);
+store.setVoiceEarMonitorVolume(80);
+```