企业官网建设流程全解析

声云录音卡完整入门：一张BLE录音卡片如何打通Android、iOS、鸿蒙与桌面全平台

【免费下载链接】sonicloud_opensdk声云录音卡 Recorder 是一套面向开发者和行业客户的智能录音硬件接入方案。 项目以录音卡片硬件为核心，开放 BLE 协议 SDK 及 Android、iOS、鸿蒙、Flutter 接入示例，同时提供 Windows/macOS 桌面端 Demo，支持设备连接、录音控制、实时音频、文件传输、OTA 升级和语音转写等能力，帮助开发者快速将录音硬件接入自己的 App、桌面软件或行业系统。 如需获取硬件规格、样机、完整协议、SDK 资料或定制服务，请联系安徽声云项目地址: https://gitcode.com/gh_mirrors/recorder24/sonicloud_opensdk

声云录音卡 Recorder 是一套面向开发者和行业客户的智能录音硬件接入方案：它以录音卡片硬件为核心，开放BLE 协议 SDK和 Android、iOS、鸿蒙（HarmonyOS）、Flutter 接入示例，同时提供 Windows/macOS 桌面端 Demo。读完本篇指南，你将知道如何从“扫描连接”一路走到“录音、文件传输、语音转写”，最快 5 分钟跑通全平台链路。

认识声云录音卡：一张卡片能做什么？

声云录音卡是一张约银行卡大小的 BLE 录音卡片，负责采集并保存音频，App 端则通过 SDK 完成连接、控制与数据流管理：

• 🔗 蓝牙扫描、连接、设备状态巡检（电量、容量、固件版本、SN、录音状态）
• 🎙 实体按键或 App 远程发起开始、暂停、继续、停止录音
• 🎧 接收 16 kHz、单声道、Opus 裸字节实时音频，可交给自己的解码或 ASR 服务
• 📁 录音文件列表查询、分段下载、断点续传与删除
• 📶 通过 BLE 控制设备 Wi-Fi 热点，再以 Wi-Fi/TCP 传输文件或固件（OTA 不走纯 BLE）

硬件参数速览：A1~A4 四种型号怎么选

仓库中提供了 A1、A2、A3、A4 四种硬件型号的参数对比，主要差异在芯片方案（杰理 W20 / 蓝讯 AC7911B / 炬芯 AC7012 / BK7258）、是否支持 Wi-Fi、麦克风数量和电池容量：

选型小提示：A1 仅蓝牙、无 Wi-Fi；A2/A3/A4 均支持 Wi-Fi，可走 Wi-Fi 大文件传输与 OTA 升级流程。

项目资源清单：拿到什么、放在哪

本仓库提供四类开箱即用的资源，全部以相对路径组织，方便按需取用：

此外还有 SDK 集成引导.docx 梳理三端集成流程与验收要点，是动手前最值得通读的一份资料。

五分钟上手：桌面 Demo 最快体验路径

桌面 Demo 基于 Python + bleak 实现，是验证真机的最快配置方法：

1. 进入 pnote-web-win&Mac-demo/ 目录，创建虚拟环境并安装依赖：

cd pnote-web-win&Mac-demo python -m venv .venv pip install -r requirements.txt

2. 启动 Web 控制台（或命令行 REPL）：

python main.py --web # 浏览器打开 http://127.0.0.1:8000 python main.py # 命令行 REPL

3. 在页面或 REPL 中依次执行：scan扫描 →connect 0连接 →smoke只读巡检 →list文件列表 →download 0下载 →transcribe 0语音转文字。

声云录音卡BLE桌面控制台：设备信息、文件下载、实时转写与录音控制界面

桌面 Demo 的代码分层很清晰：协议层 recorder/protocol.py、BLE 传输层 recorder/ble.py、设备会话 recorder/device.py、离线转写 recorder/asr.py，可作为理解整套协议的“活教材”。可选能力通过额外依赖启用：pip install -r requirements-asr.txt（离线转写，首次会从 ModelScope 下载约 900MB 模型）和pip install -r requirements-web.txt（Web 界面）。

Android SDK 集成步骤：AAR 三步接入

Android 录音卡 SDK 集成只需三步：

1. 将 pnote_20260728171001.aar 复制到应用的app/libs目录，在build.gradle中通过fileTree引入；
2. 补齐 SDK 依赖的 RxJava、Retrofit、EventBus 等库，并按文档申请蓝牙、定位权限；
3. 初始化并注册设备事件、实时录音 OPUS、文件 OPUS 三类回调，然后开始扫描连接。

完整接口（搜索连接、录音、文件操作、Wi-Fi 管理、OTA）请查阅 Android SDK开发文档(最新版本)-2026.04.23.md。

iOS SDK 接入指南：静态库 + 委托回调

iOS 侧将 libPNote.a 与 PNode.h 加入 Xcode 工程，实现WindBleDelegate委托，再调用startSearch、connectDeviceAndAddress等接口即可。搜索连接、录音控制、文件下载、Wi-Fi 与 OTA 流程的完整说明见 iOS SDK开发文档(最新版本)-2026.04.23.md。

鸿蒙 SDK 与 Flutter 联调工程

• 鸿蒙：将 har_recordersdk.har 引入 HarmonyOS（API 12+）工程，申请蓝牙权限后，用扫描回调中的deviceId发起连接（该值可能是系统隐私随机标识，address仅用于展示）；所有业务结果都从DEVICE_DATA事件异步返回。
• Flutter：pnote-sdk-flutter-demo-main/ 是一个完整的跨平台联调 Demo，通过 MethodChannel/EventChannel 桥接 Android 与 iOS 原生 SDK，覆盖搜索连接、录音控制、文件传输、Wi-Fi 热点和 OTA 升级全链路。核心入口是 lib/provider_record_pen.dart，执行flutter pub get+flutter run即可在真机验证（蓝牙、录音、Wi-Fi 不建议用模拟器）。

BLE 协议核心机制：读懂这套通信设计

如果要做深度定制，建议通读 docs/协议.md（CB08 通讯协议 V1.0）。核心设计一句话概括：

• 分层架构：App 业务层 → SDK 核心状态机 → 标准 BLE 协议层 → VendorAdapter 厂商适配层 → 硬件固件。杰理、蓝讯、炬芯、BK 等芯片差异被收敛在适配层，应用面向统一接口开发；
• 通用帧格式：MAGIC(0x5A) + SEQ + CRC-16/XMODEM + LEN + TYPE/CMD/PARAMS，支持半帧、多帧、噪声的跨包重组与去重；
• GATT 服务：Service0xAE20，写特征AE21、数据通知AE22、按键通知AE23；
• OTA 策略：BLE 只负责进入升级模式与环境控制，固件经 Wi-Fi/TCP 传输，升级前检查电量（不低于 20%）与版本。

集成避坑清单：新手最容易踩的 6 个坑

1. 回调是异步的：方法调用只代表请求提交，业务完成一律以设备事件为准，别把回调直接当返回值用；
2. 音频是 Opus 裸字节：SDK 不负责解码和生成 WAV 头，需交给独立解码任务（参数：16 kHz、单声道、40 字节/帧、20 ms）；
3. 文件下载要记 offset：按finish=1收尾并记录偏移量，下载后校验文件大小与可解码性；
4. Wi-Fi socket 报错（如ENONET）：先确认已授权 Wi-Fi/定位权限、确实连上热点后再建 TCP；
5. OTA 不要无条件重发：BLE 或 Wi-Fi 任一链路断开都应标记失败并等待恢复；
6. 提交 Issue 要带上下文：系统版本、SDK/固件版本、复现步骤和脱敏后的收发帧 hex。

更多联调细节可参考 桌面 Demo README、Flutter Demo README 与 SDK 集成引导.docx。

适用场景与下一步

声云录音卡方案适用于会议记录、采访采集、课堂培训、内容创作、巡检记录，以及需要将多种芯片方案快速接入同一 App 的软硬件联合项目。建议路线：先用桌面 Demo 对真机完成一次完整验证，再按目标平台接入对应 SDK，最后用 tests/ 中的 40 项单元测试（无需真机与蓝牙）校验协议实现细节。

如需获取硬件规格、样机或定制服务，请按 README.md 末尾的方式联系安徽声云。

【免费下载链接】sonicloud_opensdk声云录音卡 Recorder 是一套面向开发者和行业客户的智能录音硬件接入方案。 项目以录音卡片硬件为核心，开放 BLE 协议 SDK 及 Android、iOS、鸿蒙、Flutter 接入示例，同时提供 Windows/macOS 桌面端 Demo，支持设备连接、录音控制、实时音频、文件传输、OTA 升级和语音转写等能力，帮助开发者快速将录音硬件接入自己的 App、桌面软件或行业系统。 如需获取硬件规格、样机、完整协议、SDK 资料或定制服务，请联系安徽声云项目地址: https://gitcode.com/gh_mirrors/recorder24/sonicloud_opensdk