@tencent-rtc/mcp 1.4.7 → 1.6.0

package/resource/{doc → knowledge}/livekit/core-sdk/live/android/live-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.
@@ -282,6 +288,7 @@ This section demonstrates the basic solution. For the **Gift AR** see the [TCEff
 ``` kotlin
 import android.os.Bundle
 import androidx.appcompat.app.AppCompatActivity
+import com.opensource.svgaplayer.SVGACallback
 import com.opensource.svgaplayer.SVGAParser
 import com.opensource.svgaplayer.SVGAVideoEntity
 import com.opensource.svgaplayer.SVGAImageView
@@ -300,17 +307,9 @@ class LiveRoomActivity : AppCompatActivity() {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_live_room)
         setupSVGAPlayer()
-    }
 
-private fun setupSVGAPlayer() {
-        svgaImageView = findViewById(R.id.svga_player)
-        svgaParser = SVGAParser(this)
-        svgaImageView.visibility = android.view.View.GONE
-
-        // Set the gift animation to play only once.
         svgaImageView.loops = 1
 
-        // Set a completion callback to hide and clean up resources after playback.
         svgaImageView.callback = object : SVGACallback {
             override fun onFinished() {
                 svgaImageView.visibility = android.view.View.GONE
@@ -320,23 +319,32 @@ private fun setupSVGAPlayer() {
             override fun onRepeat() {}
             override fun onStep(frame: Int, percentage: Double) {}
         }
+
+    }
+
+    private fun setupSVGAPlayer() {
+        svgaImageView = findViewById(R.id.svga_player)
+        svgaParser = SVGAParser(this)
+        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 = "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/live/android/live-host-interaction.md

@@ -317,7 +317,7 @@ Use the slot capability in the `VideoViewAdapter` interface to overlay custom vi
    > **Note：**
    >
 
-   > For a complete implementation, refer to the [widgets](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorboardcast/view/cohost/widgets) directory in the open-source TUILiveKit project.
+   > For a complete implementation, refer to the [widgets](https://github.com/Tencent-RTC/TUIKit_Android/tree/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/cohost/widgets) directory in the open-source TUILiveKit project.
    >
 
    ``` kotlin
@@ -429,15 +429,15 @@ Use the slot capability in the `VideoViewAdapter` interface to overlay custom vi
    ```
 
 #### Parameter Description:
-| **Parameter** | **Type** | **Description** |
+| <strong>Parameter</strong> | <strong>Type</strong> | <strong>Description</strong> |
 | --- | --- | --- |
-| `seatInfo` | `SeatFullInfo?` | Seat information object containing user details |
-| `seatInfo.userId` | `String?` | User ID on the seat |
-| `seatInfo.userName` | `String?` | User nickname on the seat |
-| `seatInfo.userAvatar` | `String?` | User avatar URL |
-| `seatInfo.userMicrophoneStatus` | `DeviceStatus` | User microphone status |
-| `seatInfo.userCameraStatus` | `DeviceStatus` | User camera status |
-| `viewLayer` | `ViewLayer` | View layer enum<br>- `FOREGROUND`: Foreground widget view, always displayed on top of the video<br>- `BACKGROUND`: Background widget view, under the foreground view, displayed only when the user has no video stream (e.g., camera off), typically used for the user's default avatar or a placeholder image |
+| <code>seatInfo</code> | <code>SeatFullInfo?</code> | Seat information object containing user details |
+| <code>seatInfo.userId</code> | <code>String?</code> | User ID on the seat |
+| <code>seatInfo.userName</code> | <code>String?</code> | User nickname on the seat |
+| <code>seatInfo.userAvatar</code> | <code>String?</code> | User avatar URL |
+| <code>seatInfo.userMicrophoneStatus</code> | <code>DeviceStatus</code> | User microphone status |
+| <code>seatInfo.userCameraStatus</code> | <code>DeviceStatus</code> | User camera status |
+| <code>viewLayer</code> | <code>ViewLayer</code> | View layer enum<br>- <code>FOREGROUND</code>: Foreground widget view, always displayed on top of the video<br>- <code>BACKGROUND</code>: Background widget view, under the foreground view, displayed only when the user has no video stream (e.g., camera off), typically used for the user's default avatar or a placeholder image |
 
 ### Displaying PK User Score on Video View
 
@@ -446,7 +446,7 @@ When the host starts a PK, you can attach a custom view to the opponent's video
 #### Implementation Example
 
 #### Implementation
-- **Step 1**: Create a custom PK user view. For a complete implementation, see [BattleMemberInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorboardcast/view/battle/widgets/BattleMemberInfoView.kt)  in the open-source TUILiveKit project.
+- **Step 1**: Create a custom PK user view. For a complete implementation, see [BattleMemberInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/battle/widgets/BattleMemberInfoView.kt)  in the open-source TUILiveKit project.
 
    ``` kotlin
    import android.content.Context
@@ -535,21 +535,22 @@ When the host starts a PK, you can attach a custom view to the opponent's video
    ```
 
 #### Parameter Description:
-| **Parameter** | **Type** | **Description** |
-| --- | --- | --- |
-| `battleUser` | `BattleUser?` | PK user info object |
-| `battleUser.roomId` | `String` | PK room ID |
-| `battleUser.userId` | `String` | PK user ID |
-| `battleUser.userName` | `String` | PK user nickname |
-| `battleUser.avatarUrl` | `String` | PK user avatar URL |
-| `battleUser.score` | `UInt` | PK score |
+
+|**Parameter**|**Type**|**Description**|
+|---------|---------|---------|
+|`battleUser`|`BattleUser?`|PK user info object|
+|`battleUser.roomId`|`String`|PK room ID|
+|`battleUser.userId`|`String`|PK user ID|
+|`battleUser.userName`|`String`|PK user nickname|
+|`battleUser.avatarUrl`|`String`|PK user avatar URL|
+|`battleUser.score`|`UInt`|PK score|
 
 ### Displaying PK Status on Video Stream
 
 #### Implementation Example
 
 #### Implementation
-- **Step 1**: Create a custom PK global view (CustomBattleContainerView). For a complete implementation, see [BattleInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorboardcast/view/battle/widgets/BattleInfoView.kt)  in the open-source TUILiveKit project.
+- **Step 1**: Create a custom PK global view (CustomBattleContainerView). For a complete implementation, see [BattleInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/battle/widgets/BattleInfoView.kt)  in the open-source TUILiveKit project.
 
 - **Step 2**: Implement the `VideoViewAdapter.createBattleContainerView `method.
 
@@ -573,12 +574,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
 
@@ -596,22 +598,24 @@ 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|
 
 ## API Documentation
 
 For detailed information on all public interfaces, properties, and methods of [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)  and related classes, refer to the official API documentation included with the [AtomicXCore](https://tencent-rtc.github.io/TUIKit_Android/index.html) framework. The relevant stores used in this guide are as follows:
-| **Store/Component** | **Description** | **API Reference** |
-| --- | --- | --- |
-| `LiveCoreView` | Core view component for displaying and interacting with live video streams. Handles video rendering and view widgets, supports host streaming, audience co-hosting, host connections, and more. | [API Documentation](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) |
-| `DeviceStore` | Controls audio/video devices: microphone (on/off, volume), camera (on/off, switch, quality), screen sharing, and 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) |
-| `CoHostStore` | Handles host cross-room connections: supports multiple layout templates (dynamic grid, etc.), initiates/accepts/rejects connections, and manages co-host interactions. | [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` | Manages host PK battles: initiate PK (set duration/opponent), manage PK status (start/end), synchronize scores, and listen for 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) |
+
+|**Store/Component**|**Description**|**API Reference**|
+|---------|---------|---------|
+|`LiveCoreView`|Core view component for displaying and interacting with live video streams. Handles video rendering and view widgets, supports host streaming, audience co-hosting, host connections, and more.|[API Documentation](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)|
+|`DeviceStore`|Controls audio/video devices: microphone (on/off, volume), camera (on/off, switch, quality), screen sharing, and 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)|
+|`CoHostStore`|Handles host cross-room connections: supports multiple layout templates (dynamic grid, etc.), initiates/accepts/rejects connections, and manages co-host interactions.|[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`|Manages host PK battles: initiate PK (set duration/opponent), manage PK status (start/end), synchronize scores, and listen for 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)|
 
 ## FAQs
 

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

@@ -7,11 +7,11 @@ This document guides you through building a basic live streaming app with host b
 The following view hierarchy diagram illustrates the position and role of **LiveCoreView** within the live streaming interface:
 
 ## Core Concepts
-| **Core Concept** | **Core Responsibility** | **Key API / Property** |
+| <strong>Core Concept</strong> | <strong>Core Responsibility</strong> | <strong>Key API / Property</strong> |
 | --- | --- | --- |
-| LiveCoreView | Handles publishing, playing, and rendering audio/video streams. Provides adapter interfaces for integrating custom UI components (e.g., user info, PK progress bar). | - `viewType`:<br>- `CoreViewType.PUSH_VIEW` (host publishing view)<br>- `CoreViewType.PLAY_VIEW` (audience playback view)<br>- `setLiveId()`: Binds the live room ID for this view.<br>- `setVideoViewAdapter():` Adapter for custom video display UI slots. |
-| LiveListStore | Manages the complete live room lifecycle (create, join, leave), synchronizes state, and listens for passive events (e.g., live ended, kicked out). | - `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 | Defines room parameters before going live, such as room ID, seat layout mode, max co-hosts, etc. | - `liveID`: Unique room identifier.<br>- seatTemplate: Layout template. |
+| LiveCoreView | Handles publishing, playing, and rendering audio/video streams. Provides adapter interfaces for integrating custom UI components (e.g., user info, PK progress bar). | - <code>viewType</code>:<br>- <code>CoreViewType.PUSH_VIEW</code> (host publishing view)<br>- <code>CoreViewType.PLAY_VIEW</code> (audience playback view)<br>- <code>setLiveId()</code>: Binds the live room ID for this view.<br>- <code>setVideoViewAdapter():</code> Adapter for custom video display UI slots. |
+| LiveListStore | Manages the complete live room lifecycle (create, join, leave), synchronizes state, and listens for passive events (e.g., live ended, kicked out). | - <code>createLive()</code>: Start live stream as host.<br>- <code>endLive()</code>: End live stream as host.<br>- <code>joinLive()</code>: Audience joins live room.<br>- <code>leaveLive()</code>: Leave live room. |
+| LiveInfo | Defines room parameters before going live, such as room ID, seat layout mode, max co-hosts, etc. | - <code>liveID</code>: Unique room identifier.<br>- seatTemplate: Layout template. |
 
 ## Preparation
 
@@ -83,9 +83,9 @@ class MainActivity : AppCompatActivity() {
 **Login API Parameter Description**
 | Parameter | Type | Description |
 | --- | --- | --- |
-| SDKAppID | Int | Get this from [TRTC console > Application management](https://console.trtc.io/app). |
+| SDKAppID | Int | Get this from <a href="https://console.trtc.io/app">TRTC console > Application management</a>. |
 | 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. |
+| userSig | String | A ticket for Tencent Cloud authentication. Please note:<br>- <strong>Development Environment</strong>: You can use the local <code>GenerateTestUserSig.genTestSig</code> function to generate a UserSig or generate a temporary UserSig via the <a href="https://console.trtc.io/usersig">UserSig Generation Tool</a>.<br>- <strong>Production Environment</strong>: 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 Live Room
 
@@ -197,20 +197,20 @@ Follow these steps to quickly set up host video streaming:
 
    `LiveInfo`** Parameter Description:**
 
-| **Parameter Name** | **Type** | **Required** | **Description** |
-| --- | --- | --- | --- |
-| `liveID` | `String` | Yes | Unique identifier for the live room. |
-| `liveName` | `String` | No | Title of the live room. |
-| `notice` | `String` | No | Announcement message for the live room. |
-| `isMessageDisable` | `Boolean` | No | Disable chat (true = yes, false = no). |
-| `isPublicVisible` | `Boolean` | No | Room is publicly visible (true = yes, false = no). |
-| `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) | No | Seat mode (FREE: free to take seat, APPLY: apply to take seat). |
-| `seatTemplate` | SeatLayoutTemplate | Yes | Seat layout template. |
-| `coverURL` | `String` | No | Cover image URL for the live room. |
-| `backgroundURL` | `String` | No | Background image URL for the live room. |
-| `categoryList` | `List` | No | List of category tags for the live room. |
-| `activityStatus` | `Int` | No | Live activity status. |
-| `isGiftEnabled` | `Boolean` | No | Whether to enable gift functionality (true: yes, false: no). |
+   |**Parameter Name**|**Type**|**Required**|**Description**|
+   |---------|---------|---------|---------|
+   |`liveID`|`String`|Yes|Unique identifier for the live room.|
+   |`liveName`|`String`|No|Title of the live room.|
+   |`notice`|`String`|No|Announcement message for the live room.|
+   |`isMessageDisable`|`Boolean`|No|Disable chat (true = yes, false = no).|
+   |`isPublicVisible`|`Boolean`|No|Room is publicly visible (true = yes, false = no).|
+   |`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)|No|Seat mode (FREE: free to take seat, APPLY: apply to take seat).|
+   |`seatTemplate`|SeatLayoutTemplate|Yes|Seat layout template.|
+   |`coverURL`|`String`|No|Cover image URL for the live room.|
+   |`backgroundURL`|`String`|No|Background image URL for the live room.|
+   |`categoryList`|`List`<br>|No|List of category tags for the live room.|
+   |`activityStatus`|`Int`|No|Live activity status.|
+   |`isGiftEnabled`|`Boolean`|No|Whether to enable gift functionality (true: yes, false: no).|
 
 4. **End Live Streaming**
 
@@ -439,9 +439,9 @@ class YourAudienceActivity : AppCompatActivity() {
 After integrating `LiveCoreView`, you will have a pure video rendering view with full live streaming capabilities, but without any interactive UI. To add interactive features, see Enriching the Live Streaming Scene.
 |  | Dynamic Grid Layout | Floating Window Layout | Fixed Grid Layout | Fixed Window Layout |
 | --- | --- | --- | --- | --- |
-| **Template** | VideoDynamicGrid9Seats | VideoDynamicFloat7Seats | VideoFixedGrid9Seats | VideoFixedFloat7Seats |
-| **Description** | Default layout; grid size adjusts dynamically based on number of co-hosts. | Co-hosts are displayed as floating windows. | Fixed number of co-hosts; each occupies a fixed grid. | Fixed number of co-hosts; guests are displayed as fixed windows. |
-| **Example** |  |  |  |  |
+| <strong>Template</strong> | VideoDynamicGrid9Seats | VideoDynamicFloat7Seats | VideoFixedGrid9Seats | VideoFixedFloat7Seats |
+| <strong>Description</strong> | Default layout; grid size adjusts dynamically based on number of co-hosts. | Co-hosts are displayed as floating windows. | Fixed number of co-hosts; each occupies a fixed grid. | Fixed number of co-hosts; guests are displayed as fixed windows. |
+| <strong>Example</strong> |  |  |  |  |
 
 ## Advanced Features
 
@@ -509,28 +509,30 @@ private fun subscribeToDataUpdates() {
 ## Enriching the Live Streaming Scene
 
 Once the basic live streaming functionality is in place, refer to the following guides to add interactive features to your live stream:
-| **Feature** | **Description** | **Store** | **Implementation Guide** |
-| --- | --- | --- | --- |
-| **Enable Audience Audio/Video Co-hosting** | Audience can apply to join the host on stage for real-time video interaction. | [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 Guide |
-| **Enable Host Cross-room 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 Guide |
-| **Add Bullet Chat Feature** | Audience can send and receive real-time text messages in the live room. | [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 Guide |
-| **Build a Gift Giving System** | Audience can send virtual gifts to the host, increasing 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 Guide |
+
+|**Feature**|**Description**|**Store**|**Implementation Guide**|
+|---------|---------|---------|---------|
+|**Enable Audience Audio/Video Co-hosting**|Audience can apply to join the host on stage for real-time video interaction.|[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 Guide|
+|**Enable Host Cross-room 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 Guide|
+|**Add Bullet Chat Feature**|Audience can send and receive real-time text messages in the live room.|[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 Guide|
+|**Build a Gift Giving System**|Audience can send virtual gifts to the host, increasing 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 Guide|
 
 ## API Documentation
-| **Store/Component** | **Description** | **API Reference** |
-| --- | --- | --- |
-| LiveCoreView | Core view component for displaying and interacting with live video streams. Handles video rendering and view widgets, supports host streaming, audience co-hosting, host connections, and more. | [API Documentation](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 | Manages the full lifecycle of live rooms: create/join/leave/destroy rooms, query room list, modify live info (name, announcement, etc.), and listen to live status events (e.g., 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) |
-| DeviceStore | Controls audio/video devices: microphone (on/off, volume), camera (on/off, switch, quality), screen sharing, and 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 | Manages audience co-hosting: apply/invite/accept/reject co-host requests, member permission control (microphone/camera), and 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 | Handles host cross-room connections: supports multiple layout templates (dynamic grid, etc.), initiates/accepts/rejects connections, and manages co-host interactions. | [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 | Manages host PK battles: initiate PK (set duration/opponent), manage PK status (start/end), synchronize scores, and listen for 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 | Handles gift interactions: get gift list, send/receive gifts, and 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 | Supports live chat: send text/custom danmaku, maintain danmaku list, and monitor danmaku 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) |
-| LikeStore | Handles like interactions: send likes, listen for like events, and 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 | Manages audience: get real-time audience list (ID/name/avatar), count audience, and listen for 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 change (child/male), reverb (KTV, etc.), ear return adjustment, and 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) |
-| BaseBeautyStore | Basic beauty filters: adjust smoothing/whitening/rosiness (0-9), reset beauty status, and synchronize effect parameters. | [API Documentation](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) |
+
+|**Store/Component**|**Description**|**API Reference**|
+|---------|---------|---------|
+|LiveCoreView|Core view component for displaying and interacting with live video streams. Handles video rendering and view widgets, supports host streaming, audience co-hosting, host connections, and more.|[API Documentation](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|Manages the full lifecycle of live rooms: create/join/leave/destroy rooms, query room list, modify live info (name, announcement, etc.), and listen to live status events (e.g., 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)|
+|DeviceStore|Controls audio/video devices: microphone (on/off, volume), camera (on/off, switch, quality), screen sharing, and 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|Manages audience co-hosting: apply/invite/accept/reject co-host requests, member permission control (microphone/camera), and 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|Handles host cross-room connections: supports multiple layout templates (dynamic grid, etc.), initiates/accepts/rejects connections, and manages co-host interactions.|[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|Manages host PK battles: initiate PK (set duration/opponent), manage PK status (start/end), synchronize scores, and listen for 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|Handles gift interactions: get gift list, send/receive gifts, and 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|Supports live chat: send text/custom danmaku, maintain danmaku list, and monitor danmaku 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)|
+|LikeStore|Handles like interactions: send likes, listen for like events, and 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|Manages audience: get real-time audience list (ID/name/avatar), count audience, and listen for 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 change (child/male), reverb (KTV, etc.), ear return adjustment, and 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)|
+|BaseBeautyStore|Basic beauty filters: adjust smoothing/whitening/rosiness (0-9), reset beauty status, and synchronize effect parameters.|[API Documentation](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)|
 
 ## FAQs