文档版本: stable (v0.6.2)
按键与工作模式¶
适用设备
本文档适用于 OpenZilo Q。
固件版本说明
本文说明 V2.001.0002.0000 与 V2.001.0002.0001 的设备操作。V2.001.0002.0001 取消录音／手势模式切换；相关变化在对应小节注明。
固件 V2.001.0002.0001 取消了录音／手势模式切换。下面先说明该版本的操作；V2.001.0002.0000 的差异列在表后。
| 操作 | V2.001.0002.0001 的行为 |
|---|---|
| 短按一次 | 上报单击事件，不切换模式。 |
| 按键双击 | 上报双击事件，不产生对应单击事件。 |
| 按住不放 | 约 0.3 秒后开始本地录音，松开结束。 |
| 敲击戒指两次 | 在应用已订阅 IMU、采集已开启时上报双敲事件。 |
V2.001.0002.0000 启动后处于录音模式，短按在录音／手势模式间切换；手势模式下不启动按键录音，本地 IMU 可用于敲击检测。该操作方式不用于 V2.001.0002.0001。
短按需短于约 0.2 秒，两次短按间隔约 0.5 秒内识别为双击，因此单击确认有短暂延迟。
录音¶
固件版本
此用法需要固件 V2.001.0002.0001 或更新版本。
实时音频、远程录音与录音设置从 V2.001.0002.0001 开始提供。可选择保存在设备、仅实时发送或同时保存。仅实时发送不会留下设备副本；需要断线后继续保存时，提前选择同时保存和继续保存策略。
V2.001.0002.0000 的按键录音保存为 Speex，保存完成后可自动传输；V2.001.0002.0001 保存为 Opus（OP2C），通过 0x050A 通知后再下载。SDK 的 receive_auto_audio_file() 兼容两种流程。
按住按键，看到绿灯后说话，松开结束。报告电量低于 20% 时拒绝开始录音。未连接蓝牙也可保存本地录音；存储满时先备份再清理。下载不会自动删除文件。
IMU 与敲击检测¶
固件版本
此用法需要固件 V2.001.0002.0001 或更新版本。
V2.001.0002.0001 不需要切换模式。应用调用 start_sensor_report() 启动 IMU，调用 stop_sensor_report() 或断线后停止。重连后需要重新订阅；敲击检测随采集开启和停止。
V2.001.0002.0000 需先进入手势模式；停止 BLE 上报后，本地敲击检测可继续。物理双敲 0x0701 与按键双击 0x0703 是不同事件。