跳转至
文档版本: 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 的其余行为变化见版本升级说明。

下载固件

前往 官方固件发行页面,查看型号、适用硬件和允许升级的起始版本,再按 固件升级指南操作。