文档版本: stable (v0.6.2)
OpenZilo Python SDK¶
适用设备
本文档适用于 OpenZilo Q。
使用 Python 连接 OpenZilo 戒指，读取设备信息、录音与动作数据，并接入你的应用。公开接口来自 openzilo 包，命令行工具与 Python SDK 一起安装。
从这里开始¶
想先从终端操作设备，可以直接使用命令行指南。
按功能使用¶
| 你要做什么 | 阅读 |
|---|---|
| 扫描设备，连接、断开或管理通知 | 扫描与连接 |
| 查询固件、型号、电量与存储 | 读取设备信息 |
| 回复设备的时间请求 | 设备校时 |
| 修改录音设置，远程开始或停止录音 | 远程录音与录音设置 |
| 下载已有录音，接收刚保存的录音 | 下载与接收已保存的录音 |
| 实时接收 Opus 或 PCM | 实时音频 |
| 保存原始文件，转换为 WAV | 音频解码与文件保存 |
| 采集加速度计、陀螺仪数据 | IMU 数据采集 |
| 等待按键或敲击事件 | 按键与敲击事件 |
| 分块读取设备日志 | 读取设备日志 |
| 在应用中升级固件 | 通过 SDK 升级固件 |
各功能页说明调用顺序、参数、返回结果和错误处理，并提供相应示例。
查询接口与排查问题¶
- API 索引：按功能查找公开函数及签名。
- 数据类型：连接信息、录音、音频与 IMU 的返回字段。
- 异常与问题排查：连接失败、超时、解码失败及设备忙碌。
- 功能与版本要求、版本升级与固件差异：功能条件与升级变化。