通过蓝牙向iOS设备发送媒体键：树莓派模拟苹果键盘音量键无响应

核心原因 #

1. HID报告描述符未声明消费者设备支持
   常规字母、数字按键属于HID规范的通用桌面键盘页面（Usage Page 0x07），而音量加减这类媒体控制按键属于独立的消费者设备页面（Usage Page 0x0C）。你当前树莓派模拟的HID设备只注册了标准键盘的能力，没有告知配对的iOS设备自身支持媒体控制功能，因此iOS会直接忽略不属于标准键盘页面的输入信号。
2. 键码体系不匹配
   你通过evtest采集到的114、115是Linux输入子系统的自定义键码，和HID传输协议的标准编码没有对应关系。HID消费者页面规范中，音量加的编码为0xE9，音量减的编码为0xEA，和你之前发送的数值完全不同。
3. 报告通道不兼容
   多数设备的媒体按键不能和常规键盘按键共用同一个HID报告包，需要单独定义对应的报告ID或报告位来传输媒体键的按下/抬起状态，混用报告包会导致接收端无法识别输入。

KeyCodes无输出的说明 #

macOS端的KeyCodes工具仅采集标准键盘页面的按键事件，媒体按键的事件走系统消费类设备的独立事件通道，不会被这类普通键码采集工具捕获，这和iOS无法识别按键没有关联。

解决步骤 #

• 修改树莓派蓝牙HID的报告描述符，添加消费者设备页面的声明段，可参考公开的苹果妙控键盘HID描述符结构，预留至少1字节的报告空间用于传输媒体按键状态。
• 替换发送的键码数值，音量加发送0xE9、音量减发送0xEA，不再使用Linux侧采集的114、115数值。
• 调整发送逻辑，媒体按键事件走单独的HID报告通道发送，不要和常规键盘的扫描码封装在同一个报告包内，按键抬起时同样要发送对应空报告重置状态。

内容的提问来源于stack exchange，提问作者Lawris