@tencent-rtc/mcp 1.3.9 → 1.4.0

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

@@ -1,77 +1,24 @@
 This document guides you through building a voice chat room application with host broadcasting and audience participation features using the **AtomicXCore** SDK's `LiveListStore` and `LiveSeatStore`.
 
 ## Core Concepts
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Core Concept**</td>
-
-<td rowspan="1" colSpan="1" >**Type**</td>
-
-<td rowspan="1" colSpan="1" >**Core Responsibilities & Description**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveListStore`</td>
-
-<td rowspan="1" colSpan="1" >`class`</td>
-
-<td rowspan="1" colSpan="1" >- `createLive()`: Start live stream as host.<br>- `endLive()`: End live stream as host.<br>- `joinLive()`: Audience joins live room.<br>- `leaveLive()`: Leave live room.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveInfo`</td>
-
-<td rowspan="1" colSpan="1" >`struct`</td>
-
-<td rowspan="1" colSpan="1" >- `liveID`: Unique room identifier.<br>- `seatLayoutTemplateID`: Layout template ID (e.g., 600 for dynamic grid).</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveSeatStore`</td>
-
-<td rowspan="1" colSpan="1" >`class`</td>
-
-<td rowspan="1" colSpan="1" >- Core seat management class. Manages all seat information and seat-related operations in the room.<br>- Provides a real-time seat list data stream via liveSeatState.seatList.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveSeatState`</td>
-
-<td rowspan="1" colSpan="1" >`struct`</td>
-
-<td rowspan="1" colSpan="1" >Represents the current state of all seats.<br>- `seatList`: a StateFlow containing the real-time seat list.<br>- `speakingUsers`: users currently speaking and their volume.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`SeatInfo`</td>
-
-<td rowspan="1" colSpan="1" >`class`</td>
-
-<td rowspan="1" colSpan="1" >Data model for a single seat. The seat list (seatList) emitted by LiveSeatStore is a list of SeatInfo objects.<br>Key fields:<br>- `index`: seat position.<br>- `isLocked`: whether the seat is locked.<br>- `userInfo`: user information for the seat. If the seat is empty, this field is empty.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`SeatUserInfo`</td>
-
-<td rowspan="1" colSpan="1" >`class`</td>
-
-<td rowspan="1" colSpan="1" >Detailed data model for the user occupying a seat. When a user successfully takes a seat, the userInfo field in SeatInfo is populated.<br>Key fields:<br>- `userID`: unique user ID.<br>- `userName`: user nickname.<br>- `avatarURL`: user avatar URL.<br>- `microphoneStatus`: microphone status (on/off).<br>- `cameraStatus`: camera status (on/off).</td>
-</tr>
-</table>
-
+| **Core Concept** | **Type** | **Core Responsibilities & Description** |
+| --- | --- | --- |
+| `LiveListStore` | `class` | - `createLive()`: Start live stream as host.<br>- `endLive()`: End live stream as host.<br>- `joinLive()`: Audience joins live room.<br>- `leaveLive()`: Leave live room. |
+| `LiveInfo` | `struct` | - `liveID`: Unique room identifier.<br>- `seatLayoutTemplateID`: Layout template ID (e.g., 600 for dynamic grid). |
+| `LiveSeatStore` | `class` | - Core seat management class. Manages all seat information and seat-related operations in the room.<br>- Provides a real-time seat list data stream via liveSeatState.seatList. |
+| `LiveSeatState` | `struct` | Represents the current state of all seats.<br>- `seatList`: a StateFlow containing the real-time seat list.<br>- `speakingUsers`: users currently speaking and their volume. |
+| `SeatInfo` | `class` | Data model for a single seat. The seat list (seatList) emitted by LiveSeatStore is a list of SeatInfo objects.<br>Key fields:<br>- `index`: seat position.<br>- `isLocked`: whether the seat is locked.<br>- `userInfo`: user information for the seat. If the seat is empty, this field is empty. |
+| `SeatUserInfo` | `class` | Detailed data model for the user occupying a seat. When a user successfully takes a seat, the userInfo field in SeatInfo is populated.<br>Key fields:<br>- `userID`: unique user ID.<br>- `userName`: user nickname.<br>- `avatarURL`: user avatar URL.<br>- `microphoneStatus`: microphone status (on/off).<br>- `cameraStatus`: camera status (on/off). |
 
 ## Prerequisites
 
 ### Step 1: Activate the Service
 
-See [Activate Service](https://write.woa.com/document/141936672617742336) to obtain either the trial or paid version of the SDK.Then, go to [the Console](https://console.trtc.io/app) for application management, and get the following:
+See Activate Service to obtain either the trial or paid version of the SDK.Then, go to [the Console](https://console.trtc.io/app) for application management, and get the following:
 - `SDKAppID`: Application identifier (required). Tencent Cloud uses `SDKAppID` for billing and details.
 
 - `SDKSecretKey`: Application secret key, used to initialize the configuration file with secret information.
 
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/e0818e31c9f311f09e745254007c27c5.png)
-
-
 ### Step 2: Import AtomicXCore into Your Project
 1. **Install the Component**: Add `pod 'AtomicXCore'` to your `Podfile`, then run `pod install`.
 
@@ -86,18 +33,16 @@ See [Activate Service](https://write.woa.com/document/141936672617742336) to obt
    <key>NSMicrophoneUsageDescription</key>
    <string>TUILiveKit needs microphone permission to enable sound in recorded videos</string>
    ```
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/e07effb5c9f311f0a93d52540044a08e.png)
-
 
 ### Step 3: Implement Login Logic
 
 Call `LoginStore.shared.login` in your project to complete authentication. **This is required before using any functionality of AtomicXCore**.
 
 > **Note：**
-> 
+>
 
 > We recommend calling LoginStore.shared.login only after your app's own user authentication is successful, to ensure clear and consistent login logic.
-> 
+>
 
 ``` swift
 import AtomicXCore
@@ -119,40 +64,11 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
 ```
 
 **Login API Parameter Description**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >Parameter</td>
-
-<td rowspan="1" colSpan="1" >Type</td>
-
-<td rowspan="1" colSpan="1" >Description</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`sdkAppID`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >Get this from [TRTC console > Application management](https://console.trtc.io/app).</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`userID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >The unique ID for the current user. Must contain only English letters, numbers, hyphens, and underscores.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`userSig`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >A ticket for Tencent Cloud authentication. Please note:<br>- **Development Environment**: You can use the local `GenerateTestUserSig.genTestSig` function to generate a UserSig or generate a temporary UserSig via the [UserSig Generation Tool](https://console.trtc.io/usersig).<br>- **Production Environment**: To prevent key leakage, you must use a server-side method to generate UserSig. For details, see [Generating UserSig on the Server](https://write.woa.com/document/89644530319802368).<br>- For more information, see [How to Calculate and Use UserSig](https://write.woa.com/document/89644530319802368).</td>
-</tr>
-</table>
-
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `sdkAppID` | `Int` | Get this from [TRTC console > Application management](https://console.trtc.io/app). |
+| `userID` | `String` | The unique ID for the current user. Must contain only English letters, numbers, hyphens, and underscores. |
+| `userSig` | `String` | A ticket for Tencent Cloud authentication. Please note:<br>- **Development Environment**: You can use the local `GenerateTestUserSig.genTestSig` function to generate a UserSig or generate a temporary UserSig via the [UserSig Generation Tool](https://console.trtc.io/usersig).<br>- **Production Environment**: To prevent key leakage, you must use a server-side method to generate UserSig. For details, see Generating UserSig on the Server.<br>- For more information, see How to Calculate and Use UserSig. |
 
 ## Building a Basic Voice Chat Room
 
@@ -183,7 +99,7 @@ class YourAnchorViewController: UIViewController {
     override func viewDidLoad() {
         super.viewDidLoad()
         // Initialize your layout here
-        // setupUI() 
+        // setupUI()
 
         // Listen for seat list changes
         observeSeatList()
@@ -231,7 +147,7 @@ import AtomicXCore
 class YourAnchorViewController: UIViewController {
     // ... other code ...
     private let liveID = "test_voice_room_001"
-    
+
     override func viewDidLoad() {
         super.viewDidLoad()
         // ... other code ...
@@ -245,11 +161,8 @@ class YourAnchorViewController: UIViewController {
 
         liveInfo.liveID = liveID
         liveInfo.liveName = "test voice chat room"
-        liveInfo.isSeatEnabled = true
-        liveInfo.keepOwnerOnSeat = true
-        liveInfo.seatLayoutTemplateID = 70 // Use correct ID per product spec
+        liveInfo.seatTemplate = SeatLayoutTemplate.AudioSalon(seatCount: 9) // Set the live streaming template to the voice chat room template, with 9 seats
         liveInfo.seatMode = .apply
-        liveInfo.maxSeatCount = 10
 
         liveListStore.createLive(liveInfo) { [weak self] result in
             guard let self = self else { return }
@@ -267,177 +180,28 @@ class YourAnchorViewController: UIViewController {
 ```
 
 **LiveInfo Parameter Reference:**
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Parameter Name**</td>
-
-<td rowspan="1" colSpan="1" >**Type**</td>
-
-<td rowspan="1" colSpan="1" >**Required**</td>
-
-<td rowspan="1" colSpan="1" >**Description**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Required</td>
-
-<td rowspan="1" colSpan="1" >Unique identifier for the live room</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`liveName`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Room title</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`notice`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Room announcement</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`isMessageDisable`</td>
-
-<td rowspan="1" colSpan="1" >`Bool`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Mute chat (`true`: muted, `false`: not muted)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`isPublicVisible`</td>
-
-<td rowspan="1" colSpan="1" >`Bool`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Public visibility (`true`: visible, `false`: not visible)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`isSeatEnabled`</td>
-
-<td rowspan="1" colSpan="1" >`Bool`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Enable seat feature (`true`: enabled, `false`: disabled)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`keepOwnerOnSeat`</td>
-
-<td rowspan="1" colSpan="1" >`Bool`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Keep host on seat</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`maxSeatCount`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >Required</td>
-
-<td rowspan="1" colSpan="1" >Maximum number of seats</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`seatMode`</td>
-
-<td rowspan="1" colSpan="1" >`TakeSeatMode`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Seat mode (`.free`: free seat, `.apply`: apply for seat)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`seatLayoutTemplateID`</td>
-
-<td rowspan="1" colSpan="1" >`UInt`</td>
-
-<td rowspan="1" colSpan="1" >Required</td>
-
-<td rowspan="1" colSpan="1" >Seat layout template ID</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`coverURL`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Room cover image URL</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`backgroundURL`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Room background image URL</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`categoryList`</td>
-
-<td rowspan="1" colSpan="1" >`[NSNumber]`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Room category tags</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`activityStatus`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Live activity status</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`isGiftEnabled`</td>
-
-<td rowspan="1" colSpan="1" >`Bool`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Enable gift feature (`true`: enabled, `false`: disabled)</td>
-</tr>
-</table>
-
+| **Parameter Name** | **Type** | **Required** | **Description** |
+| --- | --- | --- | --- |
+| `liveID` | `String` | Required | Unique identifier for the live room |
+| `liveName` | `String` | Optional | Room title |
+| `notice` | `String` | Optional | Room announcement |
+| `isMessageDisable` | `Bool` | Optional | Mute chat (`true`: muted, `false`: not muted) |
+| `isPublicVisible` | `Bool` | Optional | Public visibility (`true`: visible, `false`: not visible) |
+| `seatMode` | `TakeSeatMode` | Optional | Seat mode (`.free`: free seat, `.apply`: apply for seat) |
+| `seatTemplate` | `SeatLayoutTemplate` | Required | Seat layout template ID |
+| `coverURL` | `String` | Optional | Room cover image URL |
+| `backgroundURL` | `String` | Optional | Room background image URL |
+| `categoryList` | `[NSNumber]` | Optional | Room category tags |
+| `activityStatus` | `Int` | Optional | Live activity status |
+| `isGiftEnabled` | `Bool` | Optional | Enable gift feature (`true`: enabled, `false`: disabled) |
 
 #### **4. Build the Mic Seat UI**
 
 > **Note：**
-> 
+>
 
 > For seat UI logic and effects, refer to the open-source [SeatGridView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/SeatGridview/SeatGridView.swift) in TUILiveKit.
-> 
-
+>
 
 Use your `LiveSeatStore` instance to subscribe to `state.seatList` and update the UI in real time:
 ``` swift
@@ -512,7 +276,7 @@ class YourAudienceViewController: UIViewController {
     private let liveListStore = LiveListStore.shared
 
     // Use the same liveID as the host
-    private let liveID = "test_voice_room_001" 
+    private let liveID = "test_voice_room_001"
     private lazy var liveSeatStore = LiveSeatStore.create(liveID: liveID)
 
     private var cancellables = Set<AnyCancellable>()
@@ -574,7 +338,7 @@ class YourAudienceViewController: UIViewController {
 
 #### **3. Build the Mic Seat UI**
 
-Building the seat UI for audience members is identical to the host process. Refer to the host [Build the Mic Seat UI.](https://write.woa.com/#15f887ab-f1bb-41ec-9143-c1e791d875fb)
+Building the seat UI for audience members is identical to the host process. Refer to the host Build the Mic Seat UI.
 
 #### **4. Leave the Voice Chat Room**
 
@@ -585,7 +349,7 @@ import AtomicXCore
 
 class YourAudienceViewController: UIViewController {
     // ... other code ...
-    
+
     private func leaveLive() {
         liveListStore.leaveLive { result in
             switch result {
@@ -603,8 +367,6 @@ class YourAudienceViewController: UIViewController {
 
 After completing these steps, you will have a functional voice chat live streaming room. For advanced features, see "Enriching Voice Chat Room Scenarios" below.
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/a05436e9c9f511f09e745254007c27c5.png)
-
 ## Advanced Features
 
 ### Implementing Speaking Wave Animation for Users on Seat
@@ -613,17 +375,13 @@ In voice chat rooms, it's common to show a wave animation over the avatar of use
 
 #### Example
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/3e599bf8c9f711f0a4a55254001c06ec.gif)
-
-
 #### Implementation
 
 > **Note：**
-> 
+>
 
 > For a complete implementation of the speaking wave animation, refer to [SeatGridView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/SeatGridview/SeatGridView.swift) in TUILiveKit.
-> 
-
+>
 
 In your `YourAnchorViewController` or `YourAudienceViewController`, subscribe to `speakingUsers` and update the UI accordingly:
 ``` swift
@@ -643,7 +401,7 @@ class YourAnchorViewController: UIViewController {
     }
 
     private func observeSpeakingUsersState() {
-        liveSeatStore.state           
+        liveSeatStore.state
             .subscribe(StatePublisherSelector(keyPath: \LiveSeatState.speakingUsers))
             .removeDuplicates()
             .receive(on: DispatchQueue.main)
@@ -665,7 +423,6 @@ In live streaming room, the host may need to synchronize custom information to a
 
 2. On the audience side, subscribe to `LiveListState.currentLive` and listen for changes in `metaData`. When a relevant key is updated, parse its value and update your business state.
 
-
 #### Code Example
 ``` swift
 import AtomicXCore
@@ -717,166 +474,28 @@ private func subscribeToDataUpdates() {
 ## Enriching Voice Chat Room Scenarios
 
 After implementing the basic voice chat room, enhance your application with the following features:
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Feature**</td>
-
-<td rowspan="1" colSpan="1" >**Description**</td>
-
-<td rowspan="1" colSpan="1" >**Store**</td>
-
-<td rowspan="1" colSpan="1" >**Implementation Guide**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Audience Take Seat**</td>
-
-<td rowspan="1" colSpan="1" >Audience members can apply to take a seat and interact with the host in real time.</td>
-
-<td rowspan="1" colSpan="1" >[CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation](https://write.woa.com/document/194571595735859200)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Host Cross-Room PK**</td>
-
-<td rowspan="1" colSpan="1" >Hosts from different rooms can connect for interaction or PK.</td>
-
-<td rowspan="1" colSpan="1" >[CoHostStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore)<br>[BattleStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation](https://write.woa.com/document/194571595881611264)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Add Barrage Chat**</td>
-
-<td rowspan="1" colSpan="1" >Room members can send and receive real-time text messages.</td>
-
-<td rowspan="1" colSpan="1" >[BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation](https://write.woa.com/document/195218523643924480)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >**Gift System**</td>
-
-<td rowspan="1" colSpan="1" >Audience can send virtual gifts to hosts to increase interaction and engagement.</td>
-
-<td rowspan="1" colSpan="1" >[GiftStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation](https://write.woa.com/document/195218406733824000)</td>
-</tr>
-</table>
-
+| **Feature** | **Description** | **Store** | **Implementation Guide** |
+| --- | --- | --- | --- |
+| **Audience Take Seat** | Audience members can apply to take a seat and interact with the host in real time. | [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) | Implementation |
+| **Host Cross-Room PK** | Hosts from different rooms can connect for interaction or PK. | [CoHostStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore)<br>[BattleStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore) | Implementation |
+| **Add Barrage Chat** | Room members can send and receive real-time text messages. | [BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) | Implementation |
+| **Gift System** | Audience can send virtual gifts to hosts to increase interaction and engagement. | [GiftStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore) | Implementation |
 
 ## API Documentation
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Store/Component**</td>
-
-<td rowspan="1" colSpan="1" >**Description**</td>
-
-<td rowspan="1" colSpan="1" >**API Docs**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveListStore`</td>
-
-<td rowspan="1" colSpan="1" >Manages the full live room lifecycle: create, join, leave, destroy room; query room list; modify room info; listen for room status changes.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveSeatStore`</td>
-
-<td rowspan="1" colSpan="1" >Seat management: handle seat list, user status, seat operations (take seat, leave seat, kick, lock, toggle mic/camera), and seat events.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`DeviceStore`</td>
-
-<td rowspan="1" colSpan="1" >Audio/video device control: microphone, camera, screen sharing, device status monitoring.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore/)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`CoGuestStore`</td>
-
-<td rowspan="1" colSpan="1" >Audience co-host management: application, invitation, acceptance, rejection, member permissions, status sync.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore/)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`CoHostStore`</td>
-
-<td rowspan="1" colSpan="1" >Host cross-room connection: supports multiple layouts, initiate/accept/reject connection, manage co-host interaction.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore/)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`BattleStore`</td>
-
-<td rowspan="1" colSpan="1" >Host PK battle: initiate PK, manage PK status, synchronize scores, listen for battle results.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`GiftStore`</td>
-
-<td rowspan="1" colSpan="1" >Gift interaction: fetch gift list, send/receive gifts, listen for gift events.</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" >Barrage (chat overlay): send text/custom barrage, maintain barrage list, monitor barrage status.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LikeStore`</td>
-
-<td rowspan="1" colSpan="1" >Like interaction: send likes, listen for like events, synchronize like count.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/likestore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveAudienceStore`</td>
-
-<td rowspan="1" colSpan="1" >Audience management: get real-time audience list, count, entry/exit events.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`AudioEffectStore`</td>
-
-<td rowspan="1" colSpan="1" >Audio effects: voice change, reverb, in-ear monitoring, effect switching.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`BaseBeautyStore`</td>
-
-<td rowspan="1" colSpan="1" >Basic beauty: adjust smoothing/whitening/redness (0-100), reset beauty status, synchronize effect parameters.</td>
-
-<td rowspan="1" colSpan="1" >[API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore)</td>
-</tr>
-</table>
-
+| **Store/Component** | **Description** | **API Docs** |
+| --- | --- | --- |
+| `LiveListStore` | Manages the full live room lifecycle: create, join, leave, destroy room; query room list; modify room info; listen for room status changes. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore) |
+| `LiveSeatStore` | Seat management: handle seat list, user status, seat operations (take seat, leave seat, kick, lock, toggle mic/camera), and seat events. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore) |
+| `DeviceStore` | Audio/video device control: microphone, camera, screen sharing, device status monitoring. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore/) |
+| `CoGuestStore` | Audience co-host management: application, invitation, acceptance, rejection, member permissions, status sync. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore/) |
+| `CoHostStore` | Host cross-room connection: supports multiple layouts, initiate/accept/reject connection, manage co-host interaction. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore/) |
+| `BattleStore` | Host PK battle: initiate PK, manage PK status, synchronize scores, listen for battle results. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore) |
+| `GiftStore` | Gift interaction: fetch gift list, send/receive gifts, listen for gift events. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore/) |
+| `BarrageStore` | Barrage (chat overlay): send text/custom barrage, maintain barrage list, monitor barrage status. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) |
+| `LikeStore` | Like interaction: send likes, listen for like events, synchronize like count. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/likestore) |
+| `LiveAudienceStore` | Audience management: get real-time audience list, count, entry/exit events. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore) |
+| `AudioEffectStore` | Audio effects: voice change, reverb, in-ear monitoring, effect switching. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore) |
+| `BaseBeautyStore` | Basic beauty: adjust smoothing/whitening/redness (0-100), reset beauty status, synchronize effect parameters. | [API Documentation](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore) |
 
 ## FAQs
 
@@ -887,12 +506,9 @@ After implementing the basic voice chat room, enhance your application with the
 
 - **Check network**: Confirm the device has a stable network connection.
 
-
 ### Why is the seat list not displayed or not updating?
 - **Check store initialization**: Confirm you create the `LiveSeatStore` instance (`LiveSeatStore.create(liveID: liveID)`) with the same `liveID` before calling `createLive` or `joinLive`.
 
 - **Check data subscription**: Make sure you use Combine to subscribe to `liveSeatStore.state.seatList`, and the `cancellables` lifecycle matches your `ViewController`.
 
 - **Check API calls**: Ensure `createLive` (host) or `joinLive` (audience) was called successfully (check the `.success` branch in `switch result`).
-
-