@tencentcloud/sdk-mcp 1.7.7 → 1.7.9-beta.1

package/resource/knowledge/iot/voice-recorder/device-demo.md

@@ -0,0 +1,189 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: voice-recorder
+---
+
+本文将介绍如何将录音卡 SDK 集成到您的设备固件中，跑通**录音会话**功能。全文分为三个部分：
+- **SDK 下载**：了解支持平台与获取对应平台的 SDK 交付包。
+
+- **SDK 对接指引**：完成 SDK 集成与录音会话能力对接。
+
+- **跑通 Demo**：以 ESP32S3 为例，介绍如何编译烧录，完成设备与 App 联调。
+
+## SDK 下载
+
+|芯片原厂|芯片型号|SDK 下载地址|
+|---------|---------|---------|
+|乐鑫|ESP32S3|[下载](https://github.com/Tencent-RTC/IoT_VoiceRecordingCard/tree/main/devices/ESP32S3/components/tc_iot_sdk)|
+
+> **注意：**
+> 如果您的项目使用其它芯片，请填写 [芯片适配需求表](https://cloud.tencent.com/apply/p/jmg2ftgxsu)，我们将尽快适配。
+>
+> 芯片需要满足如下要求：
+>
+
+|前提项|要求|
+|---------|---------|
+|BLE|BLE4.2及以上。|
+|Flash/RAM|100KB 以上 Flash，50KB 以上 RAM（SDK 用，不含 BLE 协议栈）。|
+|存储介质|已挂载的文件系统（如 SD 卡 + FAT），提供录音文件落盘目录。|
+|音频能力|麦克风采集 + Opus 编码（16kHz / 单声道 / 60ms 帧）。|
+|操作系统|FreeRTOS 或其他 pthread 风格的 RTOS。|
+
+## SDK 对接指引
+
+这部分主要介绍录音卡 API 的对接，方便集成到自己项目中去。
+
+集成方需完成：**调用5个 API、实现3个回调、按固定格式送帧**。
+
+### 步骤1: 引入录音卡头文件
+``` c
+/* 只需要引入这一个头文件即可 */
+#include "tc_iot_audio_recorder.h"
+```
+
+### 步骤2: 初始化
+``` c
+/* 回调运行在 SDK 内部 message loop 线程：只做入队/置标志，勿阻塞、勿直连硬件 */
+
+static void on_rec_start(const char *params, void *user_data)
+{
+    /* App 下发开始（或本地 start 被接受）：打开麦克风采集 + Opus 编码器，
+     * 之后开始向 SDK 送帧 */
+}
+
+static void on_rec_stop(const char *params, void *user_data)
+{
+    /* App 下发停止（或本地 stop）：请求停止采集，停止送帧 */
+}
+
+static void on_rec_message(tc_iot_error_e error_code, const char *json_msg, void *user_data)
+{
+    /* 统一事件入口：解析 json_msg 驱动 UI/业务状态，如果没有UI则不需要关注error_code>0的json_msg */
+}
+
+static void on_log(tc_iot_log_level_e level, const char *log)
+{
+    /* SDK 日志：按需转发到客户日志系统,调试的时候使用，量产只打印Info级别日志即可 */
+}
+
+void recorder_init(void)
+{
+    tc_iot_audio_recorder_params_s params = {
+        .storage_path = "/sdcard/voice",          /* 录音文件落盘目录（SD 卡挂载点下） */
+        .log_level    = TC_IOT_LOG_LEVEL_INFO,    /* 调试阶段可以开Debug */
+        .on_log       = on_log,
+    };
+    tc_iot_audio_recorder_observer_s obs = {
+        .on_audio_recorder_start = on_rec_start, // 本地主动触发录音和APP发起录音都会走这个回调
+        .on_audio_recorder_stop  = on_rec_stop,  // 本地主动触发结束录音或APP结束录音都会走这个回调
+        .on_message              = on_rec_message, // 错误或者事件通知统一走这个回调
+    };
+    tc_iot_error_e err = tc_iot_audio_recorder_init(&params, &obs, NULL);
+    if (err != TC_IOT_ERR_SUCCESS) {
+        /* 初始化失败 */
+    }
+    /* init 成功后 SDK 自动开始 BLE 广播，等待 App 连接 */
+}
+```
+
+### 步骤3: 设备主动发起录音/结束录音
+``` c
+/* 设备本地主动发起录音，如按键开始录音，调用此函数，sdk内部准备好后会通过on_audio_recorder_start告知，然后才可以推音频流 */
+tc_iot_error_e tc_iot_audio_recorder_start(tc_iot_audio_recorder_operation_cb callback);
+/* 设备本地主动结束录音，如按键结束录音，调用此函数，sdk内部处理完成后会通过on_audio_recorder_stop告知，此时可以结束推音频流 */
+tc_iot_error_e tc_iot_audio_recorder_stop(void);
+```
+
+### 步骤4: 推音频流
+
+当收到 **on_audio_recorder_start** 的回调后，就可以推送音频。
+``` c
+/* 需要在收到on_audio_recorder_start的回调之后才可以推音频流，在这之前推的音频流都会返回错误，但不影响正常调用 */
+  const tc_iot_audio_frame frame = {
+    .codec = TC_IOT_AUDIO_CODEC_OPUS, // 当前只接收Opus音频
+    .sample_rate = TC_IOT_AUDIO_SAMPLE_RATE_16000,
+    .channels = TC_IOT_AUDIO_CHANNEL_MONO,
+    .frame_duration_ms = TC_IOT_AUDIO_FRAME_DURATION_MS, // 60ms
+    .data = (uint8_t *)opus,
+    .data_size = len,
+    };
+tc_iot_audio_recorder_send_audio(&frame);
+```
+
+### 步骤5: 退出，反初始化
+``` c
+/* 停止录音/设备休眠时调用，释放init时的资源，退出SDK */
+tc_iot_error_e tc_iot_audio_recorder_deinit(void);
+```
+
+## 跑通 Demo
+
+这节介绍如何跑通录音卡设备端 Demo，我们以 [立创实战派 ESP32S3开发版](https://wiki.lckfb.com/zh-hans/szpi-esp32s3/) 为例，来介绍录音卡设备端 SDK 的使用。跑通本 Demo 后，您可以验证 BLE 录音卡绑定、实时录音、离线文件同步，以及云端语音识别能力。
+
+### 前置条件
+
+您已经成功 跑通了应用端 APP，手机已经装好了 APP 并可以正常运行。
+
+### 下载 Demo
+``` xml
+git clone https://github.com/Tencent-RTC/IoT_VoiceRecordingCard.git
+```
+
+### 步骤1: 准备 ESP-IDF 编译构建环境
+
+本项目基于乐鑫官方 ESP-IDF 框架开发，版本要求 6.2（或者 master 分支）：
+1. 打开 [乐鑫官方入门教程](https://docs.espressif.com/projects/esp-idf/zh-cn/latest/get-started/index.html)。
+
+2. 按文档安装 ESP-IDF v6.2（master 也可以） 及工具链：
+
+   - Windows：下载「ESP-IDF 安装器」一路下一步，完成后桌面会出现 ESP-IDF 终端。
+
+   - macOS / Linux：按文档执行 `install.sh`，之后在终端执行 `. $HOME/esp/esp-idf/export.sh` 激活环境。
+
+3. 验证安装：在 ESP-IDF 终端中执行 `idf.py --version`，应输出 6.2。
+
+   > **说明：**
+   >
+   > 后续所有命令都在「ESP-IDF 终端」（或已执行 export.sh 的终端）中输入。
+   >
+
+### 步骤2: 编译&烧录
+
+在终端中进入本工程目录 **devices/ESP32S3**，依次执行：
+``` bash
+idf.py set-target esp32s3        # 第 1 步：指定芯片型号（仅需一次）
+idf.py build                     # 第 2 步：编译（首次会联网下载依赖，需几分钟）
+idf.py -p <串口> flash monitor   # 第 3 步：烧录并打开串口监视器
+```
+
+**<串口> 的查看方式**：
+
+|系统|串口|查看方法|
+|---------|---------|---------|
+|macOS|/dev/cu.usbmodem*|ls /dev/cu.usbmodem*|
+|Windows|COMx|设备管理器 → 端口(COM 和 LPT)。|
+|Linux|/dev/ttyACM0|ls /dev/ttyACM*；若无权限执行 sudo usermod -aG dialout $USER 后重新登录。|
+
+烧录完成后设备自动重启，串口监视器中可见启动日志（按 **Ctrl+]** 退出监视器）。
+
+### 步骤3: 上电使用
+
+#### 连接手机 App
+1. 用 USB 线给开发板上电，屏幕点亮并显示设备就绪表情。
+
+2. 打开手机 App，在设备列表中选择 **TXVR-XXXX**（XXXX 为屏幕/串口日志中 显示的设备 MAC 地址后两位）。
+
+3. 连接成功后，屏幕表情切换为“已就绪”，即可开始使用。
+
+#### 开始录音
+- 手机操作：在 App 中点击“开始录音”，对开发板上的麦克风说话；点击“停止”结束。
+
+- 按键操作：短按板上 BOOT 键 等效开始/停止录音。
+
+   录音过程中屏幕显示“聆听中”表情；停止后录音自动上传，文件同时保存在 SD 卡中，可在 App 内回放或下载。

package/resource/knowledge/iot/voice-recorder/overview.md

@@ -0,0 +1,64 @@
+---
+product: iot
+framework:
+  - '*'
+types:
+  - feature
+retrievable_scope: always
+feature_domain: voice-recorder
+---
+
+本方案是面向录音卡类硬件的**一站式端到端解决方案**：基于腾讯云蓝牙端到端传输 SDK 与 VoiceAI SDK，覆盖「录音设备采集 → 蓝牙链路传输 → App 端 AI 降噪与识别 → ASR 识别 → 结构化文本输出」完整链路。**已适配的芯片15分钟即可完成集成跑通**，输出带发言人和时间轴的结构化文本。
+
+## 方案优势速览
+- **十五分钟集成（已适配芯片）**：针对已完成适配的芯片平台，蓝牙端到端传输 SDK 与 VoiceAI SDK 均提供完整 Demo 与简洁接口，设备端接入蓝牙传输、App 端接入识别链路，15分钟即可完成端到端跑通验证。
+
+- **一整套端到端蓝牙传输方案**：覆盖「录音设备采集 → 蓝牙链路传输 → App 端识别输出」全链路，设备端与端侧 SDK 组合开箱即用，无需自行打通传输与识别两段链路。
+
+- **AI 降噪能力**：VoiceAI SDK 内置端侧 AI 降噪，在识别前抑制环境噪声，保障嘈杂场景下的转写质量。
+
+## 端到端蓝牙传输方案
+
+录音卡类产品的核心难点在于设备端音频如何稳定、低延迟地到达手机端识别引擎。本方案由腾讯云提供覆盖全链路的 SDK 组合，客户无需自行研发或拼接传输链路：
+- **设备端**：蓝牙端到端传输 SDK 在录音设备侧完成音频采集与传输，音频经蓝牙链路实时送达手机。
+
+- **手机端**：App 通过外部 PCM 喂入模式接收设备音频，直接送入 VoiceAI SDK 处理，不依赖手机麦克风采集。
+
+- **全链路对齐**：传输与识别接口已由两个 SDK 组合打通，客户按 Demo 对接即可，无需自行处理链路衔接。
+
+## AI 降噪能力
+
+项目集成的 `VoiceAI` SDK 包含客户端 AI 降噪处理能力。其目标不是生成更“悦耳”的声音，而是在音频送入识别引擎前抑制环境噪声、提高语音可懂度，从而减少噪声触发、漏识别和误识别。
+
+|能力维度|说明|
+|---------|---------|
+|端侧前处理|降噪位于音频输入与 ASR 之间，可在上云前改善信噪比，减少无效噪声对 VAD 和识别模型的干扰。|
+|AI 模型降噪|SDK 内置多条 AINS 处理路径，包含面向 ASR 和会议场景的处理策略，可按实际声学环境选择。|
+|复杂噪声适配|适用于空调、风扇、键盘、设备运行声等稳态或非稳态背景噪声；实际效果取决于拾音距离、信噪比和设备算力。|
+
+## 识别能力
+
+识别链路基于成熟的 ASR 与说话人分离能力，同时支持录音过程中的流式识别和录音完成后的全量识别：
+- **实时流式识别**：按语音片段返回可修订的中间结果和最终结果，支持语音活动检测（VAD），满足边录边看的低时延场景。
+
+- **录音文件识别**：生成高完整度转写结果，返回语句文本、起止毫秒时间和说话人编号，适合会后归档与检索。
+
+- **说话人分离**：实时与录音文件链路均开启，输出「谁在什么时候说了什么」的结构化语句分段。
+
+## 应用场景
+
+|应用场景|核心诉求|方案能力|
+|---------|---------|---------|
+|多人会议|边录边看转写，并在会后快速定位不同发言者的观点。|实时 ASR + 实时说话人分离 + 带时间轴的录音文件识别。|
+|采访与调研|完整保留长时间对话，减少人工听写和区分采访对象的成本。|长录音分片转写 + 语句级时间戳 + 说话人编号。|
+|嘈杂办公环境|降低空调、风扇、键盘等背景噪声对识别效果的影响。|端侧 AI 降噪 + VAD + ASR 友好型音频处理。|
+
+## 功能优势
+
+|优势|说明|
+|---------|---------|
+|十五分钟集成|针对已适配芯片，设备端蓝牙传输 SDK 与 App 端 VoiceAI SDK 均提供完整 Demo 与封装接口，15分钟即可完成端到端跑通。|
+|端到端蓝牙传输方案|覆盖设备采集、蓝牙传输、端侧识别输出的完整链路，设备端与端侧能力组合交付，开箱即用。|
+|实时与离线识别互补|实时 ASR 提供低时延反馈，录音文件识别提供完整文本和精确时间轴，分别服务录中和录后场景。|
+|文本与角色同时结构化|识别结果不仅包含文字，还包含发言人编号、片段状态和时间信息，便于直接进入纪要、检索和大模型分析链路。|
+|AI 降噪能力|VoiceAI SDK 内置 AI 降噪能力，可在识别前抑制环境噪声、改善音频质量，降低真实办公和移动环境中的噪声干扰。|

package/resource/knowledge/livekit/core-sdk/features/android/base-beauty.md

@@ -22,8 +22,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：获取实例并监听状态
 
 获取 `BaseBeautyStore` 的全局单例，并设置订阅者以实时获取当前的美颜参数状态。

package/resource/knowledge/livekit/core-sdk/features/android/gift.md

@@ -209,8 +209,6 @@ class GiftManager(
 
 3. **UI 展示**：使用拉取到的 `List<GiftCategory>` 数据填充礼物面板。
 
-#### **配置时序图**
-
 #### **涉及 REST API 接口一览**
 | 接口分类 | 接口 | 请求示例 |
 | --- | --- | --- |
@@ -243,8 +241,6 @@ class GiftManager(
 
 4. **结果同步**：扣费成功，AtomicXCore 广播 `onReceiveGift` 事件；扣费失败，`sendGift` 的 `completion` 收到错误。
 
-#### 调用流程图
-
 #### 涉及 REST API 接口一览
 
 |接口|说明|请求示例|

package/resource/knowledge/livekit/core-sdk/features/android/live-list.md

@@ -256,8 +256,6 @@ class LiveListActivity : AppCompatActivity() {
 
 用户可以通过上下滑动来切换直播间，当一个新的直播间滑动到屏幕中央时，视频会自动开始播放预览；当它滑出屏幕时，视频则会自动停止，以节省带宽和设备性能。
 
-#### 交互流程图
-
 #### 实现方式
 
 `LiveCoreView` 支持多实例使用，我们为每一个 `RecyclerView.ViewHolder` 都创建一个独立的 `LiveCoreView` 实例。通过监听 `RecyclerView` 的滚动状态，我们可以精确地控制即将出现和已经离开屏幕的 ViewHolder 中的 `LiveCoreView` 何时开始和停止拉流，从而实现“即滑即播、即走即停”的效果。

package/resource/knowledge/livekit/core-sdk/features/flutter/audio-effect.md

@@ -22,8 +22,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：获取 Store 实例
 
 `AudioEffectStore` 和 `DeviceStore` 是单例对象，您可以直接通过 `shared` 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源 UI demo 项目中的 [audio_effect_panel_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/component/audio_effect/audio_effect_panel_widget.dart) 文件来了解完整的实现逻辑。

package/resource/knowledge/livekit/core-sdk/features/flutter/base-beauty.md

@@ -22,8 +22,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：获取实例并监听状态
 
 获取 `BaseBeautyStore` 的全局单例，并设置监听器以实时获取当前的美颜参数状态。

package/resource/knowledge/livekit/core-sdk/features/flutter/gift.md

@@ -192,8 +192,6 @@ extension GiftManagerSend on GiftManager {
 
 3. **UI 展示**：使用拉取到的 `List<GiftCategory>` 数据填充礼物面板。
 
-#### **配置时序图**
-
 #### **涉及 REST API 接口一览**
 
 |**接口分类**|**接口**|**请求示例**|
@@ -227,8 +225,6 @@ extension GiftManagerSend on GiftManager {
 
 4. **结果同步**：扣费成功，AtomicXCore 广播 `onReceiveGift` 事件。扣费失败，`sendGift` 返回错误。
 
-#### 调用流程图
-
 #### 涉及 REST API 接口一览
 
 |**接口**|**说明**|**请求示例**|

package/resource/knowledge/livekit/core-sdk/features/ios/base-beauty.md

@@ -22,8 +22,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：获取实例并监听状态
 
 获取 `BaseBeautyStore` 的全局单例，并设置订阅者以实时获取当前的美颜参数状态。

package/resource/knowledge/livekit/core-sdk/features/ios/gift.md

@@ -195,8 +195,6 @@ extension GiftManager {
 
 3. **UI 展示**：使用拉取到的 `[GiftCategory]` 数据填充礼物面板。
 
-#### **配置时序图**
-
 #### **涉及 REST API 接口一览**
 | 接口分类 | 接口 | 请求示例 |
 | --- | --- | --- |
@@ -229,8 +227,6 @@ extension GiftManager {
 
 4. **结果同步**：扣费成功，AtomicXCore 广播 `.onReceiveGift` 事件。扣费失败，`sendGift` 的 `completion` 收到错误。
 
-#### 调用流程图
-
 #### 涉及 REST API 接口一览
 
 |接口|说明|请求示例|

package/resource/knowledge/livekit/core-sdk/features/ios/live-list.md

@@ -223,8 +223,6 @@ class LiveListViewController: UIViewController, UICollectionViewDataSource, UICo
 
 用户可以通过上下滑动来切换直播间，当一个新的直播间滑动到屏幕中央时，视频会自动开始播放预览；当它滑出屏幕时，视频则会自动停止，以节省带宽和设备性能。
 
-#### 交互流程图
-
 #### 实现方式
 
 `LiveCoreView` 支持多实例使用，我们为每一个 `UICollectionViewCell` 都创建一个独立的 `LiveCoreView` 实例。通过监听 `UICollectionView` 的滚动代理方法，我们可以精确地控制即将出现和已经离开屏幕的 Cell 中的 `LiveCoreView` 何时开始和停止拉流，从而实现“即滑即播、即走即停”的效果。

package/resource/knowledge/livekit/core-sdk/features/uni-app/base-beauty.md

@@ -13,8 +13,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：获取实例并监听状态
 
 获取 `BaseBeautyState` 的全局单例，并监听对应数据来实时获取当前的美颜参数状态。

package/resource/knowledge/livekit/core-sdk/features/uni-app/gift.md

@@ -168,8 +168,6 @@ const handleSendGift = (giftID: string) => {
 
 3. **UI 展示**：使用拉取到的 `[GiftCategory]` 数据填充礼物面板。
 
-#### **配置时序图**
-
 #### **涉及 REST API 接口一览**
 | 接口分类 | 接口 | 请求示例 |
 | --- | --- | --- |
@@ -202,8 +200,6 @@ const handleSendGift = (giftID: string) => {
 
 4. **结果同步**：扣费成功，AtomicXCore 广播 `'onReceiveGift'` 事件。扣费失败，`sendGift` 的 `fail` 收到错误。
 
-#### 调用流程图
-
 #### 涉及 REST API 接口一览
 
 |接口|说明|请求示例|

package/resource/knowledge/livekit/core-sdk/live/android/co-guest-interaction.md

@@ -9,8 +9,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：实现观众申请上麦
 
 #### 观众端实现
@@ -323,8 +321,6 @@
 
 ### 实现视频流画面的昵称显示
 
-#### **实现效果**
-
 #### **实现方式**
 
 > **提示：**

package/resource/knowledge/livekit/core-sdk/live/android/host-interaction.md

@@ -6,8 +6,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：实现跨房连线
 
 此步骤的目标是让两个主播的画面出现在同一个视图中，我们将使用 [CoHostStore](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.live/-co-host-store/index.html) 来完成。
@@ -240,8 +238,6 @@
 
 ### 实现视频流画面的昵称显示
 
-#### 实现效果
-
 #### 实现方式
 - **步骤1**：创建前景视图 (**CustomSeatView**)，该视图用于在视频流上方显示用户信息。
 
@@ -365,8 +361,6 @@
 
 当主播开始 PK 后，可以在对方主播的视频画面上挂载自定义视图，通常用于展示该主播收到的礼物价值或其它 PK 相关信息。
 
-#### **实现效果**
-
 #### 实现方式
 - **步骤1**：创建自定义 PK 用户视图，您可以参考 TUILiveKit 开源项目中的 [BattleMemberInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/battle/widgets/BattleMemberInfoView.kt) 文件来了解完整的实现逻辑。
 
@@ -469,8 +463,6 @@
 
 ### 实现视频流画面上的 PK 状态显示
 
-#### **实现效果**
-
 #### **实现方式**
 - **步骤1：**创建自定义 PK 全局视图 **CustomBattleContainerView**，您可以参考 TUILiveKit 开源项目中的 [BattleInfoView.kt](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/live/tuilivekit/src/main/java/com/trtc/uikit/livekit/features/anchorview/view/battle/widgets/BattleInfoView.kt) 文件来实现，即可实现同样的效果。
 
@@ -503,8 +495,6 @@
 |​高级礼物​|礼物价值 × 12|100元礼物 → 1200分|
 |​特效礼物​|固定高分数|520元礼物 → 1314分|
 
-#### REST API 调用流程
-
 #### 关键流程说明
 1. ​**获取 PK 状态​**：
 

package/resource/knowledge/livekit/core-sdk/live/android/integration.md

@@ -6,8 +6,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：在当前项目中导入 AtomicXCore
 
 **安装组件**：请在您的 **build.gradle** 文件中添加 `implementation 'com.tencent.atomicx:atomicxcore:latest'` 依赖，然后执行 **Gradle Sync**。

package/resource/knowledge/livekit/core-sdk/live/flutter/co-guest-interaction.md

@@ -286,8 +286,6 @@
 
 ### 实现视频流画面的昵称显示
 
-#### **实现效果**
-
 #### **实现方式**
 - **步骤 1**：创建前景视图 (**CustomSeatForegroundView**)，该视图用于在视频流上方显示用户信息。
 

package/resource/knowledge/livekit/core-sdk/live/flutter/host-interaction.md

@@ -6,8 +6,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：实现跨房连线
 
 此步骤的目标是让两个主播的画面出现在同一个视图中，我们将使用 [CoHostStore](https://tencent-rtc.github.io/TUIKit_Flutter/api_live_co_host_store/api_live_co_host_store-library.html) 来完成。
@@ -297,8 +295,6 @@
 
 ### 实现视频流画面的昵称显示
 
-#### 实现效果
-
 #### 实现方式
 - **步骤1**：创建前景视图 (**CustomCoHostForegroundView**)，该视图用于在视频流上方显示用户信息。
 
@@ -487,8 +483,6 @@
 
 当主播开始 PK 后，可以在对方主播的视频画面上挂载自定义视图，通常用于展示该主播收到的礼物价值或其它 PK 相关信息。
 
-#### **实现效果**
-
 #### 实现方式
 - **步骤1**：创建自定义 PK 用户视图，您可以参考 TUILiveKit 开源项目中的 [battle_member_info_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/live_stream/features/decorations/battle/battle_member_info_widget.dart) 文件来了解完整的实现逻辑。
 
@@ -647,8 +641,6 @@
 
 ### 实现视频流画面上的 PK 状态显示
 
-#### **实现效果**
-
 #### **实现方式**
 - **步骤1：**创建自定义 PK 全局视图 **CustomBattleContainerView**，您可以参考 TUILiveKit 开源项目中的 [battle_info_widget.dart](https://github.com/Tencent-RTC/TUIKit_Flutter/blob/main/live/livekit/lib/live_stream/features/decorations/battle/battle_info_widget.dart) 文件来实现，即可实现同样的效果。
 
@@ -804,8 +796,6 @@ class _FullCustomLiveWidgetState extends State<FullCustomLiveWidget> {
 |​高级礼物​|礼物价值 × 12|100元礼物 → 1200分|
 |​特效礼物​|固定高分数|520元礼物 → 1314分|
 
-#### REST API 调用流程
-
 #### 关键流程说明
 1. ​**获取 PK 状态​**：
 

package/resource/knowledge/livekit/core-sdk/live/flutter/integration.md

@@ -6,8 +6,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：在当前项目中导入 AtomicXCore
 1. **安装组件**：请在您的 `pubspec.yaml` 文件中添加 `atomic_x_core` 依赖，然后执行 `flutter pub get`。
 

package/resource/knowledge/livekit/core-sdk/live/ios/co-guest-interaction.md

@@ -9,8 +9,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：实现观众申请上麦
 
 #### 观众端实现
@@ -244,8 +242,6 @@
 
 ### 实现视频流画面的昵称显示
 
-#### **实现效果**
-
 #### **实现方式**
 
 > **提示：**

package/resource/knowledge/livekit/core-sdk/live/ios/host-interaction.md

@@ -6,8 +6,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：实现跨房连线
 
 此步骤的目标是让两个主播的画面出现在同一个视图中，我们将使用 [CoHostStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/cohoststore) 来完成。
@@ -199,8 +197,6 @@
 
 ### 实现视频流画面的昵称显示
 
-#### 实现效果
-
 #### 实现方式
 - **步骤1**：创建前景视图 (**CustomSeatView**)，该视图用于在视频流上方显示用户信息。
 
@@ -303,8 +299,6 @@
 
 当主播开始 PK 后，可以在对方主播的视频画面上挂载自定义视图，通常用于展示该主播收到的礼物价值或其它 PK 相关信息。
 
-#### **实现效果**
-
 #### 实现方式
 - **步骤1**：创建自定义 PK 用户视图，您可以参考 TUILiveKit 开源项目中的 [AnchorBattleMemberInfoView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Features/AnchorView/View/HostBattle/AnchorBattleMemberInfoView.swift) 文件来了解完整的实现逻辑。
 
@@ -402,8 +396,6 @@
 
 ### 实现视频流画面上的 PK 状态显示
 
-#### **实现效果**
-
 #### **实现方式**
 - **步骤1：**创建自定义 PK 全局视图 **CustomBattleContainerView**，您可以参考 TUILiveKit 开源项目中的 [AnchorBattleInfoView.swift](https://github.com/Tencent-RTC/TUIKit_iOS/blob/main/live/Sources/Features/AnchorView/View/HostBattle/AnchorBattleInfoView.swift) 文件来实现，即可实现同样的效果。
 
@@ -436,8 +428,6 @@
 |​高级礼物​|礼物价值 × 12|100元礼物 → 1200分|
 |​特效礼物​|固定高分数|520元礼物 → 1314分|
 
-#### REST API 调用流程
-
 #### 关键流程说明
 1. ​**获取 PK 状态​**：
 

package/resource/knowledge/livekit/core-sdk/live/ios/integration.md

@@ -6,8 +6,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：在当前项目中导入 AtomicXCore
 1. **安装组件**：请在您的 **Podfile** 文件中添加 `pod 'AtomicXCore'` 依赖，然后执行 `pod install`。
 

package/resource/knowledge/livekit/core-sdk/live/uni-app/co-guest-interaction.md

@@ -9,8 +9,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：实现观众申请上麦
 
 #### 观众端实现
@@ -317,8 +315,6 @@
 
 ### 实现视频流画面的昵称显示
 
-#### **实现效果**
-
 #### **实现方式**
 - **步骤 1**：创建自定义 UI 覆盖层组件 (`ParticipantOverlay.vue`)
 

package/resource/knowledge/livekit/core-sdk/live/uni-app/host-interaction.md

@@ -6,8 +6,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：实现跨房连线
 
 此步骤的目标是让两个主播的画面出现在同一个视图中，我们将使用 [CoHostState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-CoHostState) 来完成。
@@ -126,8 +124,6 @@
 
 ### 实现视频流画面的昵称显示
 
-#### 实现效果
-
 #### 实现方式
 - 创建自定义 UI 覆盖层组件 (`ParticipantOverlay.vue`)
 

package/resource/knowledge/livekit/core-sdk/live/uni-app/integration.md

@@ -6,8 +6,6 @@
 
 ## 准备工作
 
-### 步骤1：开通服务
-
 ### 步骤2：在当前项目中导入 AtomicXCore
 1. **安装组件**：打开 [AtomicXCore SDK](https://ext.dcloud.net.cn/plugin) ，单击**下载插件并导入 HBuilderX**，选择需要集成的项目并单击**确定**。
 

package/resource/knowledge/livekit/core-sdk/voice/android/co-guest-interaction.md

@@ -11,8 +11,6 @@
 
 ## 实现步骤
 
-### 步骤1：组件集成
-
 ### 步骤2：实现观众申请上麦
 
 #### 观众端实现