@tencentcloud/sdk-mcp 1.3.8 → 1.4.0

package/resource/doc/livekit/core-sdk/voice/android/voice-integration.md

@@ -0,0 +1,509 @@
+本文档将帮助开发者使用 `AtomicXCore SDK`的 `LiveListStore` 和 `LiveSeatStore`  快速构建一个包含主播开播和观众进房功能的语聊房 `App`。
+
+## 核心概念
+
+在开始集成之前，我们先通过下表了解一下 `LiveSeatStore` 相关的几个核心概念：
+| **核心概念** | **类型** | **核心职责与描述** |
+| --- | --- | --- |
+| `LiveSeatStore` | `abstract class` | 麦位管理核心，负责管理房间内的所有麦位信息和麦位相关操作。<br>通过 `liveSeatState.seatList` 暴露实时的麦位列表数据流。 |
+| `LiveSeatState` | `data class` | 代表麦位的当前状态。<br>- `seatList` ：是一个 `StateFlow`，存储了麦位列表的实时状态。<br>- `speakingUsers` ：则代表当前正在说话的人和对应的音量。 |
+| `SeatInfo` | `data class` | 单个麦位的数据模型。` LiveSeatStore` 所推送的麦位列表（`seatList`）就是由多个 `SeatInfo` 对象组成的。<br>关键字段：<br>- `index`：麦位的索引（位置）。<br>- `isLocked `：麦位是否被锁定。<br>- `userInfo`： 麦位上的用户信息。如果麦位为空，此字段也为空对象。 |
+| `SeatUserInfo` | `data class` | 麦上用户的详细数据模型。 当一个用户成功上麦后，`SeatInfo` 中的 `userInfo` 字段就会被填充为此用户。<br>关键字段：<br>- `userID`：  用户的唯一 ID。<br>- `userName`：  用户的昵称。<br>- `avatarURL`：  用户的头像 URL。<br>- `microphoneStatus`： 麦克风状态（开/关）。<br>- `cameraStatus`：  摄像头状态（开/关）。 |
+
+## 准备工作
+
+### 步骤1：开通服务
+
+请参见 开通服务，获取体验版或付费版 `SDK`。
+
+### 步骤2：在当前项目中导入 AtomicXCore
+
+**安装组件**：请在您的 `build.gradle` 文件中添加 `implementation 'com.tencent.atomicx:atomicxcore:latest'`  依赖，然后执行 `Gradle Sync`。
+``` gradle
+dependencies {
+    implementation 'io.trtc.uikit:atomicx-core:latest.release'
+    api "io.trtc.uikit:rtc_room_engine:latest.release"
+    api "com.tencent.liteav:LiteAVSDK_Professional:latest.release"
+    api "com.tencent.imsdk:imsdk-plus:latest.release"
+    // 其他依赖...
+}
+```
+
+### 步骤3：实现登录逻辑
+
+在项目中调用 `LoginStore.shared.login` 完成登录，**这是使用 **`AtomicXCore`** 所有功能的关键前提**。
+
+> **重要：**
+>
+
+> 推荐在您 `App` 自身的用户账户登录成功后，再调用 `LoginStore.shared.login`，以确保登录业务逻辑的清晰和一致。
+>
+
+``` java
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import io.trtc.tuikit.atomicxcore.api.login.LoginStore
+import io.trtc.tuikit.atomicxcore.api.CompletionHandler
+import android.util.Log
+
+class MainActivity : AppCompatActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        LoginStore.shared.login(
+            this,              // context
+            1400000001,        // 替换为 SDKAppID
+            "test_001",        // 替换为 UserID
+            "xxxxxxxxxxx",     // 替换为 UserSig
+            object : CompletionHandler {
+                override fun onSuccess() {
+                    // 登录成功处理
+                    Log.d("Login", "login success");
+                }
+
+                override fun onFailure(code: Int, desc: String) {
+                    // 登录失败处理
+                    Log.e("Login", "login failed, code: $code, error: $desc");
+                }
+            }
+        )
+    }
+}
+```
+
+**登录接口参数说明：**
+| **参数** | **类型** | **说明** |
+| --- | --- | --- |
+| `sdkAppId` | `Int` | 从 [控制台](https://console.cloud.tencent.com/trtc) 获取，通常是以 `140` 或 `160` 开头的10位整数。 |
+| `userID` | `String` | 当前用户的唯一 `ID`，仅包含英文字母、数字、连字符和下划线。为避免多端登录冲突，**请勿使用**`1`、`123`**等简单 ID**。 |
+| `userSig` | `String` | 用于腾讯云鉴权的票据。请注意：<br>- 开发环境：您可以采用本地 `GenerateTestUserSig.genTestSig` 函数生成 `userSig` 或者 通过 [UserSig 辅助工具](https://console.cloud.tencent.com/im/tool-usersig) 生成临时的 `UserSig`。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 `UserSig` 的方式。详细信息请参考 [服务端生成 UserSig](https://cloud.tencent.com/document/product/647/17275)。<br>更多信息请参见 [如何计算及使用 UserSig](https://cloud.tencent.com/document/product/647/17275)。 |
+
+## 搭建基础语聊房
+
+### 步骤1：实现房主创建语聊房
+
+房主开播流程如下，您只需执行以下几步操作，即可快速搭建一个语聊房。
+
+#### **1. 初始化麦位 **`Store`
+
+在您的房主 `Activity` 中，创建一个 `LiveSeatStore` 实例。您需要监听 `liveSeatState.seatList` 的变化，以实时获取麦位数据来渲染您的 `UI`。
+``` java
+import android.os.Bundle
+import android.util.Log
+import androidx.appcompat.app.AppCompatActivity
+import io.trtc.tuikit.atomicxcore.api.device.DeviceStore
+import io.trtc.tuikit.atomicxcore.api.live.LiveListStore
+import io.trtc.tuikit.atomicxcore.api.live.LiveSeatStore
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+
+// YourAnchorActivity 代表您的房主Activity
+class YourAnchorActivity : AppCompatActivity() {
+
+    private lateinit var liveListStore: LiveListStore
+    private lateinit var liveSeatStore: LiveSeatStore
+    private lateinit var deviceStore: DeviceStore
+    private val liveID = "test_voice_room_001"
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_anchor) // 假设您有自己的布局
+
+        // 1. 初始化 Stores
+        liveListStore = LiveListStore.shared()
+        liveSeatStore = LiveSeatStore.create(liveID)
+        deviceStore = DeviceStore.shared()
+
+        // 2. 监听麦位列表变化
+        observeSeatList()
+    }
+
+    private fun observeSeatList() {
+         // 监听 seatList 变化，并更新您的麦位 UI
+         CoroutineScope(Dispatchers.Main).launch {
+             liveSeatStore.liveSeatState.seatList.collect { seatInfoList ->
+                 // 在这里根据 seatInfoList 渲染您的麦位 UI
+                 // 例如：updateMicSeatView(seatInfoList)
+                 Log.d("AnchorActivity", "Seat list updated: ${seatInfoList.size} seats")
+             }
+         }
+    }
+}
+```
+
+#### **2. 打开麦克风**
+
+通过调用 `DeviceStore` 的 `openLocalMicrophone` 接口打开麦克风，示例代码如下：
+``` java
+import androidx.appcompat.app.AppCompatActivity
+import io.trtc.tuikit.atomicxcore.api.device.DeviceStore
+
+class YourAnchorActivity : AppCompatActivity() {
+    // ... 其他代码 ...
+
+    private fun openDevices() {
+        // 1. 打开麦克风
+        DeviceStore.shared().openLocalMicrophone(completion = null)
+    }
+}
+```
+
+#### **3. 开始语聊**
+
+通过调用 `LiveListStore` 的 `createLive` 接口开始语聊房直播，完整示例代码如下：
+``` java
+import android.os.Bundle
+import android.util.Log
+import androidx.appcompat.app.AppCompatActivity
+import io.trtc.tuikit.atomicxcore.api.live.LiveInfo
+import io.trtc.tuikit.atomicxcore.api.live.LiveInfoCompletionHandler
+import io.trtc.tuikit.atomicxcore.api.live.TakeSeatMode
+
+class YourAnchorActivity : AppCompatActivity() {
+    // ... 其他代码 ...
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        // ... 其他代码 ...
+
+        // 开始语聊
+        startLive()
+    }
+
+    private fun startLive() {
+        val liveInfo = LiveInfo().apply {
+            // 设置房间基础信息
+            liveID = this@YourAnchorActivity.liveID
+            liveName = "test 语聊房"
+
+            // 传入所需的麦位数量（例如 9），系统会自动配置麦位开关、房主占位及最大人数
+            seatTemplate = SeatLayoutTemplate.AudioSalon(seatCount = 9)
+
+            // 设置上麦模式（例如申请上麦）
+            seatMode = TakeSeatMode.APPLY
+        }
+
+        // 调用 createLive 开始直播
+        liveListStore.createLive(liveInfo, object : LiveInfoCompletionHandler {
+            override fun onFailure(code: Int, desc: String) {
+                Log.e("Live", "Response startLive onError: $desc")
+            }
+
+            override fun onSuccess(liveInfo: LiveInfo) {
+                Log.d("Live", "Response startLive onSuccess")
+                // 房主创建成功后，默认会上麦，此时您可以调用 unmuteMicrophone
+                liveSeatStore.unmuteMicrophone(null)
+            }
+        })
+    }
+}
+```
+
+`LiveInfo`** 参数说明**
+| **参数名** | **类型** | **属性** | **描述** |
+| --- | --- | --- | --- |
+| `liveID` | `String` | 必填 | 直播间的唯一标识符。 |
+| `liveName` | `String` | 选填 | 直播间的标题。 |
+| `notice` | `String` | 选填 | 直播间的公告信息。 |
+| `isMessageDisable` | `Boolean` | 选填 | 是否禁言（`true`：是，`false`：否）。 |
+| `isPublicVisible` | `Boolean` | 选填 | 是否公开可见（`true`：是，`false`：否）。 |
+| `seatMode` | `TakeSeatMode` | 选填 | 上麦模式（`FREE`：自由上麦，`APPLY`：申请上麦）。 |
+| `seatTemplate` | `SeatLayoutTemplate` | 必填 | 麦位布局模板。 |
+| `coverURL` | `String` | 选填 | 直播间的封面图片地址。 |
+| `backgroundURL` | `String` | 选填 | 直播间的背景图片地址。 |
+| `categoryList` | `List<Int>` | 选填 | 直播间的分类标签列表。 |
+| `activityStatus` | `Int` | 选填 | 直播活动状态。 |
+| `isGiftEnabled` | `Boolean` | 选填 | 是否启用礼物功能（`true`：是，`false`：否）。 |
+
+#### **4. 构建麦位 UI 界面**
+
+> **提示：**
+>
+
+> 麦位 `UI` 效果的业务代码，您也可以参考 `TUILiveKit` 开源项目中的 [SeatGridView.kt](https://github.com/Tencent-RTC/TUILiveKit/blob/main/Android/tuilivekit/src/main/java/com/trtc/uikit/livekit/voiceroomcore/SeatGridView.kt) 文件来了解完整的实现逻辑。
+>
+
+通过 LiveSeatStore 实例，监听 liveSeatState.seatList 的变化，以实时获取麦位数据来渲染您的 UI。您可以在 Activity 中（例如 YourAnchorActivity 或 YourAudienceActivity）通过以下方式监听数据：
+``` java
+import android.os.Bundle
+import android.util.Log
+import androidx.appcompat.app.AppCompatActivity
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+
+class YourAnchorActivity : AppCompatActivity() {
+    // ... 其他代码 ...
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        // ... 其他代码 ...
+
+        // 监听 seatList 变化
+        observeSeatList()
+    }
+
+    private fun observeSeatList() {
+        // 监听 seatList 变化，并更新您的麦位 UI
+        CoroutineScope(Dispatchers.Main).launch {
+            liveSeatStore.liveSeatState.seatList.collect { seatInfoList ->
+                // seatInfoList 即为最新的麦位列表 (List<SeatInfo>),在这里根据 seatInfoList 渲染您的麦位 UI
+                Log.d("AnchorActivity", "Seat list updated: ${seatInfoList.size} seats")
+            }
+        }
+    }
+}
+```
+
+#### **5. 结束语聊**
+
+语聊结束后，房主可以调用 `LiveListStore` 的 `endLive` 接口结束语聊，`SDK` 会处理停止推流和销毁房间的逻辑。
+``` java
+import android.util.Log
+import androidx.appcompat.app.AppCompatActivity
+import com.tencent.cloud.tuikit.engine.extension.TUILiveListManager
+import io.trtc.tuikit.atomicxcore.api.live.StopLiveCompletionHandler
+
+class YourAnchorActivity : AppCompatActivity() {
+    // ... 其他代码 ...
+
+    // 结束语聊
+    private fun stopLive() {
+        liveListStore.endLive(object : StopLiveCompletionHandler {
+            override fun onSuccess(statisticsData: TUILiveListManager.LiveStatisticsData) {
+                Log.d("Live", "endLive success, duration: ${statisticsData.liveDuration}")
+            }
+
+            override fun onFailure(code: Int, desc: String) {
+                Log.e("Live", "endLive error: $desc")
+            }
+        })
+    }
+
+    // 确保在 Activity 销毁时也调用
+    override fun onDestroy() {
+        super.onDestroy()
+        stopLive()
+        Log.d("Live", "YourAnchorActivity onDestroy")
+    }
+}
+```
+
+### 步骤2：实现观众进入语聊房
+
+观众进房流程如下，通过简单几步操作，即可实现观众进入语聊房。
+
+#### **1. 初始化麦位 **`Store`
+
+在您的观众 `Activity` 中，创建 `LiveSeatStore` 实例，并监听 `liveSeatState.seatList` 的变化，以渲染麦位 `UI`。
+``` java
+import io.trtc.tuikit.atomicxcore.api.live.LiveListStore
+import io.trtc.tuikit.atomicxcore.api.live.LiveSeatStore
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+import android.util.Log
+
+// YourAudienceActivity 代表您的观众Activity
+class YourAudienceActivity : AppCompatActivity() {
+
+    private lateinit var liveListStore: LiveListStore
+    private lateinit var liveSeatStore: LiveSeatStore
+    private val liveID = "test_voice_room_001" // 确保 liveID 与房主一致
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_audience) // 假设您有自己的布局
+
+        // 1. 初始化 Stores
+        liveListStore = LiveListStore.shared()
+        liveSeatStore = LiveSeatStore.create(liveID)
+
+        // 2. 监听麦位列表变化
+        observeSeatList()
+    }
+
+    private fun observeSeatList() {
+         // 3. 监听 seatList 变化，并更新您的麦位 UI
+         CoroutineScope(Dispatchers.Main).launch {
+             liveSeatStore.liveSeatState.seatList.collect { seatInfoList ->
+                 // 在这里根据 seatInfoList 渲染您的麦位 UI
+                 // 例如：updateMicSeatView(seatInfoList)
+                 Log.d("AudienceActivity", "Seat list updated: ${seatInfoList.size} seats")
+             }
+         }
+    }
+}
+```
+
+#### **2. 进入语聊房**
+
+通过调用 `LiveListStore` 的 `joinLive` 接口加入语聊房，完整示例代码如下：
+``` java
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import android.util.Log
+import io.trtc.tuikit.atomicxcore.api.live.LiveInfo
+import io.trtc.tuikit.atomicxcore.api.live.LiveInfoCompletionHandler
+
+// YourAudienceActivity 代表您的观众Activity
+class YourAudienceActivity : AppCompatActivity() {
+
+    // ... 其他代码 ...
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_audience) // 假设您有自己的布局
+        // ... 其他代码 ...
+
+        // 进入语聊房
+        joinLive()
+    }
+
+    private fun joinLive() {
+        // 1. 调用 joinLive 进入语聊房
+        liveListStore.joinLive(liveID, object : LiveInfoCompletionHandler {
+            override fun onSuccess(liveInfo: LiveInfo) {
+                Log.d("Live", "joinLive success")
+            }
+            override fun onFailure(code: Int, desc: String) {
+                Log.e("Live", "joinLive error: $desc")
+            }
+        })
+    }
+}
+```
+
+#### **3. 构建麦位 UI 界面**
+
+观众构建麦位 UI 界面的流程与主播完全一致，请参考主播 构建麦位 UI 界面。
+
+#### **4. 退出语聊房**
+
+观众退出语聊房时，需要调用 `LiveListStore` 的 `leaveLive` 接口来退出。
+``` java
+import android.util.Log
+import androidx.appcompat.app.AppCompatActivity
+import io.trtc.tuikit.atomicxcore.api.CompletionHandler
+
+// YourAudienceActivity 代表您的观众Activity
+class YourAudienceActivity : AppCompatActivity() {
+    // ... 其他代码 ...
+
+    private fun leaveLive() {
+        liveListStore.leaveLive(object : CompletionHandler {
+            override fun onSuccess() {
+                Log.d("Live", "leaveLive success")
+            }
+
+            override fun onFailure(code: Int, desc: String) {
+                Log.e("Live", "leaveLive error: $desc")
+            }
+        })
+    }
+
+    // 确保在 Activity 销毁时也调用
+    override fun onDestroy() {
+        super.onDestroy()
+        leaveLive()
+        Log.d("Live", "YourAudienceActivity onDestroy")
+    }
+}
+```
+
+### 运行效果
+
+完成上述步骤后，即可完成一个最基础的语聊直播场景。您可以参考 丰富语聊场景 来完善语聊场景。
+
+## 功能进阶
+
+### **实现麦上用户说话音浪**
+
+在语聊房场景中，一个常见的需求是当麦上用户说话时，在其头像上显示一个波浪动画，以提示全房间用户“谁在说话”，`LiveSeatStore` 提供了 `speakingUsers` 数据流，专门用于实现此功能。
+
+#### 实现效果
+
+#### 实现方式
+
+> **提示：**
+>
+
+> 麦上用户说话时展示波浪动画效果，您也可以参考 `TUILiveKit` 开源项目中的 [SeatGridView.kt](https://github.com/Tencent-RTC/TUILiveKit/blob/main/Android/tuilivekit/src/main/java/com/trtc/uikit/livekit/voiceroomcore/SeatGridView.kt) 文件来了解完整的实现逻辑。
+>
+
+在 `YourAnchorActivity` 中监听 `speakingUsers` 变化，并更新“正在说话”状态，代码示例如下：
+``` java
+import android.os.Bundle
+import android.util.Log
+import androidx.appcompat.app.AppCompatActivity
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+
+// 在 YourAnchorActivity 或 YourAudienceActivity 中
+class YourAnchorActivity : AppCompatActivity() {
+    // ... (省略其他代码) ...
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        // ... (省略其他代码) ...
+
+        // 监听 speakingUsers 变化
+        observeSpeakingUsersState()
+    }
+
+    private fun observeSpeakingUsersState() {
+        // 监听 speakingUsers 变化，并更新“正在说话”状态
+        CoroutineScope(Dispatchers.Main).launch {
+            liveSeatStore.liveSeatState.speakingUsers.collect { speakingUserSet ->
+                // 将 "正在说话" 的用户 ID 集合 传递给 UI , 更新 UI 状态
+                Log.d("AnchorActivity", "Speaking users updated: ${speakingUserSet.size} users")
+            }
+        }
+    }
+}
+```
+
+## 丰富语聊房场景
+
+当您完成了基础的语聊房功能后，您可以参考以下功能指南来为语聊房添加丰富的互动玩法。
+| **功能** | **功能介绍** | **功能 Stores** | **实现指南** |
+| --- | --- | --- | --- |
+| **实现听众上麦** | 听众申请上麦，与房主进行实时语音互动。 | [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) | 观众上麦 |
+| **实现房主跨房连线 PK** | 两个不同房间的主播进行连线，实现互动或 PK。 | [CoHostStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-host-store/index.html)<br>[BattleStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-battle-store/index.html) | 主播连线 & PK |
+| **添加弹幕聊天功能** | 房间内成员可以发送和接收实时文字消息。 | [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) | 实现弹幕功能 |
+| **构建礼物赠送系统** | 观众可以向主播赠送虚拟礼物，增加互动和趣味性。 | [GiftStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.gift/-gift-store/index.html) | 实现礼物功能 |
+
+## API 文档
+| **Store/Component** | **功能描述** | **API 文档** |
+| --- | --- | --- |
+| **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) |
+| **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) |
+| **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) |
+| **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) |
+| **CoHostStore** | 主播跨房连线：支持多布局模板（动态网格等），发起 / 接受 / 拒绝连线，连麦主播互动管理。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-host-store/index.html) |
+| **BattleStore** | 主播 PK 对战：发起 PK（配置时长 / 对手），管理 PK 状态（开始 / 结束），同步分数，监听对战结果。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-battle-store/index.html) |
+| **GiftStore** | 礼物互动：获取礼物列表，发送 / 接收礼物，监听礼物事件（含发送者、礼物详情）。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.gift/-gift-store/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) |
+| **LikeStore** | 点赞互动：发送点赞，监听点赞事件，同步总点赞数。 | [API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-like-store/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.live/-live-audience-store/index.html) |
+| **AudioEffectStore** | 音频特效：变声（童声 / 男声）、混响（KTV 等）、耳返调节，实时切换特效。 | [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) |
+| **BaseBeautyStore** | 基础美颜：调节磨皮 / 美白 / 红润（0-100 级），重置美颜状态，同步效果参数。 | [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) |
+
+## 常见问题
+
+### 听众调用 joinLive 后为什么没有声音？
+- **检查设备权限**：请确保 `App` 已获得麦克风的系统使用权限。
+
+- **检查房主端**：请确认房主端已正常调用 `DeviceStore.shared().openLocalMicrophone(null)` 以打开麦克风。
+
+- **检查网络**：请检查设备网络连接是否正常。
+
+### 为什么麦位列表没有显示或没有更新？
+- **检查 Store 初始化**：请确保您在 `createLive` 或 `joinLive` 之前，已经使用相同的 `liveID` 正确创建了 `LiveSeatStore` 实例 `(LiveSeatStore.create(liveID))`。
+
+- **检查数据监听**：请检查您是否正确监听了 `liveSeatStore.liveSeatState.seatList` 的数据流。
+
+- **检查接口调用**：请确保 `createLive` (房主) 或 `joinLive` (听众) 接口已成功调用（在 `onSuccess` 回调中确认）。