@tencent-rtc/mcp 1.4.6 → 1.6.0-beta.1

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

@@ -12,11 +12,12 @@ This document provides a comprehensive guide for iOS developers to quickly integ
 - Inserting system tips into the local message list (for example, "Welcome XX to the live room").
 
 ## Core Concepts
-| **Core Concept** | **Type** | **Core Responsibility & Description** |
-| --- | --- | --- |
-| [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 | Represents a single barrage message. Contains sender info (sender), message content (textContent or data), and message type (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 | Represents the current state of the barrage module. The main property, messageList, is a StateFlow containing all barrage messages for the current live room, ordered chronologically. This serves as the UI data source. |
-| [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 | The main manager for barrage features. Use it to send messages (sendTextMessage, sendCustomMessage) and subscribe to barrage message updates via its state property. |
+
+|**Core Concept**|**Type**|**Core Responsibility & Description**|
+|---------|---------|---------|
+|[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|Represents a single barrage message. Contains sender info (sender), message content (textContent or data), and message type (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|Represents the current state of the barrage module. The main property, messageList, is a StateFlow containing all barrage messages for the current live room, ordered chronologically. This serves as the UI data source.|
+|[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|The main manager for barrage features. Use it to send messages (sendTextMessage, sendCustomMessage) and subscribe to barrage message updates via its state property.|
 
 ## Implementation
 
@@ -102,11 +103,12 @@ class BarrageManager(
 ```
 
 #### API Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `text` | `String?` | The text content to send. |
-| `extensionInfo` | `Map<String, String>?` | Additional data for business customization. |
-| `completion` | `CompletionHandler?` | Callback invoked after sending, indicating success or failure. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`text`|`String?`|The text content to send.|
+|`extensionInfo`|`Map<String, String>?`|Additional data for business customization.|
+|`completion`|`CompletionHandler?`|Callback invoked after sending, indicating success or failure.|
 
 ### Step 4: Send Custom Barrage
 
@@ -153,11 +155,12 @@ class BarrageManager(
 ```
 
 #### API Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| businessId | String | Unique business identifier (e.g., "live_gift"). Used by receivers to distinguish custom messages. |
-| data | String | Business data, typically a JSON string. |
-| completion | CompletionHandler? | Callback after sending. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|businessId|String|Unique business identifier (e.g., "live_gift"). Used by receivers to distinguish custom messages.|
+|data|String|Business data, typically a JSON string.|
+|completion|CompletionHandler?|Callback after sending.|
 
 ### Step 5: Insert Local Tip Messages
 
@@ -183,9 +186,10 @@ class BarrageManager(
 ```
 
 #### API Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| message | Barrage | The message object to insert locally. The SDK appends this to messageList in BarrageState. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|message|Barrage|The message object to insert locally. The SDK appends this to messageList in BarrageState.|
 
 ### Step 6: Manage User Speaking Permissions (Mute and Unmute)
 

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

@@ -300,9 +300,10 @@ seatStore.unmuteMicrophone(null) // Unmute
 ```
 
 #### unmuteMicrophone Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `completion` | `CompletionHandler?` | Callback after operation completes. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`completion`|`CompletionHandler?`|Callback after operation completes.|
 
 ### Host Remotely Controls Mic Seat User’s Microphone
 
@@ -364,16 +365,18 @@ seatStore.addLiveSeatEventListener(seatListener)
 ```
 
 #### closeRemoteMicrophone Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `userID` | `String` | The user ID of the target user. |
-| `completion` | `CompletionHandler?` | Callback after request completes. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`userID`|`String`|The user ID of the target user.|
+|`completion`|`CompletionHandler?`|Callback after request completes.|
 
 #### openRemoteMicrophone Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `userID` | `String` | The user ID of the target user. |
-| `completion` | `CompletionHandler?` | Callback after request completes. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`userID`|`String`|The user ID of the target user.|
+|`completion`|`CompletionHandler?`|Callback after request completes.|
 
 ### Host Removes On-Mic User from the Seat
 
@@ -402,10 +405,11 @@ override fun onKickedOffSeat(seatIndex: Int, hostUser: LiveUserInfo) {
 ```
 
 #### kickUserOutOfSeat Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `userID` | `String` | The user ID of the user to remove. |
-| `completion` | `CompletionHandler?` | Callback after request completes. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`userID`|`String`|The user ID of the user to remove.|
+|`completion`|`CompletionHandler?`|Callback after request completes.|
 
 ### Host Locks and Unlocks Mic Seats
 
@@ -440,16 +444,18 @@ seatStore.unlockSeat(2, object : CompletionHandler {
 ```
 
 #### lockSeat Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `seatIndex` | `Int` | Index of the mic seat to lock. |
-| `completion` | `CompletionHandler?` | Callback after request completes. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`seatIndex`|`Int`|Index of the mic seat to lock.|
+|`completion`|`CompletionHandler?`|Callback after request completes.|
 
 #### unlockSeat Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `seatIndex` | `Int` | Index of the mic seat to unlock. |
-| `completion` | `CompletionHandler?` | Callback after request completes. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`seatIndex`|`Int`|Index of the mic seat to unlock.|
+|`completion`|`CompletionHandler?`|Callback after request completes.|
 
 ### Move Mic Seats
 
@@ -479,20 +485,22 @@ seatStore.moveUserToSeat("userC",
 ```
 
 #### moveUserToSeat Parameters
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `userID` | `String` | The user ID of the user to move. |
-| `targetIndex` | `Int` | Target mic seat index. |
-| `policy` | `MoveSeatPolicy?` | Seat movement policy if the target seat is occupied:<br>- `abortWhenOccupied`: Abort move if seat is occupied (default)<br>- `forceReplace`: Force replace the user on the target seat; replaced user will be removed<br>- `swapPosition`: Swap positions with the user on the target seat. |
-| `completion` | `CompletionHandler?` | Callback after request completes. |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`userID`|`String`|The user ID of the user to move.|
+|`targetIndex`|`Int`|Target mic seat index.|
+|`policy`|`MoveSeatPolicy?`|Seat movement policy if the target seat is occupied:<br>- `abortWhenOccupied`: Abort move if seat is occupied (default)<br>- `forceReplace`: Force replace the user on the target seat; replaced user will be removed<br>- `swapPosition`: Swap positions with the user on the target seat.|
+|`completion`|`CompletionHandler?`|Callback after request completes.|
 
 ## API Documentation
 
 For detailed information about all public interfaces, properties, and methods of [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore), [LiveSeatStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore), and related classes, refer to the official [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) framework API documentation. The relevant stores used in this guide are as follows:
-| **Store/Component** | **Feature Description** | **API Documentation** |
-| --- | --- | --- |
-| CoGuestStore | Audience co-hosting management: co-hosting requests/invitations, approval/rejection, co-host member permission control (microphone/camera), state 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) |
-| LiveSeatStore | Mic seat management: mute/unmute, lock/unlock mic seat, remove user from mic, remote microphone control, mic seat list state monitoring. | [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) |
+
+|**Store/Component**|**Feature Description**|**API Documentation**|
+|---------|---------|---------|
+|CoGuestStore|Audience co-hosting management: co-hosting requests/invitations, approval/rejection, co-host member permission control (microphone/camera), state 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)|
+|LiveSeatStore|Mic seat management: mute/unmute, lock/unlock mic seat, remove user from mic, remote microphone control, mic seat list state monitoring.|[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)|
 
 ## FAQs
 

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

@@ -1,7 +1,8 @@
 `GiftStore` is a dedicated module within **AtomicXCore** for managing live room gifting features. It enables you to build a complete gifting system for your live streaming application, supporting robust monetization and interactive experiences.
-| **Gift Panel** | **Barrage Gift** | **Full-Screen Gift** |
-| --- | --- | --- |
-|  |  |  |
+
+|**Gift Panel**|**Barrage Gift**|**Full-Screen Gift**|
+|---------|---------|---------|
+||||
 
 ## Core Features
 - **Gift List Retrieval**: Retrieve gift panel data from the server, including gift categories and details.
@@ -11,13 +12,14 @@
 - **Gift Event Broadcast:** Receive real-time gift events in the room for displaying gift animations and barrage notifications.
 
 ## Core Concepts
-| **Core Concept** | **Type** | **Core Responsibilities & Description** |
-| --- | --- | --- |
-| `Gift` | `data class` | Represents a gift data model, including ID, name, icon URL, animation resource URL (resourceURL), price (coins), and more. |
-| `GiftCategory` | `data class` | Represents a gift category (e.g., "Popular", "Luxury"). Contains the category name and a list of Gift objects. |
-| `GiftState` | `data class` | Represents the current state of the gift module. The core property, usableGifts, is a StateFlow containing the full gift list from the server. |
-| `GiftEvent` | `abstract class` | Defines the event listener for gift events in the live room. Currently, only onReceiveGift is available; all users in the room receive this event when any user sends a gift. |
-| `GiftStore` | `abstract class` | The core management class for gift features. Use it to fetch the gift list, send gifts, and receive gift events via listeners. |
+
+|**Core Concept**|**Type**|**Core Responsibilities & Description**|
+|---------|---------|---------|
+|`Gift`|`data class`|Represents a gift data model, including ID, name, icon URL, animation resource URL (resourceURL), price (coins), and more.|
+|`GiftCategory`|`data class`|Represents a gift category (e.g., "Popular", "Luxury"). Contains the category name and a list of Gift objects.|
+|`GiftState`|`data class`|Represents the current state of the gift module. The core property, usableGifts, is a StateFlow containing the full gift list from the server.|
+|`GiftEvent`|`abstract class`|Defines the event listener for gift events in the live room. Currently, only onReceiveGift is available; all users in the room receive this event when any user sends a gift.|
+|`GiftStore`|`abstract class`|The core management class for gift features. Use it to fetch the gift list, send gifts, and receive gift events via listeners.|
 
 ## Implementation
 
@@ -66,6 +68,11 @@ class GiftManager(
     // Expose gift list externally
     private val _giftList = MutableStateFlow<List<GiftCategory>>(emptyList())
     val giftList: StateFlow<List<GiftCategory>> = _giftList.asStateFlow()
+    private val giftListener = object : GiftListener() {
+        override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
+            // Forward event to UI layer for processing
+        }
+    }
 
     init {
         setupGiftListener()
@@ -74,11 +81,7 @@ class GiftManager(
 
     // Subscribe to gift events
     private fun setupGiftListener() {
-        giftStore.addGiftListener(object : GiftListener() {
-            override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
-                // Forward event to UI layer for processing
-            }
-        })
+        giftStore.addGiftListener(giftListener)
     }
 
     // Subscribe to gift list state
@@ -95,26 +98,26 @@ class GiftManager(
 #### Gift List Structure Parameters
 - **GiftCategory Parameter Description**
 
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `categoryID` | `String` | Unique ID of the gift category. |
-| `name` | `String` | Display name of the gift category. |
-| `desc` | `String` | Description of the gift category. |
-| `extensionInfo` | `Map<String, String>` | Extension information field. |
-| `giftList` | `List` | Array of Gift objects in this category. |
+   |**Parameter**|**Type**|**Description**|
+   |---------|---------|---------|
+   |`categoryID`|`String`|Unique ID of the gift category.|
+   |`name`|`String`|Display name of the gift category.|
+   |`desc`|`String`|Description of the gift category.|
+   |`extensionInfo`|`Map<String, String>`|Extension information field.|
+   |`giftList`|`List`|Array of Gift objects in this category.|
 
 - **Gift Parameter Description**
 
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `giftID` | `String` | Unique ID of the gift. |
-| `name` | `String` | Display name of the gift. |
-| `desc` | `String` | Description of the gift. |
-| `iconURL` | `String` | Gift icon URL. |
-| `resourceURL` | `String` | Gift animation resource URL. |
-| `level` | `Long` | Gift level. |
-| `coins` | `Long` | Gift price. |
-| `extensionInfo` | `Map<String, String>` | Extension information field. |
+   |**Parameter**|**Type**|**Description**|
+   |---------|---------|---------|
+   |`giftID`|`String`|Unique ID of the gift.|
+   |`name`|`String`|Display name of the gift.|
+   |`desc`|`String`|Description of the gift.|
+   |`iconURL`|`String`|Gift icon URL.|
+   |`resourceURL`|`String`|Gift animation resource URL.|
+   |`level`|`Long`|Gift level.|
+   |`coins`|`Long`|Gift price.|
+   |`extensionInfo`|`Map<String, String>`|Extension information field.|
 
 ### Step 3: Retrieve Gift List
 
@@ -186,11 +189,12 @@ class GiftManager(
 ```
 
 #### **sendGift API Parameters**
-| **Parameter Name** | **Type** | **Description** |
-| --- | --- | --- |
-| `giftID` | `String` | Unique ID of the gift to send. |
-| `count` | `Int` | Number of gifts to send. |
-| `completion` | `CompletionHandler?` | Callback invoked after sending completes. |
+
+|**Parameter Name**|**Type**|**Description**|
+|---------|---------|---------|
+|`giftID`|`String`|Unique ID of the gift to send.|
+|`count`|`Int`|Number of gifts to send.|
+|`completion`|`CompletionHandler?`|Callback invoked after sending completes.|
 
 ## Advanced Features
 
@@ -210,18 +214,18 @@ Customize available gift types, categories, names, icons, prices, and animation
 #### Configuration Sequence Diagram
 
 #### Related REST API Interfaces Overview
-| **Interface Category** | **Interface** | **Request Example** |
+| <strong>Interface Category</strong> | <strong>Interface</strong> | <strong>Request Example</strong> |
 | --- | --- | --- |
-| **​Gift Management** | Add Gift Information | Example |
+| <strong>​Gift Management</strong> | Add Gift Information | Example |
 | Delete Gift Information | Example |  |
 | Query Gift Information | Example |  |
-| **Gift Category Management** | Add Gift Category Information | Example |
+| <strong>Gift Category Management</strong> | Add Gift Category Information | Example |
 | Delete Specific Gift Category Information | Example |  |
 | Get Specific Gift Category Information | Example |  |
-| **Gift Relationship Management** | Add Relationship between a Specific Gift Category and Gift | Example |
+| <strong>Gift Relationship Management</strong> | Add Relationship between a Specific Gift Category and Gift | Example |
 | Delete Relationship between a Specific Gift Category and Gift | Example |  |
 | Get Gift Relationships under a Specific Gift Category | Example |  |
-| **Gift Multi-language Management** | Add Gift Multi-language Information | Example |
+| <strong>Gift Multi-language Management</strong> | Add Gift Multi-language Information | Example |
 | Delete Specific Gift Multi-language Information | Example |  |
 | Get Gift Multi-language Information | Example |  |
 | Add Gift Category Multi-language Information | Example |  |
@@ -244,9 +248,10 @@ When a viewer sends a gift, ensure their account balance is sufficient and compl
 #### Call Flow
 
 #### Related REST API Interfaces Overview
-| **Interface** | **Description** | **Request Example** |
-| --- | --- | --- |
-| **Callback Configuration - Callback before sending a gift** | The customer's backend can use this callback to decide whether to pass pre-gifting checks, etc. | Example |
+
+|**Interface**|**Description**|**Request Example**|
+|---------|---------|---------|
+|**Callback Configuration - Callback before sending a gift**|The customer's backend can use this callback to decide whether to pass pre-gifting checks, etc.|Example|
 
 ### Implement Full-Screen Gift Animation Playback
 
@@ -255,15 +260,16 @@ When a user sends a luxury gift (e.g., "Rocket", "Carnival"), play a full-screen
 #### Implementation
 
 **AtomicXCore** does not include a built-in gift animation player. Integrate a third-party library based on your requirements. Below is a comparison of two options:
-| **Comparison Item** | **Basic Solution (SVGAPlayer)** | **Gift AR (TCEffectPlayerKit)** |
-| --- | --- | --- |
-| Billing | Free (open source) | Paid (requires license). See [Billing Guide](https://trtc.io/document/69949?product=beautyar&menulabel=core%20sdk&platform=android#X-Series-Capabilities) |
-| Integration Method | Manual integration via Gradle | Requires additional integration and authentication |
-| Supported Animation Formats | SVGA only | SVGA, PAG, WebP, Lottie, MP4, and more |
-| Performance | Recommended SVGA file size ≤ 10MB | Supports larger files, better performance for complex/multiple/low-end scenarios |
-| Recommended Scenario | Uniform SVGA format, controllable file size | Multiple formats or higher performance/device compatibility needs |
 
-This section demonstrates the basic solution. For the **Gift AR** see the [TCEffectPlayer Integration Guide](https://trtc.io/document/70531?product=beautyar&menulabel=core%20sdk&platform=android).
+|**Comparison Item**|**Basic Solution (SVGAPlayer)**|**Gift AR (TCEffectPlayerKit)**|
+|---------|---------|---------|
+|Billing|Free (open source)|Paid (requires license). See [Billing Guide](https://trtc.io/document/69949)|
+|Integration Method|Manual integration via Gradle|Requires additional integration and authentication|
+|Supported Animation Formats|SVGA only|SVGA, PAG, WebP, Lottie, MP4, and more|
+|Performance|Recommended SVGA file size ≤ 10MB|Supports larger files, better performance for complex/multiple/low-end scenarios|
+|Recommended Scenario|Uniform SVGA format, controllable file size|Multiple formats or higher performance/device compatibility needs|
+
+This section demonstrates the basic solution. For the **Gift AR** see the [TCEffectPlayer Integration Guide](https://trtc.io/document/70531).
 
 #### Basic Solution: Using SVGAPlayer
 1. **Integrate SVGAPlayer**: Add the SVGAPlayer dependency to your build.gradle and sync the project.
@@ -322,21 +328,23 @@ class LiveRoomActivity : AppCompatActivity() {
         svgaImageView.visibility = android.view.View.GONE
     }
 
+   private val giftListener = object : GiftListener() {
+        override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
+          if (gift.resourceURL.isNotEmpty()) {
+                try {
+                    val url = URL(gift.resourceURL)
+                    playAnimation(url)
+                } catch (e: Exception) {
+                    println("Invalid animation URL: ${gift.resourceURL}")
+                }
+            }
+        }
+    }
+
     fun setupGiftSubscription(liveId: String) {
         giftStore = GiftStore.create(liveId)
 
-        giftStore.addGiftListener(object : GiftListener() {
-            override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
-                if (gift.resourceURL.isNotEmpty()) {
-                    try {
-                        val url = URL(gift.resourceURL)
-                        playAnimation(url)
-                    } catch (e: Exception) {
-                        println("Invalid animation URL: ${gift.resourceURL}")
-                    }
-                }
-            }
-        })
+        giftStore.addGiftListener(giftListener)
     }
 
     private fun playAnimation(url: URL) {
@@ -389,19 +397,23 @@ class LiveRoomManager(
     private val giftStore: GiftStore = GiftStore.create(liveId)
     private val barrageStore: BarrageStore = BarrageStore.create(liveId)
 
+    private val giftListener = object : GiftListener() {
+        override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
+
+            val tipText = "${sender.userName} sent ${gift.name} x $count"
+            val giftTip = Barrage(
+                liveID = liveID,
+                messageType = BarrageType.TEXT,
+                textContent = tipText
+                sender = sender
+            )
+            barrageStore.appendLocalTip(giftTip)
+
+        }
+    }
+
     private fun setupGiftToBarrageFlow() {
-        giftStore.addGiftListener(object : GiftListener() {
-            override fun onReceiveGift(liveID: String, gift: Gift, count: Int, sender: LiveUserInfo) {
-                val tipText = "${sender.userName} sent ${gift.name} x $count"
-                val giftTip = Barrage(
-                    liveID = liveID,
-                    messageType = BarrageType.TEXT,
-                    textContent = tipText
-                    sender = sender
-                )
-                barrageStore.appendLocalTip(giftTip)
-            }
-        })
+        giftStore.addGiftListener(giftListener)
     }
 }
 ```
@@ -409,10 +421,11 @@ class LiveRoomManager(
 ## API Documentation
 
 For complete details on all public interfaces, properties, and methods of [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) and related classes, see the official API documentation for [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Android/index.html). Key stores referenced in this guide include:
-| **Store/Component** | **Feature Description** | **API Documentation** |
-| --- | --- | --- |
-| GiftStore | Gift interactions: fetch gift list, send/receive gifts, listen for 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 | Barrage features: send text/custom barrage, maintain barrage list, listen to barrage status in real time. | [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) |
+
+|**Store/Component**|**Feature Description**|**API Documentation**|
+|---------|---------|---------|
+|GiftStore|Gift interactions: fetch gift list, send/receive gifts, listen for 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|Barrage features: send text/custom barrage, maintain barrage list, listen to barrage status in real time.|[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)|
 
 ## FAQs
 

package/resource/{doc → knowledge}/livekit/core-sdk/voice/android/voice-host-interaction.md

@@ -1,14 +1,15 @@
 `AtomicXCore` provides two core modules: `CoHostStore` for **cross-room connections** and `BattleStore` for **PK battles**. This guide explains how to integrate these modules to enable connection and PK features in a voice chat room application.
 
 ## Core Concepts
-| **Core Concept** | **Type** | **Core Responsibilities & Description** |
-| --- | --- | --- |
-| **CoHostStore** | `abstract class` | Manages the lifecycle of host-to-host connections. Provides connection APIs such as `requestHostConnection` and `acceptHostConnection`. |
-| **BattleStore** | `abstract class` | Handles PK battle signaling and state management across rooms, including PK status tracking. |
-| **LiveListStore** | `abstract class` | Fetches the list of active live rooms (`fetchLiveList`). Use this to discover rooms available for connection. |
-| **LiveSeatStore** | `abstract class` | Manages seat states within a room, including cross-room seats during connection. Tracks user join/leave events and microphone status. |
-| **CoHostLayoutTemplate** | `enum` | Defines seat layout templates for cross-room connections, e.g., `HOST_STATIC_VOICE_6V6`. |
-| **BattleConfig** | `data` | Configures PK battle details such as duration (`duration`) and whether a secondary response is required (`needResponse`). |
+
+|**Core Concept**|**Type**|**Core Responsibilities & Description**|
+|---------|---------|---------|
+|**CoHostStore**|`abstract class`|Manages the lifecycle of host-to-host connections. Provides connection APIs such as `requestHostConnection` and `acceptHostConnection`.|
+|**BattleStore**|`abstract class`|Handles PK battle signaling and state management across rooms, including PK status tracking.|
+|**LiveListStore**|`abstract class`|Fetches the list of active live rooms (`fetchLiveList`). Use this to discover rooms available for connection.|
+|**LiveSeatStore**|`abstract class`|Manages seat states within a room, including cross-room seats during connection. Tracks user join/leave events and microphone status.|
+|**CoHostLayoutTemplate**|`enum`|Defines seat layout templates for cross-room connections, e.g., `HOST_STATIC_VOICE_6V6`.|
+|**BattleConfig**|`data`|Configures PK battle details such as duration (`duration`) and whether a secondary response is required (`needResponse`).|
 
 ## Prerequisites
 
@@ -187,10 +188,11 @@ public void onExitButtonClicked() {
 ## PK Streamer Initiates a PK
 
  BattleStreamers can start PK battles using two main flows, depending on the room state before PK begins:
-| **PK Mode** | **Room State (Before PK)** | **Room State (After PK)** |
-| --- | --- | --- |
-| Scenario 1: PK after connection | Both sides connected | Returns to connection state |
-| Scenario 2: Connection with PK mode | Both sides not connected | Returns to connection state |
+
+|**PK Mode**|**Room State (Before PK)**|**Room State (After PK)**|
+|---------|---------|---------|
+|Scenario 1: PK after connection|Both sides connected|Returns to connection state|
+|Scenario 2: Connection with PK mode|Both sides not connected|Returns to connection state|
 
 ### Scenario 1: PK After Connection
 
@@ -404,12 +406,13 @@ In typical** live host PK scenarios,** the value of gifts received by the host i
 
 > The PK score system in the LiveKit backend uses pure numeric calculation and accumulation. You must calculate the PK score according to your own business logic before calling the update API. See the following PK score calculation examples:
 >
-| Gift Type | Score Calculation Rule | Example |
-| --- | --- | --- |
-| Basic Gift | Gift value × 5 | 10 RMB gift → 50 points |
-| Intermediate Gift | Gift value × 8 | 50 RMB gift → 400 points |
-| Advanced Gift | Gift value × 12 | 100 RMB gift → 1200 points |
-| Special Effect Gift | Fixed high score | 520 RMB gift → 1314 points |
+
+|Gift Type|Score Calculation Rule|Example|
+|---------|---------|---------|
+|Basic Gift|Gift value × 5|10 RMB gift → 50 points|
+|Intermediate Gift|Gift value × 8|50 RMB gift → 400 points|
+|Advanced Gift|Gift value × 12|100 RMB gift → 1200 points|
+|Special Effect Gift|Fixed high score|520 RMB gift → 1314 points|
 
 #### REST API Call Flow
 
@@ -427,12 +430,13 @@ In typical** live host PK scenarios,** the value of gifts received by the host i
 4. **LiveKit Backend Syncs to Client**: The backend automatically synchronizes the updated PK score to all clients.
 
 #### Involved REST API Endpoints
-| **API** | **Function Description** | **Request Example** |
-| --- | --- | --- |
-| Active API - Query PK Status | Check whether the current room is in PK | Example |
-| Active API - Update PK Score | Update the calculated PK score | Example |
-| Callback Configuration - PK Start Callback | Receive real-time notification when PK starts | Example |
-| Callback Configuration - PK End Callback | Receive real-time notification when PK ends | Example |
+
+|**API**|**Function Description**|**Request Example**|
+|---------|---------|---------|
+|Active API - Query PK Status|Check whether the current room is in PK|Example|
+|Active API - Update PK Score|Update the calculated PK score|Example|
+|Callback Configuration - PK Start Callback|Receive real-time notification when PK starts|Example|
+|Callback Configuration - PK End Callback|Receive real-time notification when PK ends|Example|
 
 ### Winner Determination
 
@@ -453,12 +457,13 @@ private fun observeBattleScore() {
 ## API Documentation
 
 For details on all public interfaces, properties, and methods for CoHostStore, BattleStore, LiveListStore, LiveSeatStore, and related classes, see the [AtomicXCore API documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore).
-| **Store/Component** | **Function Description** | **API Documentation** |
-| --- | --- | --- |
-| CoHostStore | Host Connection Lifecycle Management: Responsible for managing and coordinating the lifecycle of anchor connections, including initiating connection invitations, handling acceptance/rejection, switching connection status, managing video streams during connections, and disconnecting connections. | [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 | Streamer PK Battle Lifecycle Management: Responsible for managing the entire lifecycle of timed PK battles between streamers, including initiating PK invitations, starting the battle, updating PK scores in real time, settling the winner at the end of the PK, and penalty time. | [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) |
-| LiveListStore | Manages live room lifecycle: query room list, modify live info, etc. | [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 | Manages seat states within a room (including cross-room seats), tracks user seat changes, microphone status, and more. | [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) |
+
+|**Store/Component**|**Function Description**|**API Documentation**|
+|---------|---------|---------|
+|CoHostStore|Host Connection Lifecycle Management: Responsible for managing and coordinating the lifecycle of anchor connections, including initiating connection invitations, handling acceptance/rejection, switching connection status, managing video streams during connections, and disconnecting connections.|[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|Streamer PK Battle Lifecycle Management: Responsible for managing the entire lifecycle of timed PK battles between streamers, including initiating PK invitations, starting the battle, updating PK scores in real time, settling the winner at the end of the PK, and penalty time.|[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)|
+|LiveListStore|Manages live room lifecycle: query room list, modify live info, etc.|[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|Manages seat states within a room (including cross-room seats), tracks user seat changes, microphone status, and more.|[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)|
 
 ## FAQs