声云录音卡 Recorder 是一套面向开发者和行业客户的智能录音硬件接入方案。 项目以录音卡片硬件为核心，开放 BLE 协议 SDK 及 Android、iOS、鸿蒙、Flutter 接入示例，同时提供 Windows/macOS 桌面端 Demo，支持设备连接、录音控制、实时音频、文件传输、OTA 升级和语音转写等能力，帮助开发者快速将录音硬件接入自己的 App、桌面软件或行业系统。 如需获取硬件规格、样机、完整协议、SDK 资料或定制服务，请联系安徽声云
# 声云录音卡 Recorder
一张录音卡片，一套完整的 BLE 接入方案。
声云录音卡 Recorder 是面向硬件厂商、软件开发者和行业集成商的开源示例项目。我们以 录音卡片硬件 为核心产品，同时开放录音卡 BLE 通讯协议 SDK、跨平台接入示例和桌面端 Demo，帮助团队从“连接设备”快速走到“录音、传输、转写和业务落地”。
## 项目定位
录音卡通过低功耗蓝牙与手机或电脑配合使用：设备负责采集和保存音频，应用负责连接控制、文件管理、音频处理以及业务集成。
本仓库提供三类资源：
| 资源 | 适用对象 | 内容 |
|---|---|---|
| 移动端 SDK | Android、iOS、鸿蒙及 Flutter 开发者 | 蓝牙搜索连接、录音控制、实时音频、文件传输、Wi-Fi、OTA、设备信息 |
| Windows/macOS Demo | PC 应用和工具开发者 | Python BLE 协议实现、命令行 REPL、Web 控制台、离线语音转文字 |
| 协议与测试资料 | 需要深度定制的团队 | BLE GATT、帧格式、CRC、文件下载、录音事件和兼容策略 |
## 能做什么
## 目录导航
recorder/ ├── pnote-android-sdk/ # Android AAR ├── pnote-ios-sdk/ # iOS 静态库与头文件 ├── pnote-harmony-sdk/ # 鸿蒙 HAR SDK ├── pnote-sdk-flutter-demo-main/ # Flutter 联调 Demo ├── pnote-web-win&Mac-demo/ # BLE 命令行与 Web Demo │ ├── recorder/ # 协议、BLE、设备会话、ASR、Web 后端 │ ├── web/ # 前端页面 │ ├── tests/ # 协议与设备模拟测试 │ └── docs/协议.md # CB08 通讯协议 V1.0 ├── 录音卡片.png # 产品图片 ├── 硬件参数.png # 硬件参数图 ├── demo.mp4 # 演示视频 └── LICENSE # MIT License
## 五分钟运行桌面 Demo
需要 Python 3.10 以上、可用 BLE 适配器，以及一台处于可连接状态的录音卡。
cd pnote-web-win&Mac-demo python -m venv .venv source .venv/bin/activate # Windows PowerShell: .venv\\Scripts\\Activate.ps1 pip install -r requirements.txt python main.py --web
浏览器打开 http://127.0.0.1:8000。命令行也可这样验证：
record> scan record> connect 0 record> smoke record> list record> download 0 record> transcribe 0
完整命令见 [桌面 Demo README](pnote-web-win%26Mac-demo/README.md)。离线转写和 Web 页面为可选能力：
pip install -r requirements-asr.txt pip install -r requirements-web.txt python -m unittest discover tests -v
首次转写会从 ModelScope 下载约 900 MB 模型，之后可离线运行。
## 移动端接入
### Flutter 联调工程
cd pnote-sdk-flutter-demo-main flutter pub get flutter run
请使用真机验证蓝牙、录音、Wi-Fi 和 OTA。核心入口是 lib/provider_record_pen.dart，详见 [Flutter Demo README](pnote-sdk-flutter-demo-main/README.md)。
### Android
将 [Android AAR](pnote-android-sdk/pnote_20260728171001.aar) 复制到应用的 app/libs（或 src/main/libs），添加 fileTree 依赖及 SDK 所需的 RxJava、Retrofit、EventBus 等依赖，然后调用：
PNote.init(context, deviceDataListener); PNote.startSearch(); PNote.connectDevice(name, address);
回调包括 JSON 设备事件、实时录音 OPUS 数据和文件 OPUS 数据。完整接口见 [Android SDK 开发文档](pnote-sdk-flutter-demo-main/android%20SDK开发文档(最新版本)-2026.04.23.md)。
### iOS
将 [libPNote.a](pnote-ios-sdk/libPNote.a) 与 [PNode.h](pnote-ios-sdk/PNode.h) 加入 Xcode，实现 WindBleDelegate，调用 startSearch、connectDeviceAndAddress 等接口。完整接口和 OTA 流程见 [iOS SDK 开发文档](pnote-sdk-flutter-demo-main/iOS%20SDK开发文档(最新版本)-2026.04.23.md)。
### 鸿蒙
鸿蒙 SDK 以 [har_recordersdk.har](pnote-harmony-sdk/har_recordersdk.har) 提供。将 HAR 引入工程后，按鸿蒙 SDK 文档完成蓝牙权限、扫描、连接和数据回调接入；如需配套示例或最新 API 说明，请联系声云获取资料包。
## 协议实现要点
0xAE20；写特征 AE21，数据通知 AE22，按键通知 AE23MAGIC(0x5A) + SEQ + CRC-16/XMODEM + LEN + TYPE/CMD/PARAMSCMD=18 才视为完整；旧固件按空闲超时兼容收尾CMD=2-2 整帧必须一次 GATT 写入协议字段、命令表、真实抓包帧和兼容策略见 [docs/协议.md](pnote-web-win%26Mac-demo/docs/%E5%8D%8F%E8%AE%AE.md)。
## 集成建议
## 适用场景
会议记录、采访采集、课堂培训、企业礼品、巡检取证、内容创作、智能硬件配套 App，以及需要快速验证录音硬件的软硬件联合项目。
## 硬件与商业合作
本项目的商业模式是“硬件销售 + 开放 SDK + 项目服务”：录音卡片硬件用于量产和行业应用，BLE 协议 SDK 与 Demo 用于降低研发接入成本；批量采购、外观/固件定制、行业功能、云端转写和交付支持可按项目评估。
如需获取硬件规格、样机、鸿蒙 SDK、协议完整版、企业微信二维码或技术支持资料，请联系 安徽声云（官网：[sinicloud.com](https://www.sinicloud.com/)）。咨询时请说明目标平台、预计数量和应用场景。
## 许可与使用边界
仓库示例代码以 [MIT License](LICENSE) 发布。AAR、静态库、HAR、固件和协议资料可能包含厂商专有内容，具体授权范围以随包说明和双方商务协议为准；请勿将设备私有协议用于未获授权的硬件或产品。
## 反馈与问题
提交问题时请附上操作系统与版本、目标平台、SDK/Demo 版本、设备固件版本、复现步骤，以及必要的日志或收发帧 hex。涉及真实设备数据时，请先脱敏序列号、地址、授权码和录音内容。