尧图网页设计 
5分钟跑通声云录音卡Python蓝牙BLE桌面Demo快速开始指南【免费下载链接】sonicloud_opensdk声云录音卡 Recorder 是一套面向开发者和行业客户的智能录音硬件接入方案。 项目以录音卡片硬件为核心开放 BLE 协议 SDK 及 Android、iOS、鸿蒙、Flutter 接入示例同时提供 Windows/macOS 桌面端 Demo支持设备连接、录音控制、实时音频、文件传输、OTA 升级和语音转写等能力帮助开发者快速将录音硬件接入自己的 App、桌面软件或行业系统。 如需获取硬件规格、样机、完整协议、SDK 资料或定制服务请联系安徽声云项目地址: https://gitcode.com/gh_mirrors/recorder24/sonicloud_opensdk声云录音卡 Recorder 官方提供了Python 蓝牙 BLE的 Windows/macOS 桌面 Demo无需写协议、无需 App几分钟就能连接录音卡完成扫描、巡检、文件下载、录音控制和语音转文字验证。本文带你 5 分钟从零跑通整套流程并附上常见问题排查方法。一、先认识设备声云录音卡长什么样声云录音卡是一张支持蓝牙 USB 双传输的智能录音硬件开放完整 BLE 协议可灵活对接手机、平板、电脑等各类系统。它提供多型号选择A1~A4芯片方案覆盖杰理、联发科、博流等均支持 BLE 连接录音格式为 WAV/opus 如果你的设备型号或协议细节存疑可参考项目中的完整协议文档docs/协议.md二、准备工作环境要求与获取代码环境要求三选一即可项目要求操作系统Windows / macOS / LinuxPython3.10 及以上蓝牙适配器支持 BLE普通笔记本/台式机蓝牙即可设备一台处于可连接状态的声云录音卡获取代码git clone https://gitcode.com/gh_mirrors/recorder24/sonicloud_opensdk cd sonicloud_opensdk/pnote-web-win\Mac-demo桌面 Demo 位于 pnote-web-winMac-demo/ 目录核心文件说明程序入口main.py协议实现层recorder/protocol.pyBLE 传输封装recorder/ble.py核心依赖仅一个蓝牙库 bleakrequirements.txt三、一键安装3 条命令装好依赖# 1. 创建虚拟环境推荐 python -m venv .venv source .venv/bin/activate # Windows PowerShell 用: .venv\Scripts\Activate.ps1 # 2. 安装核心依赖连接/下载/录音控制 pip install -r requirements.txt # 3.可选按需安装 pip install -r requirements-web.txt # Web 控制台界面 pip install -r requirements-asr.txt # 离线语音转文字⚠️两个避坑提醒torchaudio 版本配对安装转写依赖后torchaudio 大版本必须与 torch 一致如 torch 2.9.x ↔ torchaudio 2.9.x否则导入时报 WinError 127。首次转写下载模型transcribe首次运行会从 ModelScope 自动下载约 900MB 的 SenseVoiceSmall 模型缓存在~/.cache/modelscope下载完成后即可完全离线使用。四、两种方式启动命令行 REPL 或 Web 控制台方式 A命令行 REPL适合终端党python main.py # 下载默认保存到 ./downloads python main.py -o out # 指定下载目录 python main.py -v # 输出调试日志含收发帧 hex方式 BWeb 控制台推荐新手图形化操作pip install -r requirements-web.txt python main.py --web # 默认 http://127.0.0.1:8000 python main.py --web --port 9000 # 指定端口浏览器打开http://127.0.0.1:8000就能看到功能完整的声云录音卡 BLE 控制台连接管理、设备信息、文件下载带进度条、实时转写、录音控制、raw 调试一应俱全声云录音卡BLE Web控制台界面扫描连接、文件下载与录音控制五、5分钟真机验证6 条命令完成全流程录音卡上电后确保没有被手机 App 占用蓝牙一次只能连一个主机然后在 REPL 中依次输入record scan # 扫描录音笔找不到时试 scan compat record connect 0 # 连接第一个扫描到的设备 record smoke # 只读巡检电量/容量/固件/授权码/录音状态 record list # 拉取设备上的文件列表 record download 0 # 下载第1个文件为 WAV自动校验 RIFF 长度 record transcribe 0 # 语音转文字结果存同名 .txt✅ 跑通后你会得到设备电量容量信息、一个可试听的 WAV 录音、一份.txt转写文本——扫描、连接、巡检、列表、下载、转写全链路验证完成。常用扩展命令速查rec start | save | pause | resume # 远程开始/保存/暂停/继续录音 gain [1|2|3] # 查询或设置增益1低 2中 3高 rt start | stop | pause | resume # 实时音频推流OPUS 码流落盘 raw type cmd [参数hex] # 按协议封包发送任意命令六、常见问题快速排查 现象原因与解决扫描不到设备① 确认录音卡未被手机 App 占用② 试scan compat列出全部有名设备手动选择③ 确认电脑蓝牙已开启且支持 BLEtranscribe报错未安装 funasr执行pip install -r requirements-asr.txttorchaudio 导入报 WinError 127torch 与 torchaudio 版本不配对安装同版本号的 torchaudio下载中断了怎么办支持断点续传download 序号 offset从偏移量继续想在无真机环境下开发跑单元测试python -m unittest discover tests -v40 项测试无需真机即可验证协议与设备层逻辑七、下一步从 Demo 走向产品集成 桌面 Demo 帮你验证完链路后如果要接入自己的 App项目还准备了完整的移动端 SDKAndroidpnote-android-sdk/ 提供 AAR 包调用PNote.init()→startSearch()→connectDevice()三步接入iOSpnote-ios-sdk/ 提供静态库与头文件鸿蒙pnote-harmony-sdk/ 提供 HAR 包Flutter 跨平台示例pnote-sdk-flutter-demo-main/真机可验证蓝牙、录音、Wi-Fi 和 OTA集成细节可阅读项目根目录的 SDK 集成引导.docx从权限申请到 OTA 验收一次讲清。总结声云录音卡的桌面 Demo 把BLE 协议对接这件复杂事压缩成了 3 条安装命令 6 条扫描命令。先用它打通真机链路再切换到 Android/iOS/鸿蒙 SDK 做业务集成——这就是从能连上到能落地的最短路径。【免费下载链接】sonicloud_opensdk声云录音卡 Recorder 是一套面向开发者和行业客户的智能录音硬件接入方案。 项目以录音卡片硬件为核心开放 BLE 协议 SDK 及 Android、iOS、鸿蒙、Flutter 接入示例同时提供 Windows/macOS 桌面端 Demo支持设备连接、录音控制、实时音频、文件传输、OTA 升级和语音转写等能力帮助开发者快速将录音硬件接入自己的 App、桌面软件或行业系统。 如需获取硬件规格、样机、完整协议、SDK 资料或定制服务请联系安徽声云项目地址: https://gitcode.com/gh_mirrors/recorder24/sonicloud_opensdk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 5分钟跑通声云录音卡：Python+蓝牙BLE桌面Demo快速开始指南
5分钟跑通声云录音卡Python蓝牙BLE桌面Demo快速开始指南【免费下载链接】sonicloud_opensdk声云录音卡 Recorder 是一套面向开发者和行业客户的智能录音硬件接入方案。 项目以录音卡片硬件为核心开放 BLE 协议 SDK 及 Android、iOS、鸿蒙、Flutter 接入示例同时提供 Windows/macOS 桌面端 Demo支持设备连接、录音控制、实时音频、文件传输、OTA 升级和语音转写等能力帮助开发者快速将录音硬件接入自己的 App、桌面软件或行业系统。 如需获取硬件规格、样机、完整协议、SDK 资料或定制服务请联系安徽声云项目地址: https://gitcode.com/gh_mirrors/recorder24/sonicloud_opensdk声云录音卡 Recorder 官方提供了Python 蓝牙 BLE的 Windows/macOS 桌面 Demo无需写协议、无需 App几分钟就能连接录音卡完成扫描、巡检、文件下载、录音控制和语音转文字验证。本文带你 5 分钟从零跑通整套流程并附上常见问题排查方法。一、先认识设备声云录音卡长什么样声云录音卡是一张支持蓝牙 USB 双传输的智能录音硬件开放完整 BLE 协议可灵活对接手机、平板、电脑等各类系统。它提供多型号选择A1~A4芯片方案覆盖杰理、联发科、博流等均支持 BLE 连接录音格式为 WAV/opus 如果你的设备型号或协议细节存疑可参考项目中的完整协议文档docs/协议.md二、准备工作环境要求与获取代码环境要求三选一即可项目要求操作系统Windows / macOS / LinuxPython3.10 及以上蓝牙适配器支持 BLE普通笔记本/台式机蓝牙即可设备一台处于可连接状态的声云录音卡获取代码git clone https://gitcode.com/gh_mirrors/recorder24/sonicloud_opensdk cd sonicloud_opensdk/pnote-web-win\Mac-demo桌面 Demo 位于 pnote-web-winMac-demo/ 目录核心文件说明程序入口main.py协议实现层recorder/protocol.pyBLE 传输封装recorder/ble.py核心依赖仅一个蓝牙库 bleakrequirements.txt三、一键安装3 条命令装好依赖# 1. 创建虚拟环境推荐 python -m venv .venv source .venv/bin/activate # Windows PowerShell 用: .venv\Scripts\Activate.ps1 # 2. 安装核心依赖连接/下载/录音控制 pip install -r requirements.txt # 3.可选按需安装 pip install -r requirements-web.txt # Web 控制台界面 pip install -r requirements-asr.txt # 离线语音转文字⚠️两个避坑提醒torchaudio 版本配对安装转写依赖后torchaudio 大版本必须与 torch 一致如 torch 2.9.x ↔ torchaudio 2.9.x否则导入时报 WinError 127。首次转写下载模型transcribe首次运行会从 ModelScope 自动下载约 900MB 的 SenseVoiceSmall 模型缓存在~/.cache/modelscope下载完成后即可完全离线使用。四、两种方式启动命令行 REPL 或 Web 控制台方式 A命令行 REPL适合终端党python main.py # 下载默认保存到 ./downloads python main.py -o out # 指定下载目录 python main.py -v # 输出调试日志含收发帧 hex方式 BWeb 控制台推荐新手图形化操作pip install -r requirements-web.txt python main.py --web # 默认 http://127.0.0.1:8000 python main.py --web --port 9000 # 指定端口浏览器打开http://127.0.0.1:8000就能看到功能完整的声云录音卡 BLE 控制台连接管理、设备信息、文件下载带进度条、实时转写、录音控制、raw 调试一应俱全声云录音卡BLE Web控制台界面扫描连接、文件下载与录音控制五、5分钟真机验证6 条命令完成全流程录音卡上电后确保没有被手机 App 占用蓝牙一次只能连一个主机然后在 REPL 中依次输入record scan # 扫描录音笔找不到时试 scan compat record connect 0 # 连接第一个扫描到的设备 record smoke # 只读巡检电量/容量/固件/授权码/录音状态 record list # 拉取设备上的文件列表 record download 0 # 下载第1个文件为 WAV自动校验 RIFF 长度 record transcribe 0 # 语音转文字结果存同名 .txt✅ 跑通后你会得到设备电量容量信息、一个可试听的 WAV 录音、一份.txt转写文本——扫描、连接、巡检、列表、下载、转写全链路验证完成。常用扩展命令速查rec start | save | pause | resume # 远程开始/保存/暂停/继续录音 gain [1|2|3] # 查询或设置增益1低 2中 3高 rt start | stop | pause | resume # 实时音频推流OPUS 码流落盘 raw type cmd [参数hex] # 按协议封包发送任意命令六、常见问题快速排查 现象原因与解决扫描不到设备① 确认录音卡未被手机 App 占用② 试scan compat列出全部有名设备手动选择③ 确认电脑蓝牙已开启且支持 BLEtranscribe报错未安装 funasr执行pip install -r requirements-asr.txttorchaudio 导入报 WinError 127torch 与 torchaudio 版本不配对安装同版本号的 torchaudio下载中断了怎么办支持断点续传download 序号 offset从偏移量继续想在无真机环境下开发跑单元测试python -m unittest discover tests -v40 项测试无需真机即可验证协议与设备层逻辑七、下一步从 Demo 走向产品集成 桌面 Demo 帮你验证完链路后如果要接入自己的 App项目还准备了完整的移动端 SDKAndroidpnote-android-sdk/ 提供 AAR 包调用PNote.init()→startSearch()→connectDevice()三步接入iOSpnote-ios-sdk/ 提供静态库与头文件鸿蒙pnote-harmony-sdk/ 提供 HAR 包Flutter 跨平台示例pnote-sdk-flutter-demo-main/真机可验证蓝牙、录音、Wi-Fi 和 OTA集成细节可阅读项目根目录的 SDK 集成引导.docx从权限申请到 OTA 验收一次讲清。总结声云录音卡的桌面 Demo 把BLE 协议对接这件复杂事压缩成了 3 条安装命令 6 条扫描命令。先用它打通真机链路再切换到 Android/iOS/鸿蒙 SDK 做业务集成——这就是从能连上到能落地的最短路径。【免费下载链接】sonicloud_opensdk声云录音卡 Recorder 是一套面向开发者和行业客户的智能录音硬件接入方案。 项目以录音卡片硬件为核心开放 BLE 协议 SDK 及 Android、iOS、鸿蒙、Flutter 接入示例同时提供 Windows/macOS 桌面端 Demo支持设备连接、录音控制、实时音频、文件传输、OTA 升级和语音转写等能力帮助开发者快速将录音硬件接入自己的 App、桌面软件或行业系统。 如需获取硬件规格、样机、完整协议、SDK 资料或定制服务请联系安徽声云项目地址: https://gitcode.com/gh_mirrors/recorder24/sonicloud_opensdk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考