重庆互联网，19年企业互联网解决经验，专业网站开发、移动端开发、微信端开发、小程序开发！
作者：重庆互联网小徐 发布时间：2024-07-02 浏览：19963 赞（1950） 收藏 评论（0）
App及设备均可主动发送request指令。
App或设备收到request指令后，回复相应的response指令。
如超过0.5秒没有收到相应的response，耳机会重新发送command，最多重试2次
命令处理成功时，response指令的code为0，其他错误码参考Response Code。
数据序列化时采用小端字节序。
request：
| Offset | Length | Type | Description |
|---|---|---|---|
| 0 | 1 | uint8_t | command_id |
| 1 | 1 | uint8_t | command_type，1: request，2: response |
| 2 | 1 | uint8_t | sequence number, 0~255递增循环，response取request值 |
| 3 | 2 | uint16_t | payload长度，无数据时为0 |
| 5 | N | uint8_t[] | payload，指令相关数据, 无数据时为空 |
response：
| Offset | Length | Type | Description |
|---|---|---|---|
| 0 | 1 | uint8_t | command_id |
| 1 | 1 | uint8_t | command_type，1: request，2: response |
| 2 | 1 | uint8_t | sequence number, 0~255递增循环，response取request值 |
| 3 | 1 | uint8_t | command result, 0: success |
| 4 | 2 | uint16_t | payload长度，无数据时为0 |
| 6 | N | uint8_t[] | payload，指令相关数据, 无数据时为空 |
其中payload数据由各指令自己定义。
用户触发录音，发送该命令给App，并开始录音。
request payload: NULL
response payload: NULL
App检测到静音时，发送该命令给设备，设备结束录音。
或设备在录音时多次没有收到App回复时，发送此命令结束录音。
request payload: NULL
respone payload: NULL
建立连接过程中，由App发送给设备，设备返回product_id以及MAC地址。
request payload：NULL
response payload：
| Offset | Length | Type | Description |
|---|---|---|---|
| 0 | 4 | uint32_t | product_id |
| 4 | 6 | uint8_t[] | Bluetooth mac address |
| 10 | 8 | uint8_t[] | 特征值，连接App过程中由App分配，没有时用0填充 |
| 18 | 1 | uint8_t[] | connect_state, 最近一次或当前连接的情况: 0 表示未连接其他App或者语音助手。 1 表示已连接QQ音乐App。 2 表示已连接小微App。 3 表示已连接其他语音助手（如有）。 |
建立连接过程中，由App发送给设备，设备返回参数配置信息。
request payload:
| Offset | Length | Type | Description |
|---|---|---|---|
| 0 | 1 | uint8_t | App期望码率，单位KBps，目前为32 |
| 1 | 1 | uint8_t | 手机操作系统. 1:iOS 2:Android |
| 2 | 8 | uint8_t[] | 特征值，8字节，其中包含了App的信息。 参考代码: xw_headphone_fvalue_get_host_app |
response payload:
| Offset | Length | Type | Description |
|---|---|---|---|
| 0 | 1 | uint8_t | 连接类型，1:BLE, 2:SPP, 3:IAP |
| 1 | 1 | uint8_t | 编码类型，1:Opus, 2: SBC, 3: mSBC |
| 2 | 1 | uint8_t | 压缩率，16， 8，编码类型为Opus时适用。 |
| 3 | 1 | uint8_t | 采样率，1:16000 |
| 4 | 1 | uint8_t | 录音声道，1:单声道 |
| 5 | 1 | uint8_t | 位深，1:16bit |
| 6 | 1 | uint8_t | 录音方式，1:长按，2:短按 |
| 7 | 4 | uint8_t[] | 固件版本号：1.2.3.4对应的数据应为0x01,0x02,0x03,0x04 |
| 11 | 1 | uint8_t | 设备型号名称长度 |
| 12 | N | uint8_t[] | 设备型号名称，UTF8编码 |
| 12+N | 1 | uint8_t | 设备支持的小微协议版本号，当前为2。 参见附录-App对小微协议版本支持情况。 |
| 13+N | M | uint8_t[] | extra config |
extra config中包含一到多个配置项。
功能键设备：默认（降噪）/小微助手
设备sku信息，用于与厂商在硬件管理平台配置的信息关联。
设备自定义名称
设备序列号
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案，专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发，帮助企业实现从传统行业到互联网的完美转型。截止目前，重庆互联网合作的企业遍布全国各地，20年的开发经验和完善的售后服务体系获得合作客户的高度认可！
关注重庆互联网官方公众号，即可获取粉丝专享福利！
欢迎广大用户为此页面进行评价，评价成功将获得积分奖励！
