@tencent-rtc/mcp 1.3.9 → 1.4.0

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

@@ -1,22 +1,7 @@
 `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.
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Gift Panel**</td>
-
-<td rowspan="1" colSpan="1" >**Barrage Gift**</td>
-
-<td rowspan="1" colSpan="1" >**Full-Screen Gift**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/33aa8083c6e111f0b011525400bf7822.png)</td>
-
-<td rowspan="1" colSpan="1" >![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/33925a80c6e111f087ad52540099c741.png)</td>
-
-<td rowspan="1" colSpan="1" >![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/33c98fa2c6e111f09e745254007c27c5.gif)</td>
-</tr>
-</table>
-
+| **Gift Panel** | **Barrage Gift** | **Full-Screen Gift** |
+| --- | --- | --- |
+|  |  |  |
 
 ## Core Features
 - **Gift List Retrieval**: Retrieve gift panel data from the server, including gift categories and details.
@@ -25,73 +10,28 @@
 
 - **Gift Event Broadcasting:** Real-time synchronization of gift events across all clients in the room to trigger animations and barrage notifications.
 
-
 ## 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" >`Gift`</td>
-
-<td rowspan="1" colSpan="1" >`struct`</td>
-
-<td rowspan="1" colSpan="1" >Represents a gift data model, including ID, name, icon URL, animation resource URL (resourceURL), price (coins), and more.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`GiftCategory`</td>
-
-<td rowspan="1" colSpan="1" >`struct`</td>
-
-<td rowspan="1" colSpan="1" >- Represents a grouping of gifts (e.g., "Popular", "Luxury"). <br>- Contains a category name and an array of Gift objects.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`GiftState`</td>
-
-<td rowspan="1" colSpan="1" >`struct`</td>
-
-<td rowspan="1" colSpan="1" >- Represents the current state of the gift module. <br>- The core property, usableGifts, is a StateFlow containing the full gift list from the server.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`GiftEvent`</td>
-
-<td rowspan="1" colSpan="1" >`enum`</td>
-
-<td rowspan="1" colSpan="1" >Defines the event listener for gift events in the live room. Currently, only `onReceiveGift` is available. This event is broadcast to all users in the room (including the sender) whenever a gift is successfully sent.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`GiftStore`</td>
-
-<td rowspan="1" colSpan="1" >`class`</td>
-
-<td rowspan="1" colSpan="1" >- The core management class for gift features. <br>- Used to fetch gift lists, execute send requests, and listen for global gift events.</td>
-</tr>
-</table>
-
+| **Core Concept** | **Type** | **Core Responsibilities & Description** |
+| --- | --- | --- |
+| `Gift` | `struct` | Represents a gift data model, including ID, name, icon URL, animation resource URL (resourceURL), price (coins), and more. |
+| `GiftCategory` | `struct` | - Represents a grouping of gifts (e.g., "Popular", "Luxury").<br>- Contains a category name and an array of Gift objects. |
+| `GiftState` | `struct` | - Represents the current state of the gift module.<br>- The core property, usableGifts, is a StateFlow containing the full gift list from the server. |
+| `GiftEvent` | `enum` | Defines the event listener for gift events in the live room. Currently, only `onReceiveGift` is available. This event is broadcast to all users in the room (including the sender) whenever a gift is successfully sent. |
+| `GiftStore` | `class` | - The core management class for gift features.<br>- Used to fetch gift lists, execute send requests, and listen for global gift events. |
 
 ## Implementation
 
 ### Step 1: Component Integration
 
 > **Note：**
-> 
-
-> To use the gifting system, activate either the **Free Trial,** or **Pro **edition. The number of configurable gifts depends on the selected package. For details, see the **Gift System** section in [Feature and Billing Description](https://write.woa.com/document/137771241658241024) and choose the package that fits your needs.
-> 
+>
 
-- **Video Live Streaming**: Please refer to [Quick Start](https://write.woa.com/document/194571606121816064) to integrate AtomicXCore.
+> To use the gifting system, activate either the **Free Trial,** or **Pro **edition. The number of configurable gifts depends on the selected package. For details, see the **Gift System** section in Feature and Billing Description and choose the package that fits your needs.
+>
 
-- **Voice Chat Room**: Please refer to [Quick Start](https://write.woa.com/document/194571595685527552) to integrate AtomicXCore.
+- **Video Live Streaming**: Please refer to Quick Start to integrate AtomicXCore.
 
+- **Voice Chat Room**: Please refer to Quick Start to integrate AtomicXCore.
 
 ### Step 2: Initialize and Listen for Gift Events
 
@@ -104,18 +44,17 @@ Obtain a `GiftStore` instance and set up subscribers to receive gift events and
 
 3. **Subscribe to State**: Subscribe to `giftStore.state` to obtain the `usableGifts` gift list.
 
-
 #### Code Example
 ``` swift
 import Foundation
-import AtomicXCore 
-import Combine     
+import AtomicXCore
+import Combine
 
 class GiftManager {
     private let liveId: String
     private let giftStore: GiftStore
     private var cancellables = Set<AnyCancellable>()
-    
+
     // Expose gift events for the UI layer to subscribe and trigger animations
     let giftEventPublisher = PassthroughSubject<GiftEvent, Never>()
     // Expose gift list externally
@@ -125,7 +64,7 @@ class GiftManager {
         self.liveId = liveId
         // 1. Obtain GiftStore instance using liveId
         self.giftStore = GiftStore.create(liveID: liveId)
-        
+
         subscribeToGiftState()
         subscribeToGiftEvents()
     }
@@ -140,7 +79,7 @@ class GiftManager {
             }
             .store(in: &cancellables)
     }
-    
+
     /// 3. Subscribe to gift list state
     private func subscribeToGiftState() {
         giftStore.state
@@ -155,132 +94,26 @@ class GiftManager {
 #### Gift List Struct Parameters
 - **GiftCategory 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" >`categoryID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Unique ID of the gift category.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`name`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Display name of the gift category.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`desc`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Description of the gift category.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`extensionInfo`</td>
-
-<td rowspan="1" colSpan="1" >`[String: String]`</td>
-
-<td rowspan="1" colSpan="1" >Extension information field.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`giftList`</td>
-
-<td rowspan="1" colSpan="1" >`[`[Gift](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/gift)`]`</td>
-
-<td rowspan="1" colSpan="1" >Array of Gift objects contained in this category.</td>
-</tr>
-</table>
+| **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` | `[String: String]` | Extension information field. |
+| `giftList` | `[`[Gift](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/gift)`]` | Array of Gift objects contained in this category. |
 
 - **Gift 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" >`giftID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Unique ID of the gift.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`name`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Display name of the gift.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`desc`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Description of the gift.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`iconURL`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Gift icon URL.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`resourceURL`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Gift animation resource URL.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`level`</td>
-
-<td rowspan="1" colSpan="1" >`UInt`</td>
-
-<td rowspan="1" colSpan="1" >Gift level.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`coins`</td>
-
-<td rowspan="1" colSpan="1" >`UInt`</td>
-
-<td rowspan="1" colSpan="1" >Gift price.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`extensionInfo`</td>
-
-<td rowspan="1" colSpan="1" >`[String: String]`</td>
-
-<td rowspan="1" colSpan="1" >Extension information field.</td>
-</tr>
-</table>
-
+| **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` | `UInt` | Gift level. |
+| `coins` | `UInt` | Gift price. |
+| `extensionInfo` | `[String: String]` | Extension information field. |
 
 ### Step 3: Retrieve Gift List
 
@@ -291,8 +124,7 @@ Call the `refreshUsableGifts` method to fetch gift data from the server.
 
 2. **Handle Callback**: Handle the completion block for error checking.
 
-3. **Receive Data**: Upon success, the data flows automatically through the giftListPublisher set up in [Step 2](https://write.woa.com/#634828fc-7b2c-4a61-9140-60efc5246431).
-
+3. **Receive Data**: Upon success, the data flows automatically through the giftListPublisher set up in Step 2.
 
 #### Code Example
 ``` swift
@@ -323,7 +155,6 @@ Trigger the sending logic when a user interacts with the gift panel.
 
 3. **Handle Result**: Use the completion block only to handle failures (e.g., balance errors). Successful sends are handled via the global `.onReceiveGift` event listener to ensure consistency.
 
-
 #### Code Example
 ``` swift
 extension GiftManager {
@@ -344,40 +175,11 @@ extension GiftManager {
 ```
 
 #### sendGift API Parameters
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Parameter Name**</td>
-
-<td rowspan="1" colSpan="1" >**Type**</td>
-
-<td rowspan="1" colSpan="1" >**Description**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`giftID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >The unique ID of the gift to send.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`count`</td>
-
-<td rowspan="1" colSpan="1" >`UInt`</td>
-
-<td rowspan="1" colSpan="1" >The number of gifts to send.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`completion`</td>
-
-<td rowspan="1" colSpan="1" >`CompletionClosure?`</td>
-
-<td rowspan="1" colSpan="1" >Callback after sending is complete.</td>
-</tr>
-</table>
-
+| **Parameter Name** | **Type** | **Description** |
+| --- | --- | --- |
+| `giftID` | `String` | The unique ID of the gift to send. |
+| `count` | `UInt` | The number of gifts to send. |
+| `completion` | `CompletionClosure?` | Callback after sending is complete. |
 
 ## Advanced Features
 
@@ -388,134 +190,39 @@ The `GiftStore` module is designed to work seamlessly with your backend infrastr
 You can fully customize your gift inventory (names, icons, prices, animations) to match your branding.
 
 #### Implementation
-1. **Server-Side Configuration**: Use the LiveKit server REST API to manage gift information, categories, and multi-language support. See the [Gift Configuration Guide](https://write.woa.com/document/185130564680273920).
+1. **Server-Side Configuration**: Use the LiveKit server REST API to manage gift information, categories, and multi-language support. See the Gift Configuration Guide.
 
 2. **Client Fetch**: On the client, call `refreshUsableGifts` to retrieve configuration data.
 
 3. **UI Display**: Use the retrieved `List<GiftCategory>` to render the gift panel.
 
-
 #### Configuration Sequence Diagram
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/3c2e9ac9c6e111f0a7775254005ef0f7.png)
-
-
 #### Related REST API Interfaces Overview
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Interface Category**</td>
-
-<td rowspan="1" colSpan="1" >**Interface**</td>
-
-<td rowspan="1" colSpan="1" >**Request Example**</td>
-</tr>
-
-<tr>
-<td rowspan="3" colSpan="1" >**​Gift Management**</td>
-
-<td rowspan="1" colSpan="1" >Add Gift Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185130814885187584)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Delete Gift Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131021432451072)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Query Gift Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185130925608591360)</td>
-</tr>
-
-<tr>
-<td rowspan="3" colSpan="1" >**Gift Category Management**</td>
-
-<td rowspan="1" colSpan="1" >Add Gift Category Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131054187974656)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Delete Specific Gift Category Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131288984932352)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Get Specific Gift Category Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131164168736768)</td>
-</tr>
-
-<tr>
-<td rowspan="3" colSpan="1" >**Gift Relationship Management**</td>
-
-<td rowspan="1" colSpan="1" >Add Relationship between a Specific Gift Category and Gift</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131388068356096)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Delete Relationship between a Specific Gift Category and Gift</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131491225227264)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Get Gift Relationships under a Specific Gift Category</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131634710056960)</td>
-</tr>
-
-<tr>
-<td rowspan="6" colSpan="1" >**Gift Multi-language Management**</td>
-
-<td rowspan="1" colSpan="1" >Add Gift Multi-language Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131766094020608)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Delete Specific Gift Multi-language Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185132041665441792)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Get Gift Multi-language Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185131910582956032)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Add Gift Category Multi-language Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185132145524985856)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Delete Specific Gift Category Multi-language Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185132396568891392)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Get Gift Category Multi-language Information</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/185132283123777536)</td>
-</tr>
-</table>
-
+| **Interface Category** | **Interface** | **Request Example** |
+| --- | --- | --- |
+| **​Gift Management** | Add Gift Information | Example |
+| Delete Gift Information | Example |  |
+| Query Gift Information | Example |  |
+| **Gift Category Management** | 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 |
+| 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 |
+| Delete Specific Gift Multi-language Information | Example |  |
+| Get Gift Multi-language Information | Example |  |
+| Add Gift Category Multi-language Information | Example |  |
+| Delete Specific Gift Category Multi-language Information | Example |  |
+| Get Gift Category Multi-language Information | Example |  |
 
 ### Billing and Gift Deduction Process
 
 AtomicXCore delegates the billing logic to your backend to ensure security and flexibility.
 
 #### Workflow
-1. **Backend Callback Configuration**: Configure your billing system's callback URL in the LiveKit backend. See [Callback Configuration Documentation](https://write.woa.com/document/155612057789870080).
+1. **Backend Callback Configuration**: Configure your billing system's callback URL in the LiveKit backend. See Callback Configuration Documentation.
 
 2. **Client Request**: The client calls `sendGift`.
 
@@ -523,31 +230,12 @@ AtomicXCore delegates the billing logic to your backend to ensure security and f
 
 4. **Result Synchronization**: If succeeds, **AtomicXCore** broadcasts the `onReceiveGift` event; if fails, the completion callback of `sendGift` receives an error.
 
-
 #### Call Flow
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/416552bdc6e111f09e745254007c27c5.png)
-
-
 #### Related REST API Interfaces Overview
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Interface**</td>
-
-<td rowspan="1" colSpan="1" >**Description**</td>
-
-<td rowspan="1" colSpan="1" >**Request Example**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Callback Configuration - Callback before sending a gift**</td>
-
-<td rowspan="1" colSpan="1" >Pre-gifting validation hook. <br>Allows your backend to intercept gift requests to perform necessary checks (e.g., sufficient balance, risk control) before the gift is processed.</td>
-
-<td rowspan="1" colSpan="1" >[Example](https://write.woa.com/document/183772991768039424)</td>
-</tr>
-</table>
-
+| **Interface** | **Description** | **Request Example** |
+| --- | --- | --- |
+| **Callback Configuration - Callback before sending a gift** | Pre-gifting validation hook.<br>Allows your backend to intercept gift requests to perform necessary checks (e.g., sufficient balance, risk control) before the gift is processed. | Example |
 
 ### Full-Screen Animation (SVGA Integration)
 
@@ -556,56 +244,13 @@ 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:
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Comparison Item**</td>
-
-<td rowspan="1" colSpan="1" >**Basic Solution (SVGAPlayer)**</td>
-
-<td rowspan="1" colSpan="1" >**Gift AR (TCEffectPlayerKit)**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Billing</td>
-
-<td rowspan="1" colSpan="1" >Free (open source)</td>
-
-<td rowspan="1" colSpan="1" >Paid (License Required). See [Billing Guide](https://trtc.io/document/69949?product=beautyar&menulabel=core%20sdk&platform=android#X-Series-Capabilities)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Integration Method</td>
-
-<td rowspan="1" colSpan="1" >Manual integration via Gradle</td>
-
-<td rowspan="1" colSpan="1" >Requires additional integration and authentication</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" > Formats</td>
-
-<td rowspan="1" colSpan="1" >SVGA only</td>
-
-<td rowspan="1" colSpan="1" >SVGA, PAG, WebP, Lottie, MP4, and more</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Performance</td>
-
-<td rowspan="1" colSpan="1" >Good for files < 10MB</td>
-
-<td rowspan="1" colSpan="1" >Optimized for large assets & complex layering</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Recommended Scenario</td>
-
-<td rowspan="1" colSpan="1" >Uniform SVGA format, controllable file size</td>
-
-<td rowspan="1" colSpan="1" >Multiple formats or higher performance/device compatibility needs</td>
-</tr>
-</table>
-
+| **Comparison Item** | **Basic Solution (SVGAPlayer)** | **Gift AR (TCEffectPlayerKit)** |
+| --- | --- | --- |
+| Billing | Free (open source) | Paid (License Required). 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 |
+| Formats | SVGA only | SVGA, PAG, WebP, Lottie, MP4, and more |
+| Performance | Good for files < 10MB | Optimized for large assets & complex layering |
+| 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/70537?product=beautyar&menulabel=core%20sdk&platform=ios).
 
@@ -622,11 +267,10 @@ This section demonstrates the basic solution. For the **Gift AR**, see the [TCEf
 
 3. **Parse and Play**: When receiving an `.onReceiveGift` event, check if `gift.resourceURL` is valid and points to an SVGA file. If so, use `SVGAParser` to parse the URL and pass the parsed `SVGAVideoEntity` to the `SVGAPlayer` instance for playback.
 
-
 #### Code Example
 ``` swift
 import UIKit
-import AtomicXCore 
+import AtomicXCore
 import Combine
 import SVGAPlayer // 1. Import
 
@@ -697,7 +341,6 @@ Enhance social interaction by displaying a system notification in the public bar
 
 5. **Insert Locally**: Call `barrageStore.appendLocalTip(message: giftTip)` to insert the message into the local list.
 
-
 #### Code Example
 ``` swift
 // In LiveRoomManager or a similar top-level manager
@@ -713,7 +356,7 @@ private func setupGiftToBarrageFlow() {
             // 4. Compose message
             let tipText = "\(sender.userName) sent \(gift.name) x \(count)"
             var giftTip = Barrage()
-            giftTip.messageType = .text 
+            giftTip.messageType = .text
             giftTip.textContent = tipText
             // Optional: set a special sender
 
@@ -727,32 +370,10 @@ private func setupGiftToBarrageFlow() {
 ## API Documentation
 
 For complete details on all public interfaces, properties, and methods of [GiftStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore) and related classes, see the official API documentation for [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore). Key stores referenced in this guide include:
-<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" >GiftStore</td>
-
-<td rowspan="1" colSpan="1" >Fetch gift list, send/receive gifts, listen for gift events (including sender and gift details).</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >BarrageStore</td>
-
-<td rowspan="1" colSpan="1" >Send text/custom barrage, maintain barrage list, listen to barrage status in real time.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)</td>
-</tr>
-</table>
-
+| **Store/Component** | **Feature Description** | **API Documentation** |
+| --- | --- | --- |
+| GiftStore | Fetch gift list, send/receive gifts, listen for gift events (including sender and gift details). | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore) |
+| BarrageStore | Send text/custom barrage, maintain barrage list, listen to barrage status in real time. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) |
 
 ## FAQs
 
@@ -769,7 +390,6 @@ Use the `GiftStore.setLanguage(language: String)` API before calling `refreshUsa
 The `onReceiveGift` event is broadcast to all room members, including the sender. If you update the UI both in the sendGift completion callback and in the `onReceiveGift` event, the animation will play twice.
 - **Best Practice**: Only update the UI (e.g., play animations, show barrage) in the `onReceiveGift` event handler. Use the `sendGift` completion callback only for handling failures (such as "Send failed" or "Insufficient balance").
 
-
 ### Where is the gift deduction logic implemented?
 
 Gift deduction is handled entirely by your billing system. AtomicXCore integrates with your billing system via a backend callback. When the client calls `sendGift`, your backend performs the deduction. After returning the result to the AtomicXCore backend, it determines whether to broadcast the gift event.
@@ -780,4 +400,4 @@ No. Gift notifications (`onReceiveGift` events) are not affected by mute or freq
 
 ### What should I do if gift animation playback stutters?
 
-Check your SVGA file size; the basic player recommends files no larger than 10MB. For large or complex animations, consider integrating the **Gift AR** provided by TUILiveKit for improved performance.
+Check your SVGA file size; the basic player recommends files no larger than 10MB. For large or complex animations, consider integrating the **Gift AR** provided by TUILiveKit for improved performance.