文档版本: stable (v0.6.2)
功能与版本要求¶
适用设备
本文档适用于 OpenZilo Q。
先查看戒指的固件版本,再确认它支持你要使用的功能。SDK 版本、固件版本和通信协议版本分别编号,不能用其中一个代替另一个。
查看版本和可用功能¶
在仓库目录运行:
uv run openzilo --version
uv run openzilo device use
uv run openzilo info
uv run openzilo device capabilities
--version 显示 SDK 版本,info 显示设备型号和固件版本,device capabilities 列出设备支持的功能及录音参数范围。
在 Python 中,可以先检查功能再调用:
import asyncio
import openzilo as sdk
ADDRESS = "AA:BB:CC:DD:EE:FF" # 替换为扫描得到的设备地址
async def main():
ring = await sdk.connect_ring(address=ADDRESS)
try:
info = await sdk.get_system_info(ring)
print("固件版本:", info.firmware_version)
if ring.capabilities.supports("recording_control"):
config = await sdk.get_audio_recording_config(ring)
print("录音设置:", config)
else:
print("当前设备没有提供可用的远程录音接口")
finally:
await ring.disconnect()
asyncio.run(main())
supports() 检查设备与 SDK 是否支持同一版本的功能接口。详细说明见 SDK 与固件兼容。
各功能的使用要求¶
连接要求
电脑需要支持低功耗蓝牙(BLE)。SDK 使用 NUS 服务与戒指通信,支持协议 v4。
自 SDK v0.6.1 起提供
连接时查询设备支持的功能。使用 connect_ring() 会自动查询;使用 OpenZiloClient 时需调用 get_device_capabilities()。
固件版本
此用法需要固件 V2.001.0002.0001 或更新版本。V2.001.0002.0000 不提供远程开始、停止、状态查询和录音设置接口。
固件版本
此用法需要固件 V2.001.0002.0001 或更新版本。V2.001.0002.0000 只在录音保存后传输文件,不提供实时音频。实时 PCM 还需安装 pcm 可选依赖。
固件版本
无需切换模式、直接用 start_sensor_report() 启动采集的用法,需要固件 V2.001.0002.0001 或更新版本。V2.001.0002.0000 需先用按键进入手势模式。
升级要求
使用官方发行说明指定的 OTA 升级包,并核对设备型号、硬件版本和当前固件版本。SDK 只升级应用固件,不升级引导程序(bootloader)。
固件版本说明
本文说明 V2.001.0002.0000 与 V2.001.0002.0001 的设备操作。V2.001.0002.0001 取消录音/手势模式切换;相关变化在对应小节注明。
版本说明怎么看¶
- 自固件 XXX 起支持:该功能从指定固件版本开始提供。
- 自 SDK XXX 起支持:调用该功能需要指定 SDK 版本或后续兼容版本。
- 本页适用于固件 XXX:页面描述的是该版本的操作方式,其他版本请结合发行说明使用。
远程录音、录音设置和实时音频从 V2.001.0002.0001 开始提供;具体用法前写明最低固件版本。V2.001.0002.0000 与 V2.001.0002.0001 的其余行为变化见版本升级说明。