# HyperSound 接入文档

## 一、接入要求及流程
1. 耳机需支持芯片原厂APP：杰理使用**杰理之家**、蓝汛使用**AB_Mate_协议文档**；基础功能协议采用原厂公版协议，蓝汛协议以官方文档《ab_mate_协议文档.pdf》为准。
2. 需提供蓝牙名称授权白名单：
   - 对接工程师：九月
   - 联系电话：17620948075
   - 地址：深圳市宝安区新安街道前海卓越时代广场 A座1203
3. 设备协议及连接要求：
   - 无需修改广播协议（杰理默认：0x05D6）；
   - 经典蓝牙与BLE需使用同一设备地址；
   - 经典蓝牙断开后，固件需主动断开BLE连接；
   - 恢复出厂设置时MAC地址必须保持不变（否则影响AI功能授权）。
4. 素材提供要求：
   - 提供带透明通道的PNG图片（用于APP主页连接状态显示）；
   - 可提供产品LOGO替换，无LOGO则默认显示「HyperSound」。
5. 联调相关：
   - 对接APP「HyperSound」已上架应用商店/App Store，用户可直接搜索下载；
   - 建议寄送1–2台样品至上述地址，便于联调与问题定位。

---

## 二、功能协议相关（杰理）
### 1. 预设EQ
APP端预设EQ模式顺序及对应键值：
- 0x00 = 默认模式
- 0x01 = 摇滚模式
- 0x02 = 流行模式
- 0x03 = 经典模式
- 0x04 = 爵士模式
- 0x05 = 乡村模式
- 0x06 = 自定义模式

### 2. 自定义EQ
支持在线配置是否启用，默认支持。

### 3. 按键定义
杰理芯片按以下标准执行，蓝汛芯片按ab_mate协议执行：

| 通道 | 操作 | 键值 | 功能 | 功能键值 |
|------|------|------|------|----------|
| 左耳（L）0x01 | 单击 | 0x01 | 无作用 | 0x00 |
| 右耳（R）0x02 | 双击 | 0x02 | 上一曲 | 0x03 |
| - | 长按保持 | 0x03 | 下一曲 | 0x04 |
| - | 长按 | 0x05 | 播放/暂停 | 0x05 |
| - | 三击 | 0x06 | 接听电话 | 0x06 |
| - | 四击 | 0x07 | 挂断电话 | 0x07 |
| - | 五击 | 0x08 | 音量加 | 0x09 |
| - | 长按1S | 0x0B | 音量减 | 0x0A |
| - | 长按3S | 0x0C | 回拨电话 | 0x0C |
| - | 长按2S | 0x23 | 低延时模式 | 0x0D |
| - | 前滑 | 0x1A | ANC切换 | 0x0E |
| - | 后滑 | 0x1B | AI助手 | 0x48 |
| - | - | - | 听译 | 0x49 |
| - | - | - | 手机助手 | 0x4B |
| - | - | - | 面对面翻译 | 0x4A |

### 4. 游戏模式
切换游戏/音乐模式（杰理默认协议）：
- 0x01 = 正常模式
- 0x02 = 游戏模式

### 5. ANC降噪
切换降噪/通透模式（杰理默认协议）：
- 0x00 = 关闭
- 0x01 = 降噪
- 0x02 = 通透模式

### 6. 设备电量显示
涵盖充电仓、左耳机、右耳机三部分；头戴式/特殊形态耳机可协商隐藏对应区域。

---

## 三、APP功能（与设备无关,功能详细说明待完善）
1. AI翻译
2. AI总结
3. AI聊天
4. 查找设备

---

## 四、自定义协议
自定义协议使用原厂SDK自定义命令通道收发数据：**JL_OPCODE_CUSTOMER_USER**。

### 1. 语音唤醒
| 功能 | 指令方向 | 指令内容（JSON格式） | 设备回复 |
|------|----------|------------------|----------|
| 唤醒开关查询 | APP→设备 | {"cmd":"0x4C","state":""} | 开：{"cmd":"0x4C","value":"1"}<br>关：{"cmd":"0x4C","value":"0"} |
| 唤醒开关打开 | APP→设备 | {"cmd":"0x4C","value":"1"} | 无需回复 |
| 唤醒开关关闭 | APP→设备 | {"cmd":"0x4C","value":"0"} | 无需回复 |

### 2. 语音唤醒模式
| 功能 | 指令方向 | 指令内容（JSON格式） | 设备回复 |
|------|----------|------------------|----------|
| 唤醒模式查询 | APP→设备 | {"cmd":"0x4D","state":""} | APP内唤醒：{"cmd":"0x4D","value":"1"}<br>Siri模式：{"cmd":"0x4D","value":"0"} |
| 设置APP内唤醒 | APP→设备 | {"cmd":"0x4D","value":"1"} | 无需回复 |
| 设置Siri模式 | APP→设备 | {"cmd":"0x4D","value":"0"} | 无需回复 |

### 3. 入耳检测开关
| 功能 | 指令方向 | 指令内容（JSON格式） | 设备回复 |
|------|----------|------------------|----------|
| 入耳检测查询 | APP→设备 | {"cmd":"0x5C","state":""} | 开：{"cmd":"0x5C","value":"1"}<br>关：{"cmd":"0x5C","value":"0"} |
| 入耳检测打开 | APP→设备 | {"cmd":"0x5C","value":"1"} | 无需回复 |
| 入耳检测关闭 | APP→设备 | {"cmd":"0x5C","value":"0"} | 无需回复 |

### 4. 设备恢复出厂设置
| 功能 | 指令方向 | 指令内容（JSON格式） | 设备行为 |
|------|----------|------------------|----------|
| 恢复出厂设置 | APP→设备 | {"cmd":"0x5E","value":"1"} | 执行恢复出厂，无需回复 |

### 5. 小星畅聊
| 功能 | 指令方向 | 指令内容（JSON格式） | 设备行为 |
|------|----------|------------------|----------|
| 按键触发小星畅聊 | 设备→APP | {"cmd":"0x5D"} | 唤醒小星畅聊AI对话 |

### 6. 空间音效
| 功能 | 指令方向 | 指令内容（JSON格式） | 设备回复 |
|------|----------|------------------|----------|
| 空间音效开关查询 | APP→设备 | {"cmd":"0x7A","state":""} | 开：{"cmd":"0x7A","value":"1"}<br>关：{"cmd":"0x7A","value":"0"} |
| 空间音效打开 | APP→设备 | {"cmd":"0x7A","value":"1"} | 无需回复 |
| 空间音效关闭 | APP→设备 | {"cmd":"0x7A","value":"0"} | 无需回复 |