npm - @tencentcloud/sdk-mcp - Versions diffs - 1.3.9 → 1.4.0 - Mend

@tencentcloud/sdk-mcp 1.3.9 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (510) hide show

package/resource/doc/livekit/{voice → core-sdk/voice}/ios/voice-host-interaction.md RENAMED Viewed

@@ -1,71 +1,18 @@
 `AtomicXCore` 提供了 `CoHostStore` 和 `BattleStore` 两个模块，分别用于处理**跨房连线**和 **PK 对战**。本文将指导您如何组合使用这两个工具，完成语聊房场景下的连线和 PK 功能的开发。
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100038646063/9a1b8a61cc3111f084a45254005ef0f7.jpeg)
 ## 核心概念
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**核心概念**</td>
-<td rowspan="1" colSpan="1" >**类型**</td>
-<td rowspan="1" colSpan="1" >**核心职责与描述**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**CoHostStore**</td>
-<td rowspan="1" colSpan="1" >class</td>
-<td rowspan="1" colSpan="1" >管理主播间的连线生命周期，提供连线功能 API（requestHostConnection、acceptHostConnection）。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**BattleStore**</td>
-<td rowspan="1" colSpan="1" >class</td>
-<td rowspan="1" colSpan="1" >管理跨房 PK 对战的信令与数据，包括 PK 状态。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**LiveListStore**</td>
-<td rowspan="1" colSpan="1" >class</td>
-<td rowspan="1" colSpan="1" >提供直播房间列表的拉取功能 (`fetchLiveList`)，用于获取可连线的其他房间信息。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**LiveSeatStore**</td>
-<td rowspan="1" colSpan="1" >class</td>
-<td rowspan="1" colSpan="1" >管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风等状态。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**CoHostLayoutTemplate**</td>
-<td rowspan="1" colSpan="1" >enum</td>
-<td rowspan="1" colSpan="1" >连线时，用于指定房间麦位布局模板，例如`.hostStaticVoice6v6`。</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**BattleConfig**</td>
-<td rowspan="1" colSpan="1" >struct</td>
-<td rowspan="1" colSpan="1" >配置 PK 的详细信息，例如 PK 时长 (`duration`) 和是否需要二次响应 (`needResponse`)。</td>
-</tr>
-</table>
+| **核心概念** | **类型** | **核心职责与描述** |
+| --- | --- | --- |
+| **CoHostStore** | class | 管理主播间的连线生命周期，提供连线功能 API（requestHostConnection、acceptHostConnection）。 |
+| **BattleStore** | class | 管理跨房 PK 对战的信令与数据，包括 PK 状态。 |
+| **LiveListStore** | class | 提供直播房间列表的拉取功能 (`fetchLiveList`)，用于获取可连线的其他房间信息。 |
+| **LiveSeatStore** | class | 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风等状态。 |
+| **CoHostLayoutTemplate** | enum | 连线时，用于指定房间麦位布局模板，例如`.hostStaticVoice6v6`。 |
+| **BattleConfig** | struct | 配置 PK 的详细信息，例如 PK 时长 (`duration`) 和是否需要二次响应 (`needResponse`)。 |
 ## 前提条件
-请参考 [快速接入](https://write.woa.com/document/192834898445422592) 集成 **AtomicXCore SDK**，并完成 **主播开播** 和 **观众观看** 的功能实现。
+请参考 快速接入 集成 **AtomicXCore SDK**，并完成 **主播开播** 和 **观众观看** 的功能实现。
 ## 主播发起一场连线
@@ -76,9 +23,9 @@
 **实现方式： **调用 `LiveListStore.shared.fetchLiveList`。
 > **注意：**
->
+>
 > - 如果接口返回的列表中没有找到您想要的直播间，您需要检查开播时设置的 `TUILiveInfo` 的 `isPublicVisible` 字段是否为 `true`；
-> - 该接口支持分页继续拉取，您可以使用`result`为 `success` 时的`cursor`作为下一次续拉的游标，如果返回的 `cursor` 为空，则表示直播间列表已全部拉取完；
+> - 该接口支持分页继续拉取，您可以使用`result`为 `success` 时的`cursor`作为下一次续拉的游标，如果返回的 `cursor` 为空，则表示直播间列表已全部拉取完；
 > - 为了性能考虑，建议您将count设置为 20。
 ``` swift
@@ -108,7 +55,7 @@ func fetchLiveListForCoHost() {
 您可以在主播选中指定的主播连线时，调用 `CoHostStore` 的 `requestHostConnection` 接口发起连线邀请。
 > **说明：**
->
+>
 > - AtomicXCore最大支持 **9** 个房间互相连线，每个房间支持 **50 **路用户。
 > - 该接口支持批量发起邀请，您可以按需使用；单个直播间是否邀请成功，您需要在 `completion` 回调中检查`Result`是否为`.success`。
 > - 该接口支持扩展字段，邀请发送成功后，该字段会随着 `CoHostEventPublisher ` 的 `onCoHostRequestReceived` 回调通知给对端主播，您可以在这个字段中携带 “**是否立即开始 PK 对战**” 等信息，来实现自己的特殊业务。
@@ -131,7 +78,7 @@ coHostStore.requestHostConnection(
   completion: { [weak self] result in
     guard let self = self else { return }
     switch result {
-        case .success():
+        case .success():
            print("邀请发送成功")
            break
         case .failure(let error):
@@ -269,7 +216,7 @@ coHostStore.requestHostConnection(
   completion: { [weak self] result in
     guard let self = self else { return }
     switch result {
-        case .success():
+        case .success():
            print("邀请发送成功")
            break
         case .failure(let error):
@@ -299,32 +246,10 @@ func onExitButtonClicked() {
 ## 主播发起 PK
 主播发起 PK 支持两种主要业务流程，以满足不同直播互动需求。核心区别在于 PK 发起前房间的状态。
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**PK 模式**</td>
-<td rowspan="1" colSpan="1" >**房间状态（PK 前）**</td>
-<td rowspan="1" colSpan="1" >**房间状态（PK 后）**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**场景一：主播在连线后再发起 PK**</td>
-<td rowspan="1" colSpan="1" >双方**已连线**</td>
-<td rowspan="1" colSpan="1" >恢复连线状态</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**场景二：主播发起带 PK 模式的连线**</td>
-<td rowspan="1" colSpan="1" >双方**未连线**</td>
-<td rowspan="1" colSpan="1" >恢复连线状态</td>
-</tr>
-</table>
+| **PK 模式** | **房间状态（PK 前）** | **房间状态（PK 后）** |
+| --- | --- | --- |
+| **场景一：主播在连线后再发起 PK** | 双方**已连线** | 恢复连线状态 |
+| **场景二：主播发起带 PK 模式的连线** | 双方**未连线** | 恢复连线状态 |
 ### 场景一：主播在连线后再发起 PK
@@ -341,17 +266,12 @@ AtomicXCore 支持您在这些主播中发起限时的对战 PK。交互如下
 6. 当 PK 完全结束后又恢复到连线状态。
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100038646063/9ee5406bcc3111f08e74525400bf7822.png)
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100038646063/9b49a9bacc3111f093295254001c06ec.png)
 #### 步骤 1. 连线主播发起 PK 邀请
 当主播已经处于跨房连线时，可以在参与连线的主播之间发起一场限时 PK，`AtomicXCore` 支持您设置 PK 的时长、是否需要对端主播同意才开始 PK 以及发起 PK 时携带扩展信息。您可以调用 `BattleStore` 的 `requestBattle` 接口发起 PK 邀请。
 > **说明：**
->
+>
 > - 当您不设置 `BattleConfig` 的 `duration` 字段时， PK 默认时长为 5 分钟。
 > - 当您不需要对端主播同意时，您可以设置 `BattleConfig` 的 `needResponse` 字段为 `false`，当邀请发出后 PK 会立即开始。
 > - 当 `BattleConfig` 的 `needResponse` 字段为 `false` 时，`requestBattle` 接口的 `timeout` 字段必须设置为 0。
@@ -368,7 +288,7 @@ let config = BattleConfig(
     duration: 30, // PK 持续 30 秒
     needResponse: true, // 需要对方响应
     extensionInfo: ""
-)
+)
 battleStore.requestBattle(config: config, userIDList: [targetUserID], timeout: 10) { [weak self] result in
     guard let self else { return }
     switch result {
@@ -409,9 +329,6 @@ battleStore.battleEventPublisher
 - 进入 PK 状态之后，参与 PK 的所有主播均会收到 `BattleEventPublisher ` 的 `onBattleStarted` 回调。
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100038646063/9bacf5a2cc3111f091ab5254007c27c5.png)
 #### 步骤 4. 结束 PK 状态
 有以下两种方式可以结束 PK 状态。
@@ -442,15 +359,14 @@ battleStore.exitBattle(battleID: battleID, completion: { [weak self] result in
 当 PK 结束之后 （也即 `BattleEventPublisher` 的 `onBattleEnded` 回调触发时），您可以通过该回调在 UI 上展示 PK 结束，并区分出胜负（详见区分胜负章节）
 > **说明：**
->
+>
 > - 在连线过程中发起的 PK，当 PK 结束后会自动恢复到跨房连线状态。
 > - 如果您想在 PK 结束之后同步结束跨房连线，可以调用 `CoHostStore` 的 `exitHostConnection` 结束连线。
 ### 场景二：主播发起带 PK 模式的连线
 AtomicXCore 支持您在房间内直播时，直接发起 PK （中间不经历连线的交互过程），当 PK 结束后自动恢复到房间内直播状态。如下图所示：
-1. 主播在个人直播过程中，点击 PK 按钮，打开 UI 面板展示当前正在开播的主播列表（详见[《主播发起一场连线》的步骤 1](https://write.woa.com/#1ce7ad55-e199-4098-a9bb-554c204fdd97)）。
+1. 主播在个人直播过程中，点击 PK 按钮，打开 UI 面板展示当前正在开播的主播列表（详见《主播发起一场连线》的步骤 1）。
 2. 主播选中其中一个主播，发起 PK 邀请。
@@ -460,17 +376,11 @@ AtomicXCore 支持您在房间内直播时，直接发起 PK （中间不经历
 5. 当 PK 结束之后，根据 PK 过程中的积分来区分胜负。
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100038646063/9a888cebcc3111f0afdc52540044a08e.png)
-   ![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100038646063/9bfbf06fcc3111f093295254001c06ec.png)
    > **说明：**
-   >
+   >
    > 该功能需要同时使用 CoHostStore 和 BattleStore，并且借助 BattleConfig 的 needResponse 为 false 完成。
-   >
+   >
 #### 步骤 1. 主播发起连线请求
@@ -483,14 +393,14 @@ AtomicXCore 支持您在房间内直播时，直接发起 PK （中间不经历
    ``` swift
    import AtomicXCore
    // 从 LiveListStore 中获取的目标房间 ID
    let targetHostLiveID = "target_host_room_id"
    // 使用 6v6 语聊房静态布局为例
    let layoutTemplate = .hostStaticVoice6v6
    let timeout: TimeInterval = 10 // 邀请超时时间（秒）
    let extraInfo: String = "" // 额外的业务信息，用于“直连 PK”时携带标识
    coHostStore.requestHostConnection(
      targetHost: targetHostLiveID,
      layoutTemplate: layoutTemplate,
@@ -499,7 +409,7 @@ AtomicXCore 支持您在房间内直播时，直接发起 PK （中间不经历
      completion: { [weak self] result in
        guard let self = self else { return }
        switch result {
-           case .success():
+           case .success():
               print("邀请发送成功")
               break
            case .failure(let error):
@@ -604,7 +514,7 @@ coHostStore.coHostEventPublisher
 #### 步骤 4. 自动进入 PK 状态
-此步骤与 [主播在连线后再发起 PK - 步骤 3](https://write.woa.com/#b775b648-c9e2-480c-8678-f7e419e32bfa) 相同，此处不再赘述。
+此步骤与 主播在连线后再发起 PK - 步骤 3 相同，此处不再赘述。
 ## PK 分数更新与胜负判断
@@ -613,125 +523,45 @@ coHostStore.coHostEventPublisher
 通常在**直播主播 PK 场景**下，会将主播收到的礼物价值与 PK 数值挂钩（例如：观众送 "火箭" 礼物，主播 PK 分数增加 500 分），您可以通过我们的 REST API，轻松实现直播 PK 场景下的分数实时更新。
 > **重要说明：**
->
+>
 > LiveKit 后台的 PK 分数系统采用纯数值计算和累加机制，所以您需要根据自身的运营策略和业务需求，调用更新接口前完成 PK 分数的计算，您可以参考以下的 PK 分数计算示例：
->
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >礼物类型</td>
-<td rowspan="1" colSpan="1" >分数计算规则</td>
-<td rowspan="1" colSpan="1" >示例</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >基础礼物</td>
-<td rowspan="1" colSpan="1" >礼物价值 × 5</td>
-<td rowspan="1" colSpan="1" >10元礼物 → 50分</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >中级礼物</td>
-<td rowspan="1" colSpan="1" >礼物价值 × 8</td>
-<td rowspan="1" colSpan="1" >50元礼物 → 400分</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >高级礼物</td>
-<td rowspan="1" colSpan="1" >礼物价值 × 12</td>
-<td rowspan="1" colSpan="1" >100元礼物 → 1200分</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >特效礼物</td>
-<td rowspan="1" colSpan="1" >固定高分数</td>
-<td rowspan="1" colSpan="1" >520元礼物 → 1314分<br></td>
-</tr>
-</table>
+>
+| 礼物类型 | 分数计算规则 | 示例 |
+| --- | --- | --- |
+| 基础礼物 | 礼物价值 × 5 | 10元礼物 → 50分 |
+| 中级礼物 | 礼物价值 × 8 | 50元礼物 → 400分 |
+| 高级礼物 | 礼物价值 × 12 | 100元礼物 → 1200分 |
+| 特效礼物 | 固定高分数 | 520元礼物 → 1314分 |
 #### REST API 调用流程
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100038646063/998bd59ecc3111f08658525400454e06.png)
 #### 关键流程说明
 1. **获取 PK 状态**：
-  - 回调配置：您可以通过配置 [PK 状态回调](https://write.woa.com/document/170122621675196416)，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
+  - 回调配置：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
-  - 主动查询：您的后台服务可主动调用 [PK 状态查询](https://write.woa.com/document/169572228815638528) 接口，随时查询当前 PK 状态。
+  - 主动查询：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
 2. **PK分数计算**：您的后台服务根据业务规则（如上述示例），计算 PK 分数增量。
-3. **PK分数更新**：您的后台服务调用 [修改 PK 分数](https://write.woa.com/document/169571965752266752) 接口，向 LiveKit 后台更新 PK 分数。
+3. **PK分数更新**：您的后台服务调用 修改 PK 分数 接口，向 LiveKit 后台更新 PK 分数。
 4. **LiveKit后台 同步客户端**：LiveKit 后台自动将更新后的 PK 分数同步到所有客户端。
 #### 涉及的 REST API 接口
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >接口</td>
-<td rowspan="1" colSpan="1" >功能描述</td>
-<td rowspan="1" colSpan="1" >请求示例</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >主动接口 - 查询 PK 状态</td>
-<td rowspan="1" colSpan="1" >可根据此接口查询当前房间是否在 PK</td>
-<td rowspan="1" colSpan="1" >[请求示例](https://write.woa.com/document/169572228815638528)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >主动接口 - 修改 PK 分数</td>
-<td rowspan="1" colSpan="1" >将计算后的 PK 数值通过此接口更新</td>
-<td rowspan="1" colSpan="1" >[请求示例](https://write.woa.com/document/169571965752266752)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >回调配置 - PK 开始时回调</td>
-<td rowspan="1" colSpan="1" >客户后台可以通过该回调及时知晓 PK 开启</td>
-<td rowspan="1" colSpan="1" >[回调示例](https://write.woa.com/document/170122621675196416)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >回调配置 - PK 结束时回调</td>
-<td rowspan="1" colSpan="1" >客户后台可以通过该回调及时知晓 PK 结束</td>
-<td rowspan="1" colSpan="1" >[回调示例](https://write.woa.com/document/170123212271988736)</td>
-</tr>
-</table>
+| 接口 | 功能描述 | 请求示例 |
+| --- | --- | --- |
+| 主动接口 - 查询 PK 状态 | 可根据此接口查询当前房间是否在 PK | 请求示例 |
+| 主动接口 - 修改 PK 分数 | 将计算后的 PK 数值通过此接口更新 | 请求示例 |
+| 回调配置 - PK 开始时回调 | 客户后台可以通过该回调及时知晓 PK 开启 | 回调示例 |
+| 回调配置 - PK 结束时回调 | 客户后台可以通过该回调及时知晓 PK 结束 | 回调示例 |
 ### 区分 PK 胜负
 通常在**主播 PK 场景**下，需将主播收到的礼物价值与 PK 分值挂钩（例如：观众送 “火箭” 礼物，主播 PK 分值增加 500 分），通过礼物互动提升 PK 竞技性与直播氛围。AtomicXCore 的 PK 模块提供了 PK 分值的更新与广播系统，您只需要将观众送礼与之相关联即可。
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100038646063/9a24172fcc3111f0afdc52540044a08e.png)
-如上图所示，当您的计费系统检测到有观众送礼并且计费成功后，您可以调用 [修改 PK 分数](https://write.woa.com/document/169571965752266752)  更新当前主播的 PK 分值。当主播的 PK 分值发生变化后，参与 PK 的直播间中的所有用户（包含主播和观众）的 `BattleState` 的 `battleScore` 均会发生改变。您可以在 `battleScore` 发生改变的时候，更新 PK 进度条中的分值。
+如上图所示，当您的计费系统检测到有观众送礼并且计费成功后，您可以调用 修改 PK 分数  更新当前主播的 PK 分值。当主播的 PK 分值发生变化后，参与 PK 的直播间中的所有用户（包含主播和观众）的 `BattleState` 的 `battleScore` 均会发生改变。您可以在 `battleScore` 发生改变的时候，更新 PK 进度条中的分值。
 ``` swift
 battleStore.state.subscribe(StatePublisherSelector(keyPath: \BattleState.battleScore))
     .receive(on: RunLoop.main)
@@ -745,48 +575,12 @@ battleStore.state.subscribe(StatePublisherSelector(keyPath: \BattleState.battleS
 ## API 文档
 关于 `CoHostStore`、`BattleStore`、`LiveListStore` 和 `LiveSeatStore` 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [**AtomicXCore**](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**Store/Component**</td>
-<td rowspan="1" colSpan="1" >**功能描述**</td>
-<td rowspan="1" colSpan="1" >**API 文档**</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**CoHostStore**</td>
-<td rowspan="1" colSpan="1" >主播连线生命周期管理： 负责管理和协调主播间连线的生命周期，包括发起连线邀请、处理接受/拒绝、连线状态切换、连线中的视频流管理以及断开连线等任务。</td>
-<td rowspan="1" colSpan="1" >[API 文档](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" >主播 PK 对战生命周期管理： 负责管理主播间的限时 PK 对战全生命周期，包括发起 PK 邀请、开始对战、实时更新 PK 分数、PK 结束结算胜负以及惩罚时间等流程。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore)</td>
-</tr>
-<tr>
-<td rowspan="1" colSpan="1" >**LiveListStore**</td>
-<td rowspan="1" colSpan="1" >直播间全生命周期管理：查询房间列表，修改直播信息等。</td>
-<td rowspan="1" colSpan="1" >[API 文档](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" >麦位状态管理： 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风、麦位状态等信息。</td>
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore)</td>
-</tr>
-</table>
+| **Store/Component** | **功能描述** | **API 文档** |
+| --- | --- | --- |
+| **CoHostStore** | 主播连线生命周期管理： 负责管理和协调主播间连线的生命周期，包括发起连线邀请、处理接受/拒绝、连线状态切换、连线中的视频流管理以及断开连线等任务。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore) |
+| **BattleStore** | 主播 PK 对战生命周期管理： 负责管理主播间的限时 PK 对战全生命周期，包括发起 PK 邀请、开始对战、实时更新 PK 分数、PK 结束结算胜负以及惩罚时间等流程。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/battlestore) |
+| **LiveListStore** | 直播间全生命周期管理：查询房间列表，修改直播信息等。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveliststore) |
+| **LiveSeatStore** | 麦位状态管理： 管理房间内所有麦位状态（包括连线状态下的跨房间麦位），用于监听用户上下麦、麦克风、麦位状态等信息。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveseatstore) |
 ## 常见问题
@@ -803,7 +597,6 @@ battleStore.state.subscribe(StatePublisherSelector(keyPath: \BattleState.battleS
 - 检查网络连接是否通畅，邀请信令有 30 秒默认超时时间。
 #### 连线或 PK 过程中，一方主播网络断开或App崩溃了怎么办？
 **CoHostStore** 和 **BattleStore** 内部都有心跳和超时检测机制。如果一方异常退出，另一方会通过 **onCoHostUserLeft** 或 **onUserExitBattle** 等事件收到通知，您可以根据这些事件来处理UI，例如提示"对方已掉线"并结束互动。
@@ -816,5 +609,3 @@ battleStore.state.subscribe(StatePublisherSelector(keyPath: \BattleState.battleS
 - **多端实时同步**：用标准化格式（例如 JSON）快速对接礼物、PK、展示系统，确保主播 / 观众 / 后台分数实时一致，无延迟。
 - **灵活适配规则**：后端改配置（例如调整礼物对应分数、加成分数）即可适配业务变化，无需改前端，降低迭代成本。