@tencent-rtc/mcp 1.3.9 → 1.4.0

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

@@ -1,77 +1,24 @@
 This document guides developers through building a voice chat room application with host broadcasting and audience participation features using the **AtomicXCore** SDK's `LiveListStore` and `LiveSeatStore`.
 
 ## Core Concepts
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Core Concept**</td>
-
-<td rowspan="1" colSpan="1" >**Type**</td>
-
-<td rowspan="1" colSpan="1" >**Core Responsibilities & Description**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveListStore`</td>
-
-<td rowspan="1" colSpan="1" >`abstract class`</td>
-
-<td rowspan="1" colSpan="1" >- `createLive()`: Start live stream as host.<br>- `endLive()`: End live stream as host.<br>- `joinLive()`: Audience joins live room.<br>- `leaveLive()`: Leave live room.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveInfo`</td>
-
-<td rowspan="1" colSpan="1" >`data class`</td>
-
-<td rowspan="1" colSpan="1" >- `liveID`: Unique room identifier.<br>- `seatLayoutTemplateID`: Layout template ID (e.g., 600 for dynamic grid).</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveSeatStore`</td>
-
-<td rowspan="1" colSpan="1" >`abstract class`</td>
-
-<td rowspan="1" colSpan="1" >Core seat management class. Manages all seat information and seat-related operations in the room.<br>Provides a real-time seat list data stream via liveSeatState.seatList.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveSeatState`</td>
-
-<td rowspan="1" colSpan="1" >`data class`</td>
-
-<td rowspan="1" colSpan="1" >Represents the current state of all seats.<br>- `seatList`: a StateFlow containing the real-time seat list.<br>- `speakingUsers`: users currently speaking and their volume.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`SeatInfo`</td>
-
-<td rowspan="1" colSpan="1" >`data class`</td>
-
-<td rowspan="1" colSpan="1" >Data model for a single seat. The seat list (seatList) emitted by LiveSeatStore is a list of SeatInfo objects.<br>Key fields:<br>- `index`: seat position.<br>- `isLocked`: whether the seat is locked.<br>- `userInfo`: user information for the seat. If the seat is empty, this field is empty.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`SeatUserInfo`</td>
-
-<td rowspan="1" colSpan="1" >`data class`</td>
-
-<td rowspan="1" colSpan="1" >Detailed data model for the user occupying a seat. When a user successfully takes a seat, the userInfo field in SeatInfo is populated.<br>Key fields:<br>- `userID`: unique user ID.<br>- `userName`: user nickname.<br>- `avatarURL`: user avatar URL.<br>- `microphoneStatus`: microphone status (on/off).<br>- `cameraStatus`: camera status (on/off).</td>
-</tr>
-</table>
-
+| **Core Concept** | **Type** | **Core Responsibilities & Description** |
+| --- | --- | --- |
+| `LiveListStore` | `abstract class` | - `createLive()`: Start live stream as host.<br>- `endLive()`: End live stream as host.<br>- `joinLive()`: Audience joins live room.<br>- `leaveLive()`: Leave live room. |
+| `LiveInfo` | `data class` | - `liveID`: Unique room identifier.<br>- `seatTemplate`: Layout template. |
+| `LiveSeatStore` | `abstract class` | Core seat management class. Manages all seat information and seat-related operations in the room.<br>Provides a real-time seat list data stream via liveSeatState.seatList. |
+| `LiveSeatState` | `data class` | Represents the current state of all seats.<br>- `seatList`: a StateFlow containing the real-time seat list.<br>- `speakingUsers`: users currently speaking and their volume. |
+| `SeatInfo` | `data class` | Data model for a single seat. The seat list (seatList) emitted by LiveSeatStore is a list of SeatInfo objects.<br>Key fields:<br>- `index`: seat position.<br>- `isLocked`: whether the seat is locked.<br>- `userInfo`: user information for the seat. If the seat is empty, this field is empty. |
+| `SeatUserInfo` | `data class` | Detailed data model for the user occupying a seat. When a user successfully takes a seat, the userInfo field in SeatInfo is populated.<br>Key fields:<br>- `userID`: unique user ID.<br>- `userName`: user nickname.<br>- `avatarURL`: user avatar URL.<br>- `microphoneStatus`: microphone status (on/off).<br>- `cameraStatus`: camera status (on/off). |
 
 ## Prerequisites
 
 ### Step 1: Activate the Service
 
-See [Activate Service](https://write.woa.com/document/141936672617742336) to obtain either the trial or paid version of the SDK.Then, go to [the Console](https://console.trtc.io/app) for application management, and get the following:
+See Activate Service to obtain either the trial or paid version of the SDK.Then, go to [the Console](https://console.trtc.io/app) for application management, and get the following:
 - `SDKAppID`: Application identifier (required). Tencent Cloud uses `SDKAppId` for billing and details.
 
 - `SDKSecretKey`: Application secret key, used to initialize the configuration file with secret information.
 
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/018c103bc9f411f09e745254007c27c5.png)
-
-
 ### Step 2: Import AtomicXCore into Your Project
 
 **Install the component**: Add the dependency `implementation 'com.tencent.atomicx:atomicxcore:latest`' to your `build.gradle` file, then perform a **Gradle****Sync**.
@@ -91,10 +38,10 @@ dependencies {
 Call `LoginStore.shared.login` in your project to complete authentication. **This is required before using any functionality of AtomicXCore**.
 
 > **Note：**
-> 
+>
 
 > We recommend calling `LoginStore.shared.login` after your app's own user authentication is successful to ensure clear and consistent login logic.
-> 
+>
 
 ``` java
 import android.os.Bundle
@@ -129,40 +76,11 @@ class MainActivity : AppCompatActivity() {
 ```
 
 **Login API Parameter Description**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >Parameter</td>
-
-<td rowspan="1" colSpan="1" >Type</td>
-
-<td rowspan="1" colSpan="1" >Description</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`sdkAppID`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >Get this from [TRTC console > Application management](https://console.trtc.io/app).</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`userID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >The unique ID for the current user. Must contain only English letters, numbers, hyphens, and underscores.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`userSig`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >A ticket for Tencent Cloud authentication. Please note:<br>- **Development Environment**: You can use the local `GenerateTestUserSig.genTestSig` function to generate a UserSig or generate a temporary UserSig via the [UserSig Generation Tool](https://console.trtc.io/usersig).<br>- **Production Environment**: To prevent key leakage, you must use a server-side method to generate UserSig. For details, see [Generating UserSig on the Server](https://write.woa.com/document/89644530319802368).<br>- For more information, see [How to Calculate and Use UserSig](https://write.woa.com/document/89644530319802368).</td>
-</tr>
-</table>
-
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `sdkAppID` | `Int` | Get this from [TRTC console > Application management](https://console.trtc.io/app). |
+| `userID` | `String` | The unique ID for the current user. Must contain only English letters, numbers, hyphens, and underscores. |
+| `userSig` | `String` | A ticket for Tencent Cloud authentication. Please note:<br>- **Development Environment**: You can use the local `GenerateTestUserSig.genTestSig` function to generate a UserSig or generate a temporary UserSig via the [UserSig Generation Tool](https://console.trtc.io/usersig).<br>- **Production Environment**: To prevent key leakage, you must use a server-side method to generate UserSig. For details, see Generating UserSig on the Server.<br>- For more information, see How to Calculate and Use UserSig. |
 
 ## Building a Basic Voice Chat Room
 
@@ -263,16 +181,10 @@ class YourHostActivity : AppCompatActivity() {
             liveID = this@YourHostActivity.liveID
             // 2. Set room name
             liveName = "test voice room"
-            // 3. Configure as a voice chat room (enable mic seats)
-            isSeatEnabled = true
-            // 4. Host takes mic by default
-            keepOwnerOnSeat = true
-            // 5. Set mic seat layout template (e.g., 70 for a 10-seat template)
-            seatLayoutTemplateID = 70
-            // 6. Set mic-taking mode, e.g., apply to take mic
+            // 3. Set the live streaming template to the voice chat room template, with 9 seat.
+            seatTemplate = SeatLayoutTemplate.AudioSalon(seatCount = 9)
+            // 4. Set mic-taking mode, e.g., apply to take mic
             seatMode = TakeSeatMode.APPLY
-            // 7. Set maximum number of mic seats
-            maxSeatCount = 10
         }
 
         // 8. Call createLive to start the stream
@@ -292,167 +204,27 @@ class YourHostActivity : AppCompatActivity() {
 ```
 
 **LiveInfo Parameter Description**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Parameter Name**</td>
-
-<td rowspan="1" colSpan="1" >**Type**</td>
-
-<td rowspan="1" colSpan="1" >**Required**</td>
-
-<td rowspan="1" colSpan="1" >**Description**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Required</td>
-
-<td rowspan="1" colSpan="1" >Unique identifier for the live room</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`liveName`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Title of the live room</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`notice`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Announcement information for the live room</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`isMessageDisable`</td>
-
-<td rowspan="1" colSpan="1" >`Boolean`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Mute status (`true`: muted, `false`: not muted)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`isPublicVisible`</td>
-
-<td rowspan="1" colSpan="1" >`Boolean`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Public visibility (`true`: visible, `false`: hidden)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`isSeatEnabled`</td>
-
-<td rowspan="1" colSpan="1" >`Boolean`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Enable mic seat feature (`true`: enabled, `false`: disabled)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`keepOwnerOnSeat`</td>
-
-<td rowspan="1" colSpan="1" >`Boolean`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Keep host on mic seat</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`maxSeatCount`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >Required</td>
-
-<td rowspan="1" colSpan="1" >Maximum number of mic seats</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`seatMode`</td>
-
-<td rowspan="1" colSpan="1" >[TakeSeatMode](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-take-seat-mode/index.html)</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Mic seat mode (`FREE`: free to take seat, `APPLY`: apply to take seat)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`seatLayoutTemplateID`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >Required</td>
-
-<td rowspan="1" colSpan="1" >Mic seat layout template ID</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`coverURL`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Cover image URL for the live room</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`backgroundURL`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Background image URL for the live room</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`categoryList`</td>
-
-<td rowspan="1" colSpan="1" >`List<Int>`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Category tag list for the live room</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`activityStatus`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Live activity status</td>
-</tr>
-</table>
-
+| **Parameter Name** | **Type** | **Required** | **Description** |
+| --- | --- | --- | --- |
+| `liveID` | `String` | Required | Unique identifier for the live room |
+| `liveName` | `String` | Optional | Title of the live room |
+| `notice` | `String` | Optional | Announcement information for the live room |
+| `isMessageDisable` | `Boolean` | Optional | Mute status (`true`: muted, `false`: not muted) |
+| `isPublicVisible` | `Boolean` | Optional | Public visibility (`true`: visible, `false`: hidden) |
+| `seatMode` | [TakeSeatMode](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-take-seat-mode/index.html) | Optional | Mic seat mode (`FREE`: free to take seat, `APPLY`: apply to take seat) |
+| `seatTemplate` | `SeatLayoutTemplate` | Required | Mic seat layout template ID |
+| `coverURL` | `String` | Optional | Cover image URL for the live room |
+| `backgroundURL` | `String` | Optional | Background image URL for the live room |
+| `categoryList` | `List<Int>` | Optional | Category tag list for the live room |
+| `activityStatus` | `Int` | Optional | Live activity status |
 
 #### **4. Build the Mic Seat UI**
 
 > **Note：**
-> 
+>
 
 > For the complete business logic of mic seat UI effects, refer to the open-source [SeatGridView.kt](https://github.com/Tencent-RTC/TUILiveKit/blob/main/Android/tuilivekit/src/main/java/com/trtc/uikit/livekit/voiceroomcore/SeatGridView.kt) in the TUILiveKit project.
-> 
-
+>
 
 Use the `LiveSeatStore` instance to observe changes in `liveSeatState.seatList` and update your UI in real time. In your Activity (such as `YourAnchorActivity` or `YourAudienceActivity`), observe the data as follows:
 ``` java
@@ -581,13 +353,13 @@ import io.trtc.tuikit.atomicxcore.api.live.LiveInfoCompletionHandler
 
 // YourAudienceActivity represents your Audience Activity
 class YourAudienceActivity : AppCompatActivity() {
-    
+
     // ... Other code ...
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_audience) // Assume you have your own layout
         // ... Other code ...
-        
+
         // Enter voice chat room
         joinLive()
     }
@@ -608,7 +380,7 @@ class YourAudienceActivity : AppCompatActivity() {
 
 #### **3. Build the Mic Seat UI**
 
-The process for building the mic seat UI as an audience member is the same as for the host. Refer to the host [Build the Mic Seat UI](https://write.woa.com/#9a917c47-816f-4930-81b1-d35ee01c519d).
+The process for building the mic seat UI as an audience member is the same as for the host. Refer to the host Build the Mic Seat UI.
 
 #### **4. Leave the Voice Chat Room**
 
@@ -647,8 +419,6 @@ class YourAudienceActivity : AppCompatActivity() {
 
 After completing the steps above, you will have a basic voice chat live streaming setup. For more advanced features, see the "Enrich Voice Chat Room Scenarios" section.
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/159d41cdc9f411f0b011525400bf7822.png)
-
 ## Advanced Features
 
 ### **Implementing Speaking Wave Animation for Mic Seat Users**
@@ -657,16 +427,15 @@ In voice chat rooms, it is common to show a wave animation on the avatar of user
 
 #### Example
 
-#### ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/159f07ffc9f411f09e745254007c27c5.gif)
+####
 
 #### Implementation
 
 > **Note：**
-> 
+>
 
 > For a complete implementation of the speaking wave animation, refer to [SeatGridView.kt](https://github.com/Tencent-RTC/TUILiveKit/blob/main/Android/tuilivekit/src/main/java/com/trtc/uikit/livekit/voiceroomcore/SeatGridView.kt) in the open-source TUILiveKit project.
-> 
-
+>
 
 In `YourAnchorActivity`, observe changes in `speakingUsers` and update the UI to reflect the speaking status:
 ``` java
@@ -706,11 +475,10 @@ class YourHostActivity : AppCompatActivity() {
 In Live Streaming Room, hosts may need to synchronize custom information with all participants, such as the current room topic or background music. The `metaData` feature of `LiveListStore` supports this use case.
 
 #### Implementation
-1. On the host side, set custom information using the `updateLiveMetaData` API. `AtomicXCore` synchronizes these changes in real time to all participants. 
+1. On the host side, set custom information using the `updateLiveMetaData` API. `AtomicXCore` synchronizes these changes in real time to all participants.
 
 2. On the audience side, subscribe to `LiveListState.currentLive` and listen for changes in `metaData`. When a relevant key is updated, parse its value and update your business logic.
 
-
 #### Code Example
 ``` kotlin
 import io.trtc.tuikit.atomicxcore.api.LiveListStore
@@ -767,158 +535,27 @@ private fun subscribeToDataUpdates() {
 ## Enrich Voice Chat Room Scenarios
 
 After implementing the basic voice chat room, you can add more interactive features by referring to the following guides:
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Feature**</td>
-
-<td rowspan="1" colSpan="1" >**Feature Description**</td>
-
-<td rowspan="1" colSpan="1" >**Feature Stores**</td>
-
-<td rowspan="1" colSpan="1" >**Implementation Guide**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Enable Audience to Take Mic Seat**</td>
-
-<td rowspan="1" colSpan="1" >Audience can apply to take a mic seat and interact with the host in real time.</td>
-
-<td rowspan="1" colSpan="1" >[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)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation](https://write.woa.com/document/194571595728519168)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Host Cross-Room Connection & PK**</td>
-
-<td rowspan="1" colSpan="1" >Hosts from different rooms can connect for interaction or PK.</td>
-
-<td rowspan="1" colSpan="1" >[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)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation](https://write.woa.com/document/194571595874271232)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Add Barrage Chat**</td>
-
-<td rowspan="1" colSpan="1" >Members in the room can send and receive real-time text messages.</td>
-
-<td rowspan="1" colSpan="1" >[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)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation](https://write.woa.com/document/195218523636584448)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Build Gift System**</td>
-
-<td rowspan="1" colSpan="1" >Audience can send virtual gifts to hosts to increase engagement and fun.</td>
-
-<td rowspan="1" colSpan="1" >[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)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation](https://write.woa.com/document/195218406705512448)</td>
-</tr>
-</table>
-
+| **Feature** | **Feature Description** | **Feature Stores** | **Implementation Guide** |
+| --- | --- | --- | --- |
+| **Enable Audience to Take Mic Seat** | Audience can apply to take a mic seat and interact with the host in real time. | [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) | Implementation |
+| **Host Cross-Room Connection & PK** | Hosts from different rooms can connect for interaction or 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) | Implementation |
+| **Add Barrage Chat** | Members in the room can send and receive real-time text messages. | [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) | Implementation |
+| **Build Gift System** | Audience can send virtual gifts to hosts to increase engagement and fun. | [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) | Implementation |
 
 ## API Documentation
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Store/Component**</td>
-
-<td rowspan="1" colSpan="1" >**Feature Description**</td>
-
-<td rowspan="1" colSpan="1" >**API Documentation**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveListStore`</td>
-
-<td rowspan="1" colSpan="1" >Manages the full lifecycle of live rooms: create, join, leave, destroy rooms; query room list; modify live info (name, announcement, etc.); listen to live status (such as being kicked out, ended).</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveSeatStore`</td>
-
-<td rowspan="1" colSpan="1" >Core mic seat management: manage mic seat list, user status, seat operations (take seat, leave seat, kick, lock, toggle microphone/camera, etc.), listen to mic seat events.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`DeviceStore`</td>
-
-<td rowspan="1" colSpan="1" >Audio/video device control: microphone (toggle/volume), camera (toggle/switch/quality), screen sharing, real-time device status monitoring.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`CoGuestStore`</td>
-
-<td rowspan="1" colSpan="1" >Audience co-host management: co-host application/invitation/approval/rejection, member permission control (microphone/camera), status synchronization.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`CoHostStore`</td>
-
-<td rowspan="1" colSpan="1" >Host cross-room connection: supports multiple layout templates (dynamic grid, etc.), initiate/accept/reject connection, manage co-host interaction.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`BattleStore`</td>
-
-<td rowspan="1" colSpan="1" >Host PK battle: initiate PK (set duration/opponent), manage PK status (start/end), synchronize scores, listen to battle results.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`GiftStore`</td>
-
-<td rowspan="1" colSpan="1" >Gift interaction: get gift list, send/receive gifts, listen to gift events (including sender and gift details).</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`BarrageStore`</td>
-
-<td rowspan="1" colSpan="1" >Bullet chat feature: send text/custom barrage, maintain barrage list, real-time barrage status monitoring.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LikeStore`</td>
-
-<td rowspan="1" colSpan="1" >Like interaction: send likes, listen to like events, synchronize total like count.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveAudienceStore`</td>
-
-<td rowspan="1" colSpan="1" >Audience management: get real-time audience list (ID/name/avatar), count audience number, listen to audience join/leave events.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`AudioEffectStore`</td>
-
-<td rowspan="1" colSpan="1" >Audio effects: voice changer (child/male), reverb (KTV, etc.), ear monitor adjustment, real-time effect switching.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](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)</td>
-</tr>
-</table>
-
+| **Store/Component** | **Feature Description** | **API Documentation** |
+| --- | --- | --- |
+| `LiveListStore` | Manages the full lifecycle of live rooms: create, join, leave, destroy rooms; query room list; modify live info (name, announcement, etc.); listen to live status (such as being kicked out, ended). | [API Documentation](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` | Core mic seat management: manage mic seat list, user status, seat operations (take seat, leave seat, kick, lock, toggle microphone/camera, etc.), listen to mic seat events. | [API Documentation](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` | Audio/video device control: microphone (toggle/volume), camera (toggle/switch/quality), screen sharing, real-time device status monitoring. | [API Documentation](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` | Audience co-host management: co-host application/invitation/approval/rejection, member permission control (microphone/camera), status synchronization. | [API Documentation](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` | Host cross-room connection: supports multiple layout templates (dynamic grid, etc.), initiate/accept/reject connection, manage co-host interaction. | [API Documentation](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` | Host PK battle: initiate PK (set duration/opponent), manage PK status (start/end), synchronize scores, listen to battle results. | [API Documentation](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` | Gift interaction: get gift list, send/receive gifts, listen to gift events (including sender and gift details). | [API Documentation](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` | Bullet chat feature: send text/custom barrage, maintain barrage list, real-time barrage status monitoring. | [API Documentation](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` | Like interaction: send likes, listen to like events, synchronize total like count. | [API Documentation](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` | Audience management: get real-time audience list (ID/name/avatar), count audience number, listen to audience join/leave events. | [API Documentation](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` | Audio effects: voice changer (child/male), reverb (KTV, etc.), ear monitor adjustment, real-time effect switching. | [API Documentation](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) |
 
 ## FAQs
 
@@ -929,12 +566,9 @@ After implementing the basic voice chat room, you can add more interactive featu
 
 - **Check the network:** Ensure the device's network connection is stable.
 
-
 ### Why is the mic seat list not displayed or not updating?
 - **Check store initialization:** Make sure you have created the `LiveSeatStore` instance with the same `liveID` before calling `createLive` or `joinLive` (`LiveSeatStore.create(liveID)`).
 
 - **Check data observation:** Ensure you are observing the `liveSeatStore.liveSeatState.seatList` data stream.
 
-- **Check API calls:** Confirm that `createLive` (host) or `joinLive` (audience) was successfully called (check the `onSuccess` callback).åå
-
-
+- **Check API calls:** Confirm that `createLive` (host) or `joinLive` (audience) was successfully called (check the `onSuccess` callback).