@tencent-rtc/mcp 1.3.8 → 1.4.0

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

@@ -6,63 +6,28 @@ 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:
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100043650599/96041acccc0711f093295254001c06ec.png)
-
-
 ## Core Concepts
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Core Concept**</td>
-
-<td rowspan="1" colSpan="1" >**Core Responsibility**</td>
-
-<td rowspan="1" colSpan="1" >**Key API / Property**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >LiveCoreView</td>
-
-<td rowspan="1" colSpan="1" >Handles publishing, playing, and rendering audio/video streams. Provides adapter interfaces for integrating custom UI components (e.g., user info, PK progress bar).</td>
-
-<td rowspan="1" colSpan="1" >- `viewType`:<br>  - `.pushView` (host publishing view)<br>  - `.playView` (audience playback view)<br>- `setLiveId()`: Binds the live room ID for this view.<br>- `videoViewDelegate`: Adapter for custom video display UI slots.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >LiveListStore</td>
-
-<td rowspan="1" colSpan="1" >Manages the complete live room lifecycle (create, join, leave), synchronizes state, and listens for passive events (e.g., live ended, kicked out).</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" >Defines room parameters before going live, such as room ID, seat layout mode, max co-hosts, etc.</td>
-
-<td rowspan="1" colSpan="1" >- `liveID`: Unique room identifier.<br>- `seatLayoutTemplateID`: Layout template ID (e.g., 600 for dynamic grid).</td>
-</tr>
-</table>
-
+| **Core Concept** | **Core Responsibility** | **Key API / Property** |
+| --- | --- | --- |
+| 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>- `.pushView` (host publishing view)<br>- `.playView` (audience playback view)<br>- `setLiveId()`: Binds the live room ID for this view.<br>- `videoViewDelegate`: 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. |
 
 ## Preparation
 
 ### 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/100043650599/a926d228cc0711f093295254001c06ec.png)
-
-
 ### Step 2: Import AtomicXCore into Your Project
 1. **Install the Component**: Add `pod 'AtomicXCore'` to your `Podfile`, then run `pod install`.
 
    ``` ruby
    target 'xxxx' do
-     pod 'AtomicXCore'
+     pod 'AtomicXCore', '~> 4.0'
    end
    ```
 2. **Configure App Permissions**: Add camera and microphone usage descriptions to your app's `Info.plist` file.
@@ -73,18 +38,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/100043650599/b47f58e0cc0711f0afdc52540044a08e.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
@@ -106,40 +69,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](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).</td>
-</tr>
-</table>
-
+| **Parameter** | **Type** | **Description** |
+| --- | --- | --- |
+| `SDKAppID` | `Int` | Get this from [TRTC console](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. |
 
 ## Building a Basic Live Room
 
@@ -147,30 +81,26 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
 
 Follow these steps to quickly set up broadcaster video streaming:
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100043650599/bf07f34bcc0711f0ae4f52540099c741.png)
-
-
 > **Note：**
-> 
+>
 
 > For a complete broadcaster streaming implementation, refer to [TUILiveRoomAnchorViewController.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/LiveStream/TUILiveRoomAnchorViewController.swift) in the TUILiveKit open source project.
-> 
+>
 
 1. **Initialize the Broadcaster Streaming View**
 
-
    In your broadcaster view controller, create a `LiveCoreView` instance and set `viewType` to `.pushView`.
 
    ``` swift
    import AtomicXCore
-   
+
    // YourAnchorViewController represents your broadcaster streaming view controller
    class YourAnchorViewController: UIViewController {
-   
+
        private let liveId: String
        // 1. Add LiveCoreView as a property of your view controller
        private let coreView = LiveCoreView(viewType: .pushView, frame: UIScreen.main.bounds)
-   
+
        // 2. Add a convenience initializer for instance initialization
        //    - liveId: The ID of the live room to start streaming
        public init(liveId: String) {
@@ -178,11 +108,11 @@ Follow these steps to quickly set up broadcaster video streaming:
            super.init(nibName: nil, bundle: nil)
            self.coreView.setLiveID(liveId)
        }
-   
+
        required init?(coder: NSCoder) {
            fatalError("init(coder:) has not been implemented")
        }
-   
+
        public override func viewDidLoad() {
            super.viewDidLoad()
            // 3. Add the broadcaster streaming view to your view
@@ -192,12 +122,11 @@ Follow these steps to quickly set up broadcaster video streaming:
    ```
 2. **Open Camera and Microphone**
 
-
    Call `DeviceStore.shared.openLocalCamera` and `DeviceStore.shared.openLocalMicrophone` to open the camera and microphone. **No further action is required—LiveCoreView automatically previews the current camera video stream**.
 
    ``` swift
    import AtomicXCore
-   
+
    class YourAnchorViewController: UIViewController {
        // ... other code ...
        public override func viewDidLoad() {
@@ -205,7 +134,7 @@ Follow these steps to quickly set up broadcaster video streaming:
            // Enable devices
            openDevices()
        }
-   
+
        private func openDevices() {
            // 1. Enable front camera
            DeviceStore.shared.openLocalCamera(isFront: true, completion: nil)
@@ -216,16 +145,15 @@ Follow these steps to quickly set up broadcaster video streaming:
    ```
 3. **Start Live Streaming**
 
-
    Call `LiveListStore.shared.createLive` to start streaming.
 
    ``` swift
    import AtomicXCore
-   
+
    class YourAnchorViewController: UIViewController {
-   
+
        // ... other code ...
-   
+
        // Call the start streaming interface to begin live streaming
        private func startLive() {
            var liveInfo = LiveInfo()
@@ -233,11 +161,9 @@ Follow these steps to quickly set up broadcaster video streaming:
            liveInfo.liveID = self.liveId
            // 2. Set the live room name
            liveInfo.liveName = "test live"
-           // 3. Configure layout template, default: 600 dynamic grid layout
-           liveInfo.seatLayoutTemplateID = 600
-           // 4. Keep the broadcaster always on the seat
-           liveInfo.keepOwnerOnSeat = true
-           // 5. Call LiveListStore.shared.createLive to start streaming
+           // 3. Configure the seat layout template. Default: VideoDynamicGrid9Seats (portrait dynamic video grid layout)
+           liveInfo.seatTemplate = .videoDynamicGrid9Seats
+           // 4. Call LiveListStore.shared.createLive to start streaming
            LiveListStore.shared.createLive(liveInfo) { [weak self] result in
                guard let self = self else { return }
                switch result {
@@ -253,180 +179,32 @@ Follow these steps to quickly set up broadcaster video streaming:
 
    `LiveInfo` Parameter Descriptions:
 
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Parameter Name**</td>
-
-<td rowspan="1" colSpan="1" >**Type**</td>
-
-<td rowspan="1" colSpan="1" >**Attribute**</td>
-
-<td rowspan="1" colSpan="1" >**Description**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`liveID`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Required</td>
-
-<td rowspan="1" colSpan="1" >Unique identifier for the live room.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`liveName`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Title of the live room.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`notice`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Announcement for the live room.</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" >Whether to mute chat (true: yes, false: no).</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" >Whether the room is publicly visible (true: yes, false: no).</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" >Whether to enable seat functionality (true: yes, false: no).</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" >Whether to keep the owner on the 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 to take seat, .apply: apply to take 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" >Cover image URL for the live room.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`backgroundURL`</td>
-
-<td rowspan="1" colSpan="1" >`String`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Background image URL for the live room.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`categoryList`</td>
-
-<td rowspan="1" colSpan="1" >`NSNumber`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Category tag list for the live room.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`activityStatus`</td>
-
-<td rowspan="1" colSpan="1" >`Int`</td>
-
-<td rowspan="1" colSpan="1" >Optional</td>
-
-<td rowspan="1" colSpan="1" >Live activity status.</td>
-</tr>
-
-<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" >Whether to enable gift functionality (true: yes, false: no).</td>
-</tr>
-</table>
+| **Parameter Name** | **Type** | **Attribute** | **Description** |
+| --- | --- | --- | --- |
+| `liveID` | `String` | Required | Unique identifier for the live room. |
+| `liveName` | `String` | Optional | Title of the live room. |
+| `notice` | `String` | Optional | Announcement for the live room. |
+| `isMessageDisable` | `Bool` | Optional | Whether to mute chat (true: yes, false: no). |
+| `isPublicVisible` | `Bool` | Optional | Whether the room is publicly visible (true: yes, false: no). |
+| `seatMode` | `TakeSeatMode` | Optional | Seat mode (.free: free to take seat, .apply: apply to take seat). |
+| `seatTemplate` | SeatLayoutTemplate | Required | Seat layout template. |
+| `coverURL` | `String` | Optional | Cover image URL for the live room. |
+| `backgroundURL` | `String` | Optional | Background image URL for the live room. |
+| `categoryList` | `NSNumber` | Optional | Category tag list for the live room. |
+| `activityStatus` | `Int` | Optional | Live activity status. |
+| `isGiftEnabled` | `Bool` | Optional | Whether to enable gift functionality (true: yes, false: no). |
 
 4. **End Live Streaming**
 
-
    After the live stream ends, call `LiveListStore.shared.endLive `to stop streaming and destroy the room. The SDK handles cleanup automatically.
 
    ``` swift
    import AtomicXCore
-   
+
    class YourAnchorViewController: UIViewController {
-   
+
        // ... other code ...
-   
+
        // End live streaming
        private func stopLive() {
            LiveListStore.shared.endLive { [weak self] result in
@@ -446,40 +224,36 @@ Follow these steps to quickly set up broadcaster video streaming:
 
 Enable audience viewing with the following steps:
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100043650599/d1169383cc0711f084a45254005ef0f7.png)
-
-
 > **Note：**
-> 
+>
 
 > For a complete audience playback implementation, refer to [TUILiveRoomAudienceViewController.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/LiveStream/TUILiveRoomAudienceViewController.swift) in the TUILiveKit open source project.
-> 
+>
 
 1. **Implement the Audience Playback Page**
 
-
    In your audience view controller, create a `LiveCoreView` instance and set `viewType` to `.playView`.
 
    ``` swift
    import AtomicXCore
-   
+
    class YourAudienceViewController: UIViewController {
-   
+
        // 1. Initialize the audience playback page
        private let coreView = LiveCoreView(viewType: .playView, frame: UIScreen.main.bounds)
        private let liveId: String
-   
+
        public init(liveId: String) {
            self.liveId = liveId
            super.init(nibName: nil, bundle: nil)
            // 2. Bind the live ID
            self.coreView.setLiveID(liveId)
        }
-   
+
        required init?(coder: NSCoder) {
            fatalError("init(coder:) has not been implemented")
        }
-   
+
        public override func viewDidLoad() {
            super.viewDidLoad()
            // 3. Add the playback view to your view
@@ -489,22 +263,21 @@ Enable audience viewing with the following steps:
    ```
 2. **Join the Live Room to Watch**
 
-
    Call `LiveListStore.shared.joinLive` to join the live stream. **No further action is required—LiveCoreView will automatically play the current room's video stream**.
 
    ``` swift
    import AtomicXCore
-   
+
    class YourAudienceViewController: UIViewController {
        // ... other code ...
-   
+
        public override func viewDidLoad() {
            super.viewDidLoad()
            view.addSubview(coreView)
            // 4. Join the live room
            joinLive()
        }
-   
+
        private func joinLive() {
            // Call LiveListStore.shared.joinLive to enter the live room
            // - liveId: Same liveId as the broadcaster
@@ -524,16 +297,15 @@ Enable audience viewing with the following steps:
    ```
 3. **Leave the Live Room**
 
-
    When the audience leaves, call `LiveListStore.shared.leaveLive` to exit. The SDK will automatically stop playback and leave the room.
 
    ``` swift
    import AtomicXCore
-   
+
    class YourAudienceViewController: UIViewController {
-   
+
        // ... other code ...
-   
+
        // Leave the live room
        private func leaveLive() {
            LiveListStore.shared.leaveLive { [weak self] result in
@@ -602,57 +374,12 @@ class YourAudienceViewController: UIViewController {
 
 ### Run and Test
 
-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](https://write.woa.com/#enriching-the-live-streaming-scene).
-<table>
-<tr>
-<td rowspan="1" colSpan="1" ></td>
-
-<td rowspan="1" colSpan="1" >**Dynamic Grid Layout**</td>
-
-<td rowspan="1" colSpan="1" >**Floating Window Layout**</td>
-
-<td rowspan="1" colSpan="1" >**Fixed Grid Layout**</td>
-
-<td rowspan="1" colSpan="1" >**Fixed Window Layout**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Template ID</td>
-
-<td rowspan="1" colSpan="1" >600</td>
-
-<td rowspan="1" colSpan="1" >601</td>
-
-<td rowspan="1" colSpan="1" >800</td>
-
-<td rowspan="1" colSpan="1" >801</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Description</td>
-
-<td rowspan="1" colSpan="1" >Default layout; grid size adjusts dynamically based on number of co-hosts.</td>
-
-<td rowspan="1" colSpan="1" >Co-hosts are displayed as floating windows.</td>
-
-<td rowspan="1" colSpan="1" >Fixed number of co-hosts; each occupies a fixed grid.</td>
-
-<td rowspan="1" colSpan="1" >Fixed number of co-hosts; guests are displayed as fixed windows.</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Example</td>
-
-<td rowspan="1" colSpan="1" ><br>![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100043650599/6a730a2ecc0d11f084a45254005ef0f7.png)</td>
-
-<td rowspan="1" colSpan="1" ><br>![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100043650599/71c322e9cc0d11f084a45254005ef0f7.png)</td>
-
-<td rowspan="1" colSpan="1" ><br>![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100043650599/a1855792cc0d11f0ae4f52540099c741.png)</td>
-
-<td rowspan="1" colSpan="1" ><br>![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100043650599/8885e3ffcc0d11f0afdc52540044a08e.png)</td>
-</tr>
-</table>
-
+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 ID | .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 |  |  |  |  |
 
 ## Advanced Features
 
@@ -665,7 +392,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 +443,28 @@ private func 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:
-<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" >Enable Audience Audio/Video Co-hosting</td>
-
-<td rowspan="1" colSpan="1" >Audience can apply to join the host and interact via real-time video.</td>
-
-<td rowspan="1" colSpan="1" >[CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation Guide](https://write.woa.com/document/194571607036174336)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Enable 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)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation Guide](https://write.woa.com/document/194571607415758848)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Add Bullet Chat Feature</td>
-
-<td rowspan="1" colSpan="1" >Audience can send and receive real-time text messages in the live room.</td>
-
-<td rowspan="1" colSpan="1" >[BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation Guide](https://write.woa.com/document/194571607781711872)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >Build a Gift Giving System</td>
-
-<td rowspan="1" colSpan="1" >Audience can send virtual gifts to the host, increasing engagement and fun.</td>
-
-<td rowspan="1" colSpan="1" >[GiftStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore)</td>
-
-<td rowspan="1" colSpan="1" >[Implementation Guide](https://write.woa.com/document/194571602052481024)</td>
-</tr>
-</table>
-
+| **Feature** | **Description** | **Store** | **Implementation Guide** |
+| --- | --- | --- | --- |
+| Enable Audience Audio/Video Co-hosting | Audience can apply to join the host and interact via real-time video. | [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) | Implementation Guide |
+| Enable 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) | 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_iOS/documentation/atomicxcore/barragestore) | 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_iOS/documentation/atomicxcore/giftstore) | Implementation Guide |
 
 ## 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 Reference**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >LiveCoreView</td>
-
-<td rowspan="1" colSpan="1" >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.</td>
-
-<td rowspan="1" colSpan="1" >[LiveCoreView](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview/)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >LiveListStore</td>
-
-<td rowspan="1" colSpan="1" >Manages the full lifecycle of live rooms: create/join/leave/destroy rooms, query room list, modify live info (name, announcement, etc.), and listen to live status events (e.g., kicked out, ended).</td>
-
-<td rowspan="1" colSpan="1" >[LiveListStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >DeviceStore</td>
-
-<td rowspan="1" colSpan="1" >Controls audio/video devices: microphone (on/off, volume), camera (on/off, switch, quality), screen sharing, and real-time device status monitoring.</td>
-
-<td rowspan="1" colSpan="1" >[DeviceStore](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" >Manages audience co-hosting: apply/invite/accept/reject co-host requests, member permission control (microphone/camera), and status synchronization.</td>
-
-<td rowspan="1" colSpan="1" >[CoGuestStore](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" >Handles host cross-room connections: supports multiple layout templates (dynamic grid, etc.), initiates/accepts/rejects connections, and manages co-host interactions.</td>
-
-<td rowspan="1" colSpan="1" >[CoHostStore](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" >Manages host PK battles: initiate PK (set duration/opponent), manage PK status (start/end), synchronize scores, and listen for battle results.</td>
-
-<td rowspan="1" colSpan="1" >[BattleStore](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" >Handles gift interactions: get gift list, send/receive gifts, and listen for gift events (including sender and gift details).</td>
-
-<td rowspan="1" colSpan="1" >[GiftStore](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" >Supports live chat: send text/custom danmaku, maintain danmaku list, and monitor danmaku status in real time.</td>
-
-<td rowspan="1" colSpan="1" >[BarrageStore](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" >Handles like interactions: send likes, listen for like events, and synchronize total like count.</td>
-
-<td rowspan="1" colSpan="1" >[LikeStore](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" >Manages audience: get real-time audience list (ID/name/avatar), count audience, and listen for join/leave events.</td>
-
-<td rowspan="1" colSpan="1" >[LiveAudienceStore](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 (child/male), reverb (KTV, etc.), ear return adjustment, and real-time effect switching.</td>
-
-<td rowspan="1" colSpan="1" >[AudioEffectStore](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 filters: adjust smoothing/whitening/rosiness (0-9), reset beauty status, and synchronize effect parameters.</td>
-
-<td rowspan="1" colSpan="1" >[BaseBeautyStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore)</td>
-</tr>
-</table>
-
+| **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. | [LiveCoreView](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview/) |
+| 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). | [LiveListStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore) |
+| DeviceStore | Controls audio/video devices: microphone (on/off, volume), camera (on/off, switch, quality), screen sharing, and real-time device status monitoring. | [DeviceStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/devicestore) |
+| CoGuestStore | Manages audience co-hosting: apply/invite/accept/reject co-host requests, member permission control (microphone/camera), and status synchronization. | [CoGuestStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cogueststore) |
+| CoHostStore | Handles host cross-room connections: supports multiple layout templates (dynamic grid, etc.), initiates/accepts/rejects connections, and manages co-host interactions. | [CoHostStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore) |
+| BattleStore | Manages host PK battles: initiate PK (set duration/opponent), manage PK status (start/end), synchronize scores, and listen for battle results. | [BattleStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore) |
+| GiftStore | Handles gift interactions: get gift list, send/receive gifts, and listen for gift events (including sender and gift details). | [GiftStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/giftstore) |
+| BarrageStore | Supports live chat: send text/custom danmaku, maintain danmaku list, and monitor danmaku status in real time. | [BarrageStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) |
+| LikeStore | Handles like interactions: send likes, listen for like events, and synchronize total like count. | [LikeStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/likestore) |
+| LiveAudienceStore | Manages audience: get real-time audience list (ID/name/avatar), count audience, and listen for join/leave events. | [LiveAudienceStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore) |
+| AudioEffectStore | Audio effects: voice change (child/male), reverb (KTV, etc.), ear return adjustment, and real-time effect switching. | [AudioEffectStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/audioeffectstore) |
+| BaseBeautyStore | Basic beauty filters: adjust smoothing/whitening/rosiness (0-9), reset beauty status, and synchronize effect parameters. | [BaseBeautyStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/basebeautystore) |
 
 ## FAQs
 
@@ -889,13 +477,11 @@ Once the basic live streaming functionality is in place, refer to the following
 
 - **Check the network**: Ensure the device has a stable network connection.
 
-
 ### After the host enables the camera, why is there a local video preview after starting the stream, but a black screen before starting?
 - **Check the host side**: Make sure the host streaming view (`LiveCoreView`) has its `viewType` set to `PUSH_VIEW`.
 
 - **Check the audience side**: Make sure the audience playback view (`LiveCoreView`) has its `viewType` set to `PLAY_VIEW`.
 
-
 ### What restrictions and rules apply to `updateLiveMetaData`?
 
 To maintain system stability and efficiency, metaData usage follows these rules:
@@ -911,7 +497,6 @@ To maintain system stability and efficiency, metaData usage follows these rules:
 
 - **Conflict Resolution**: The update mechanism is "last write wins". If multiple administrators modify the same key in quick succession, the last change takes effect. Avoid concurrent modifications to the same key in your business logic.
 
-
 ### sync Fails to Copy Third-party Library Resources Due to Insufficient Permissions
 
 For example, when integrating the SnapKit framework with Xcode, you may encounter the following build error:
@@ -927,5 +512,3 @@ Solution Steps
 1. Disable user script sandboxing. Open your Xcode project, go to **Build Settings**, search for User Script Sandboxing (or `ENABLE_USER_SCRIPT_SANDBOXING`), and change its value from YES to NO.
 
 2. Clean and rebuild the project. Run **Product → Clean** Build Folder to clear the project cache, then rebuild and run the project.
-
-