Skip to content

Latest commit

 

History

History
362 lines (294 loc) · 33.6 KB

compatibility.md

File metadata and controls

362 lines (294 loc) · 33.6 KB

兼容性

1. 阅读说明

下表描述 HyperEars 当前代码实际开放的能力。所有条目均提供 MiLink 设备流转和系统音量; 表格只列额外的电量与噪声控制能力。音频、通话、配对和音量路由仍由 Android / HyperOS 负责。

1.1 适配层级

层级 含义
具体型号 具有独立型号配置;型号差异由对应 Adapter 定义
产品线 一组已知共享协议和设备形态的型号使用同一候选配置
品牌家族 先按品牌、服务或设备形态选择候选 Adapter,再由合法协议响应确认能力
标准回退 不建立厂商私有通道,只使用 Android 标准耳机能力

1.2 证据等级

等级 含义
实机验证 已在真实设备上验证识别、私有连接、状态读取、控制写入和卡片回读
公开实现 依据可检查的公开协议实现建立适配,尚未完成 HyperEars 本地实机验证
参考协议 依据同品牌或同协议家族资料建立适配,具体型号和固件仍需验证
家族外推 名称或服务只选择候选协议;私有能力必须由合法响应确认后开放
标准回退 只使用 Android 提供的标准能力

证据等级描述适配依据和验证范围,不评价设备质量。

1.3 电量与噪声能力

名称 含义
系统整机 Android 提供的单一电量;TWS 卡片左右耳显示同一数值,充电盒不显示
私有整机 厂商协议返回一个整机电量值
私有组件 厂商协议分别返回左耳、右耳和充电盒;只显示实际收到的组件
无 不开放对应能力

噪声模式只包含表中明确列出的“降噪、关闭、通透、抗风噪”。需要协议确认的条目在 确认成功前不开放私有电量或噪声控制;确认失败时继续保留流转、系统音量,以及表中 明确写出的系统整机电量。

1.4 厂商控制 App

厂商控制 App 与设备识别、协议兼容性是两个独立维度。控制 App 只用于用户选择的“更多设置”跳转和 可选的运行时控制权退避;安装、运行或勾选某个 App 不会把耳机判定为相应品牌,也不会开放 未经协议确认的能力。当前应用名称、包名、Adapter 声明顺序、LSPosed 条件和状态矩阵见 厂商控制 App 与 LSPosed 作用域。

2. 支持矩阵

2.1 vivo / iQOO

设备范围 层级 证据 识别与确认 电量 噪声模式
vivo TWS Air3 Pro 具体型号 实机验证 规范化名称精确匹配;合法 GAIA 电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透
vivo TWS 3e 具体型号 公开实现 规范化名称精确匹配;合法 GAIA 电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透
其他名称符合 vivo / iQOO TWS 规则的型号 品牌家族 家族外推 规范化家族名称选择候选;合法 GAIA 电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透

私有传输使用 GAIA RFCOMM UUID 0837;TWS 3e 另有 RFCOMM 通道 13 回退。已登记 目录包括 vivo TWS Air2 / Air200、5e、3 Pro、3、2e、2、1、A1 Pro、A1、Air Pro、 Air、Neo、X1,以及 iQOO TWS Air Pro、Air、1。

2.2 OPPO Enco

设备范围 层级 证据 识别与确认 电量 噪声模式
OPPO Enco Air2 Pro 具体型号 参考协议 型号名称选择 Air2 Pro 编码;合法电量与 ANC 状态响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透
OPPO Enco Free4 / X3 / Air5 具体型号 参考协议 型号名称选择候选配置;合法电量与 ANC 状态响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透
其他 OPPO / Enco 标准耳机 品牌家族 参考协议 品牌名称选择候选;合法电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透

私有传输使用 RFCOMM UUID 079a。

2.3 StarRing / 籁特易耳

设备范围 层级 证据 识别与确认 电量 噪声模式
StarRing Ultra 具体型号 实机验证 规范化名称精确匹配;合法电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
其他 StarRing / 籁特易耳耳机 标准回退 标准回退 品牌名称与 Android 标准耳机身份匹配 系统整机 无

StarRing Ultra 使用 GATT 7777/8888 特征,厂商 RFCOMM 为回退通道。

2.4 Bose

设备范围 层级 证据 识别与确认 电量 噪声模式
Bose QuietComfort Headphones 具体型号 实机验证 BMAP 产品身份 prince / 0x4075 匹配 私有整机 降噪、通透、抗风噪
Bose QuietComfort 35 / 35 II 具体型号 公开实现 BMAP 产品 ID 0x400C / 0x4020 匹配 私有整机 降噪、关闭、抗风噪
Bose Noise Cancelling Headphones 700 具体型号 公开实现 BMAP 产品身份 goodyear / 0x4024 匹配 私有整机 降噪、关闭、通透
Bose QuietComfort 45 具体型号 公开实现 BMAP 产品 ID 0x4039 匹配 私有整机 降噪、通透
Bose QuietComfort Earbuds 具体型号 公开实现 BMAP 产品 ID 0x402F 匹配 私有组件 降噪、通透
Bose QuietComfort Earbuds II 具体型号 参考协议 BMAP 产品 ID 0x4064 匹配 私有组件 降噪、通透
Bose QuietComfort Ultra Headphones 具体型号 参考协议 BMAP 产品 ID 0x4066 匹配 私有整机 降噪、通透
Bose QuietComfort Ultra Earbuds 具体型号 参考协议 BMAP 产品 ID 0x4072 匹配 私有组件 降噪、通透
Bose QuietComfort Ultra Headphones(第二代) 具体型号 参考协议 BMAP 产品身份 wolverine / 0x4082 匹配 私有整机 降噪、通透
Bose QuietComfort Ultra Earbuds(第二代) 具体型号 参考协议 BMAP 产品身份 edith / 0x4062 匹配 私有组件 降噪、通透
已登记的其他 Bose BMAP 型号 具体型号 家族外推 BMAP 产品 ID 匹配;只读状态响应确认控制方言 按 BMAP 响应 AudioModes:降噪、通透;ANR:降噪、关闭、抗风噪;CNC:降噪、关闭、通透
未登记的 Bose BMAP 耳机 品牌家族 家族外推 Bose 名称、OUI 或服务选择候选;产品身份和只读状态响应确认能力 按 BMAP 响应 AudioModes:降噪、通透;ANR:降噪、关闭、抗风噪;CNC:降噪、关闭、通透

私有传输使用逐项验证的 BMAP RFCOMM 候选。头戴设备显示私有整机电量;响应包含组件 字段时显示相应的左耳、右耳和充电盒电量。只支持 AudioModes 两态控制的型号保留系统 三项布局,其中不受协议支持的“关闭”项显示为禁用状态,不会发送控制命令。

2.5 Edifier / 漫步者

设备范围 层级 证据 识别与确认 电量 噪声模式
Edifier W860NB PRO 具体型号 实机验证 规范化名称和头戴形态选择候选;合法电量与模式响应分别确认对应能力 系统整机 → 私有整机 降噪、关闭、通透、抗风噪
Edifier 花再 Evo Pro 具体型号 实机验证 规范化名称选择候选;合法电量与模式响应分别确认对应能力 系统整机 → 私有左右耳(盒未知) 降噪、关闭、通透、抗风噪
Edifier FitClip Ultra 具体型号 实机验证 规范化名称精确匹配;合法 0xF2 电量及 0x08/0x09 游戏状态分别确认能力 系统整机 → 私有组件 无;另支持游戏模式
Edifier FitBuds Turbo 具体型号 贡献者实机验证 规范化名称精确匹配;明文 BES 电量、0x1B 模式及游戏状态分别确认能力 系统整机 → 私有左右耳;盒字段按有效回包提供 降噪、关闭、通透、抗风噪;另支持游戏模式
Edifier W820 / W830 / W860 系列头戴耳机 产品线 家族外推 系列名称与头戴形态选择候选;合法电量与模式响应分别确认能力 系统整机 → 私有整机 降噪、关闭、通透、抗风噪
其他可识别的 Edifier 耳机 品牌家族 家族外推 品牌名称或 BES 服务选择候选;合法电量与模式响应分别确认能力 系统整机 → 私有整机或 TWS 聚合 降噪、关闭、通透、抗风噪

私有传输使用 Edifier BES RFCOMM UUID,RFCOMM 通道 1 为回退。噪声能力仅在设备返回 合法模式响应后开放,写入使用设备实际报告的 0x10 或 0x1B ANC 方言。Evo Pro 的 0xF2 响应发布独立左右耳电量;未验证的充电盒及充电状态字段保持未知。其他 TWS 型号仅在 协议返回单一聚合值时镜像到左右耳,不把聚合值表述为独立组件遥测。

FitBuds Turbo 的明文 BES 负载与模式控制依据 PR #62 的帧样例及贡献者实机结果;盒电量尚未单独实测。FitClip Ultra 与 Turbo 共用类型化游戏状态及 重置逻辑。Turbo 的降噪与游戏能力独立确认:仅游戏已确认时使用原生双选项卡,降噪已确认时使用 原生三态卡并按已确认状态分别展示抗风噪、游戏开关。维护版共享布局的实机复核结果另行跟踪。

2.6 ROSESELSA / 弱水时砂

设备范围 层级 证据 识别与确认 电量 噪声模式
ROSESELSA EARFREE i5 具体型号 公开实现 规范化名称精确匹配;合法电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
ROSESELSA EARFREE / EARFEEL 产品线 产品线 家族外推 产品线名称或 GATT 服务选择候选;合法状态响应确认能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
Furina Endless Solo of Solitude 具体型号 实机验证 规范化名称选择候选;BudsFeel 合法电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
ROSE Ceramics X(琉璃 X) 具体型号 实机验证;端点维护版已复核 规范化名称精确匹配音频端点;有界扫描按精确伴生名称或合法 0x8418 载荷与音频地址后缀关联控制端点,允许同地址;合法 0x27/0x28 模式响应确认能力 系统整机 降噪、关闭、通透、抗风噪
ROSE Ceramics Ultra(琉璃 Ultra) 具体型号 实机验证 规范化名称选择候选;BudsFeel 扩展流中的合法电量与模式记录分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
ROSE BudsFeel MK2 具体型号 公开实现 规范化名称精确匹配;合法电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
ROSE BudsFeel 产品线 产品线 家族外推 产品线名称或 RFCOMM 服务选择候选;合法状态响应确认能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
其他 ROSESELSA / ROSE 耳机 标准回退 标准回退 品牌名称与 Android 标准耳机身份匹配 系统整机 无

EARFREE / EARFEEL 使用 GATT 服务 011bf5da、7777/8888 特征;BudsFeel 使用 RFCOMM UUID 0cf12d31-…。琉璃 X 使用独立 CERAMICS X BLE 或共享音频地址的控制端点; 实机 HCI Snoop 确认 ATT value handle 0x0015 以 Write Command 写入、0x0017 接收通知。 厂商 value 使用 0x27 查询、0x2C 设置和 0x28 状态回报,模式值分别为抗风噪 0x00、降噪 0x01、通透 0x02、关闭 0x03。初始仅保留系统整机电量;收到合法 00 27/28 02 00 03 0C 01 <mode> 报告后才开放四态控制;设置后同时接受 0x28 主动通知, 并执行一次 0x27 只读查询完成状态矫正。抓包尚未确认私有电量字段,因此不发布组件电量。 2026-10-28 的复现日志同样只有合法模式响应和未确认含义的 09 FF ... 报告;整机 100% 来自 Android,不能用它推定两耳或盒电量。具体证据与补测要求见 琉璃 X 协议说明。 无名广播中的 0x8418 不作为独立身份依据。部分零售批次不再广播独立的 CERAMICS X BLE, 而是把 0x8418 身份载荷挂在 Classic 音频端点的 LE 身份上,并在该地址承载同一 FDB3 服务;其长度字段为 0x12。此时适配器只在载荷解出的地址后缀与当前音频地址一致时,才把 音频端点地址选作控制候选,私有能力仍由合法 0x27/0x28 响应确认。 Furina Endless Solo of Solitude 复用 BudsFeel 帧格式,实机确认可独立上报左耳、右耳和充电盒电量。ROSE Ceramics Ultra(琉璃 Ultra)由 RoseLink 官方 App 经同一 0cf12d31 RFCOMM 通道控制,实机确认复用 BudsFeel 帧格式;其状态响应在首个 块之后追加无长度头的扩展 TLV 流(噪声 09、电量 0C 记录位于扩展流内), 解码器按扩展帧路径解析。该型号还会上报自适应降噪 0x05 与极致降噪 0x06,两者统一 投影为系统卡片的“降噪”状态;组件电量百分比位于低七位,尚未确认语义的高位不会被投影为 充电状态。 产品线名称与对应私有服务 UUID 是相互独立的候选条件;因此使用 联名名称但保留该私有服务的设备仍会进入家族只读试探。产品线候选在收到合法私有电量前保留 Android 系统整机电量;首次协议试探经过有界重试仍未确认时,自动降级为 ROSESELSA 标准 耳机能力,不保留私有控制项或休眠中的私有通道。

2.7 NiceHCK / YuanDao

设备范围 层级 证据 识别与确认 电量 噪声模式
NiceHCK YuanDao OriG in 具体型号 公开实现 规范化名称选择候选;合法电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
其他 NiceHCK / YuanDao 耳机 标准回退 标准回退 品牌名称与 Android 标准耳机身份匹配 系统整机 无

OriG in 使用 RFCOMM UUID a100。

2.8 MOONDROP / 水月雨

设备范围 层级 证据 识别与确认 电量 噪声模式
Robin / 知更鸟(蓝牙名称 Robin's Earphones) 具体型号 公开实现 已知完整名称或同时包含品牌与型号的名称规则选择候选;严格握手响应确认协议 私有左右耳 降噪、关闭、通透
Pudding(蓝牙名称 MOONDROP Pudding) 具体型号 维护版实机复核通过 名称规则选择候选;与 Robin 相同的严格握手响应确认协议 系统整机 → 私有左右耳与充电盒 降噪(自适应档 04)、关闭、通透、抗风噪
MIRAGE(蓝牙名称 MOONDROP MIRAGE) 具体型号 维护版实机复核通过 品牌与型号名称选择候选;共用 Pudding 的严格握手与逐项响应确认后开放 系统整机 → 私有左右耳与充电盒 基础降噪、关闭、通透
Space Travel 2 Ultra(蓝牙名称 Space Travel 2 Ultra) 标准回退 用户名称记录 精确名称选择水月雨家族;私有协议待确认 系统整机 无
ZZZ-ANGELS-OWS(水月雨 × 绝区零「妄想天使·闪亮登场」耳夹款) 具体型号 维护版实机复核通过 规范化完整名称匹配(排除 -LEA 身份);家族 API 握手与电量查询响应确认 系统整机 → 私有左右耳 无
其他名称包含 MOONDROP / 水月雨的耳机 标准回退 标准回退 品牌名称与 Android 标准耳机身份匹配 系统整机 无

Robin 和 Pudding 使用 Bluetooth SIG 标准 SPP UUID 建立 RFCOMM 通道。该 UUID 只用于选择 连接端点,不参与品牌或型号判定。ZZZ-ANGELS-OWS 同样使用标准 SPP(设备 SDP 与官方 App 实机抓包确认);该型号是无降噪的 OWS 耳夹耳机(官方 App 与抓包均无任何噪声命令),模块 不发送噪声命令、不开放噪声控制。其协议字节由官方 MOONDROP Link 应用实现与实机抓包 交叉验证:握手回答 00 04 03 01,电量响应为两对 01 <左> 02 <右>(设备实测不支持 充电盒组件),解析按对容错;判型排除其故意不可用的 -LEA LE Audio 身份。握手确认前 仅保留系统整机电量,不开放私有控制;确认后以合法电量和模式查询响应开放对应能力。 Robin、Pudding 模式写入后耳机不主动回报,模块会主动查询并以回读结果更新状态。精确 型号握手暂时失败时保留对应 Adapter,使用统一的有界退避与休眠唤醒路径,不会改判成 其他厂商。Pudding 的帧格式与模式命令与 Robin 同构(子命令 40/41、操作码 03/04),模式值经原版实机确认:00 关闭、01 基础降噪、 02 通透、03 抗风噪、04 自适应降噪。标准降噪写 04,基础档 01 仅识别回报, 抗风噪通过统一卡片开关开放;维护包 d88f5bae 已获作者实机确认,固件为 3.5.6。 电量帧 01 <左> 02 <右> 03 <盒> 中左右耳 00 与 FF 均表示未连接并显示未知,充电盒 FF 为不可读。捕获记录中帧载荷之后的尾字节 (如 40)不参与任何校验。详见 moondrop-pudding-protocol.md 与 moondrop-zzz-angels-protocol.md。MIRAGE 原 PR 已于 2026-09-21 实机确认握手、私有电量与基础三态读写。维护版于 2026-10-23 经维护者批准合入, 2026-10-30 获作者补充维护版连接、组件电量和模式回读复核;新档位的命令证据继续跟踪,见 moondrop-mirage-protocol.md。

2.9 荣耀

设备范围 层级 证据 识别与确认 电量 噪声模式
荣耀亲选耳机 X5s Pro(BTV-ME10) 具体型号 实机验证 规范化型号精确匹配;SPP 合法电量和状态帧分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透 + 四档深度(类型化扩展)
其他荣耀耳机 标准回退 标准回退 品牌名称与 Android 标准耳机身份匹配 系统整机 无

X5s Pro 使用 Bluetooth SIG 标准 SPP UUID 建立 RFCOMM 通道。该 UUID 只用于选择连接端点, 不参与品牌或型号判定。组件电量和三态模式分别在收到合法协议帧后开放;未获有效响应时保持 系统标准回退。降噪深度以 honor.x5spro 类型化状态与控制接入 v2.0.0 传输架构。详见 honor-x5s-protocol.md。

2.10 华为

设备范围 层级 证据 识别与确认 电量 噪声模式
HUAWEI FreeBuds 5i 具体型号 实机验证 规范化型号精确匹配;固定优先 RFCOMM Channel 16;合法电量和状态帧分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透
HUAWEI FreeBuds Pro 3(T0018 / T0018C) 具体型号 实机验证 规范化型号精确匹配;SPP 合法电量和状态帧分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透 + 降噪四档与透传两档(类型化扩展)
HUAWEI FreeBuds 4 具体型号 公开实现 规范化型号精确匹配;Channel 1 合法电量和状态帧分别确认对应能力 系统整机 → 私有组件或整机 降噪、关闭
HUAWEI FreeClip 2 具体型号 实机验证 规范化型号精确匹配;Channel 1 合法电量帧确认私有电量 系统整机 → 私有组件 无(开放式夹耳,不开放降噪)
其他名称符合 HUAWEI FreeBuds / FreeClip / FreeLace 规则的耳机 品牌家族 家族外推 产品线名称选择一个家族候选;按顺序试探 Channel 1、16;合法电量和状态帧分别确认对应能力 系统整机 → 私有组件或整机 协议确认后支持降噪、关闭、通透;不开放档位
其他华为耳机 标准回退 标准回退 Android 标准耳机身份匹配 系统整机 无

FreeBuds 5i 的型号识别和 Channel 16 先由一台真实设备的 HCI 捕获记录确认,随后在设备上完成 HyperEars 端到端实机验证(识别、私有连接、状态读取、控制写入与卡片回读)。FreeBuds 5i 使用 RFCOMM Channel 16;FreeBuds Pro 3、FreeBuds 4 与 FreeClip 2 使用 Channel 1; 家族候选在同一 Adapter 中依次尝试 Channel 1、16,前一端点协议确认失败后才进入下一端点。 通道号只用于传输, 不参与品牌或型号判定。组件电量和模式分别在收到 CRC 与字段均合法的协议帧后开放;未获有效 响应时保持系统标准回退。降噪档位(均衡/舒适/超强/动态)与透传档位(人声增强/均衡)以 huawei.freebuds_pro3 类型化状态与控制接入 v2.0.0 传输架构。三态模式切换与 降噪档位切换已在 FreeBuds Pro 3 实机验证通过;家族 Adapter 不开放档位。FreeClip 2 为开放式夹耳,无降噪与通透,不发送 2B 2A 状态查询,仅以合法电量帧确认其电量专用画像并 开放组件电量。原版 FreeClip 仍按家族候选处理,不静态继承 FreeClip 2 的精确型号画像。 FreeBuds 5i 型号专属档位测试失败,待完善。 智慧音频运行时,HyperEars 按 1.4 厂商控制 App的运行时控制权退避机制让出 私有控制,仅保留系统整机电量与音频流转。

已确认的多设备连接行为:FreeBuds Pro 3 可同时连接两台设备,状态为耳机侧全局共享—— 任一台已连接设备切换降噪模式或档位,耳机都会以 2B 03 通知所有连接端,各端随后重读 状态同步。RFCOMM SPP 为单客户端通道:当 OpenFreebuds 等第三方客户端占用 Channel 1 时,HyperEars 无法建立私有通道,保持标准回退,等待通道释放。详见 huawei-freebuds-protocol.md。

2.11 QCY

设备范围 层级 证据 识别与确认 电量 噪声模式
Crossky C50S(已报告名称 QYCC50S) 具体型号 公开实现 规范化名称精确匹配;当前音频设备或经厂商广播地址关联的伴生 BLE 端点提供 A001/1001/1002 服务;合法状态响应分别确认能力 系统整机 → 私有组件 降噪、关闭、通透
其他名称符合 QCY / Crossky 规则的耳机 品牌家族 家族外推 品牌名称只选择公开 GATT 协议候选;合法电量与模式响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透

QCY 候选先尝试当前 A2DP/HFP 设备上的 GATT 服务;若音频端点和控制端点分离,再按厂商 数据 0x521C 执行一次最长 8 秒的定向扫描,并使用广播中的关联地址或精确 -APP 名称绑定 当前会话。厂商数据本身不作为品牌或设备关联的充分条件。协议没有返回合法电量或模式状态 时,不开放相应私有能力;所有候选失败后直接使用标准耳机回退。实现依据公开协议,尚未完成 HyperEars 实机验证。协议边界见 QCY 标准 GATT 协议。


2.12 Sony

设备范围 层级 证据 识别与确认 电量 噪声模式
WH-1000XM2 / XM3 / XM4 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有整机 降噪、关闭、通透、抗风噪
WH-1000XM5 / XM6 / WH-CH720N 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有整机 降噪、关闭、通透
ULT WEAR(WH-ULT900N) 具体型号 公开实现 规范化型号或零售名称选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有整机 降噪、关闭、通透
WF-1000XM3 / XM4 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有组件 降噪、关闭、通透、抗风噪
WF-1000XM5 / WF-SP800N / LinkBuds S 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有组件 降噪、关闭、通透
WF-1000XM6 具体型号 实机验证 规范化型号选择候选,v2 服务优先;合法初始化确认协议,电量与 0x19 环境声通知分别确认能力 系统整机 → 私有组件 降噪、关闭、通透
WF-C700N / WF-C710N 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有组件 降噪、关闭、通透
WF-C510 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有组件 关闭、通透
WF-C500 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量状态确认私有电量 系统整机 → 私有组件 无
LinkBuds 具体型号 公开实现 规范化名称选择候选;合法初始化确认协议,电量状态确认私有电量 系统整机 → 私有组件 无
WI-SP600N 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有整机 降噪、关闭、通透、抗风噪
WI-C100 具体型号 公开实现 规范化型号选择候选;合法初始化确认协议,电量状态确认私有电量 系统整机 → 私有整机 无
其他 Sony WH / WI / MDR 降噪产品线 产品线 家族外推 产品线名称选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有整机 降噪、关闭、通透
其他 Sony WF / LinkBuds 降噪产品线 产品线 家族外推 产品线名称选择候选;合法初始化确认协议,电量与环境声状态分别确认能力 系统整机 → 私有组件 降噪、关闭、通透
其他具有 Sony 型号名称或私有服务的头戴耳机 品牌家族 家族外推 设备形态、名称或服务选择候选;合法初始化和电量状态分别确认协议与能力 系统整机 → 私有整机 无
其他具有 Sony 型号名称或私有服务的 TWS 耳机 品牌家族 家族外推 设备形态、名称或服务选择候选;合法初始化和电量状态分别确认协议与能力 系统整机 → 私有组件 无
其他 Sony 标准耳机 标准回退 标准回退 品牌名称与 Android 标准耳机身份匹配 系统整机 无

私有传输使用 Sony RFCOMM v1/v2;具体型号决定协议优先级、电量形态和 Ambient 方言。

2.13 Technics

设备范围 层级 证据 识别与确认 电量 噪声模式
EAH-AZ80 具体型号 实机验证 规范化型号选择候选;合法 RACE 组件电量和 0x000A 模式状态响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透(三态写入与设备回读已实测)
EAH-AZ60 / AZ60M2 / AZ70 / AZ100 等 EAH-AZ TWS 产品线 公开实现 产品线名称选择候选;合法 RACE 组件电量和 0x000A 模式状态响应分别确认对应能力 系统整机 → 私有组件 降噪、关闭、通透(AZ80 实测,其他型号沿用参考实现证据)

私有传输依次尝试 Technics / Airoha 厂商 RFCOMM UUID 00000000-0000-0000-0099-aabbccddeeff 与 Bluetooth SIG 标准 SPP UUID。UUID 只用于连接端点,不参与品牌判定;Android 通过 SDP 解析实际 channel,本次 AZ80 的 channel 21 只是单机观测,不固定 channel 15。

实现依据 TechincsPods 固定提交 a378106 的当前代码。贡献者已在 AZ100、AZ80、AZ60 等 型号上验证该参考实现可用;本分支由贡献者使用 AZ80 验证。AZ80 实测 0x000A Outside Control GET 两次均返回完整模式与等级,组件电量及关闭、降噪、通透三态写入和 设备回读均正常,因此该具体型号标为“实机验证”;其他型号仍为公开实现证据。运行时只使用 0x000A 回读。合法组件电量只开放 私有电量;合法 0x000A 响应才开放标准三态。自适应、等级调节和游戏模式均不提供。详见 technics-race-protocol.md。

2.14 Samsung Galaxy Buds

设备范围 层级 证据 识别与确认 电量 噪声模式
Galaxy Buds2 Pro(SM-R510) 具体型号 原版实机验证;维护版待复核 规范化型号名称选择候选;CRC 有效的状态帧确认能力 系统整机 → 私有组件 降噪、关闭、环境声
Galaxy Buds2(SM-R177) 具体型号 参考实现 规范化型号名称选择;合法扩展状态确认能力 系统整机 → 私有组件 降噪、关闭、环境声
Galaxy Buds FE(SM-R400) 具体型号 参考实现 规范化型号名称选择;合法扩展状态确认能力 系统整机 → 私有组件 降噪、关闭、环境声
Galaxy Buds Live(SM-R180) 具体型号 参考实现,待实测 名称选择传统 SPP;合法布尔噪声状态与触控字段分别确认 系统整机 → 私有组件 降噪、关闭
Galaxy Buds Pro(SM-R190) 具体型号 参考实现,待实测 名称选择传统 SPP;合法状态确认;传统触控锁 系统整机 → 私有组件 降噪、关闭、环境声
Galaxy Buds3 / Buds4(SM-R530 / R540) 具体型号 参考实现,待实测 名称选择新 SPP;合法共同字段确认基本控制 系统整机 → 私有组件 降噪、关闭
Galaxy Buds3 Pro / Buds4 Pro(SM-R630 / R640) 具体型号 参考实现,待实测 名称选择新 SPP;合法共同字段确认基本控制 系统整机 → 私有组件 降噪、关闭、环境声
Galaxy Buds Core / Buds3 FE(SM-R410 / R420) 具体型号 家族外推,实验性 参考客户端仍有布局 TODO;只开放合法共同字段证明的控制 系统整机 → 私有组件 降噪、关闭、环境声
Galaxy Buds 共享服务回退 家族回退 家族外推 共享 RFCOMM UUID 选择;仅解析各代稳定字段 系统整机 → 私有组件 降噪、关闭、环境声

Live / Pro 使用标准 SPP UUID 00001101-0000-1000-8000-00805f9b34fb; 其余已配置型号使用三星专属 RFCOMM UUID 2e73a4ad-332d-41fc-90e2-16bef06523f2。 标准 SPP 本身不用于识别三星。官方 Galaxy Buds 名称、Samsung Galaxy Buds 名称或 SM-R 编号选择具体型号;自定义名称的型号提示须同时具备专属 UUID。仅命中专属 UUID 的 未知型号使用家族候选,合法状态确认基础电量和噪声后才开放,不外推专属设置。

触控锁定、语音检测、环境声等级、均衡器、单耳降噪、无缝连接、耳缘双击、侧音和超高环境声 均要求型号配置及合法字段共同确认。长按菜单支持逐耳选择动作;只有 Buds2、Buds2 Pro、 Buds FE 的有效组合回报允许六字节 0x79 噪声组合写入。Live、Pro 和新款保持各自已知 格式;新款分项手势、耳缘音量及未核实设置保持关闭。新款只报告自适应值 3 时,不将其解释 为关闭或据此开放长按菜单。所有已配置型号的长按动作指令组间隔为零,其他控制保持默认节奏; 模块写入与设备实际生效分别记录。

协议参考 GalaxyBudsClient 的公开实现。贡献者在 2026-10-04 报告原版 Fix25 的 Buds2 Pro 实测通过;其他型号按表中证据等级记录。当前维护版收紧了型号身份条件,整理了卡片绑定、 逐耳请求与状态呈现;2026-10-23 经维护者批准按现有证据合入,最终维护版实机复核继续跟踪。详情见 samsung-buds2-pro-protocol.md。

2.15 通用蓝牙耳机

设备范围 层级 证据 识别与确认 电量 噪声模式
其他标准 A2DP / HFP 耳机 标准回退 标准回退 Android 标准耳机身份或保守名称匹配;排除 HyperOS 原生支持型号 系统整机 无

3. HyperOS 平台范围

当前目标平台为 Android 15+ 的 Xiaomi HyperOS 和 LSPosed API 101。MiLink、蓝牙服务和 原生卡片属于 ROM 内部实现,不承诺跨 HyperOS 大版本二进制稳定。已在 Xiaomi 14 Pro、 Xiaomi Pad 6S Pro 12.4 和 REDMI K Pad 上验证流转路径;HyperOS 4 的 MiLink 原生三态卡片 与抗风噪分支开关也已完成实机验证。实际兼容性仍取决于 ROM 构建。

MiLink 原始耳机准入结果具有最高优先级:只要当前 ROM 已原生接管该地址,HyperEars 就不 覆盖身份、能力或控制查询,并关闭同地址的模块会话。该仲裁不依赖品牌名称,因此同样适用 于系统原生支持的 Apple 或其他品牌设备。音箱、车机和无法保守判定为耳机的设备也不会进入 标准耳机回退。

4. 提交新设备证据

请按 CONTRIBUTING.md 提交设备名称、设备形态、服务 UUID、脱敏后的 只读响应和控制回读。完整个人 MAC 地址不属于协议证据,不应公开。