源码仓库 · English · 兼容性 · 安装指南 · 问题排查
HyperEars 是面向 Xiaomi HyperOS 的 LSPosed 模块。它为受支持的第三方蓝牙耳机补充 MiLink 融合设备中心所需的设备身份、能力和运行状态，使这些设备能够复用系统原生的 耳机卡片、设备流转和音量控制流程。
模块不替换 Android 的 A2DP/HFP 音频链路，不接管配对、通话或音频路由。私有控制通道 仅由确实需要协议遥测的设备会话建立。
- 将受支持的第三方耳机发布为 MiLink 耳机设备，复用系统设备流转和音量控制。
- 按实际适配能力提供整机、左右耳和充电盒电量；标准耳机回退到 Android 系统电量。
- 将已确认的厂商私有协议映射为系统卡片支持的降噪、关闭、通透和型号专属模式。
- 兼容旧版 HyperOS 与 HyperOS 4 的原生三态耳机卡片；抗风噪按型号使用降噪分支开关， 或复用该型号不适用的原生模式槽位。
- 耳机卡片的“更多设置”、电量通知和连接弹窗内容区共用打开目标：真实蓝牙设备详情、 对应厂商控制 App 或 HyperEars；目标不可用时回退到系统设备详情。
- 在应用内展示蓝牙会话、协议确认和 MiLink 发布生命周期，便于定位兼容问题；兼容性页面可按 品牌、型号、电量与噪声能力搜索。
- 在“设置 → 调试 → 强制适配器”中为指定设备选择协议探测入口，可按品牌和型号搜索。 选择后重新建立该设备的模块会话，切回自动识别即可恢复；控制能力仍须有效协议响应确认。
- 应用提供 Miuix 与 Material 3 两套可切换界面；没有已保存界面偏好时默认使用 Miuix。 Miuix 可配置明暗模式、界面缩放、菜单栏模糊和悬浮菜单栏，Material 3 保持系统动态配色 与标准底栏。
- FitClip Ultra 在协议确认后使用 MiLink 原生模式卡片提供“标准模式 / 游戏模式”， 不会因此声明耳机具有降噪能力。
- FitBuds Turbo 在协议确认后提供四态降噪与游戏模式，抗风噪和游戏开关分别按有效状态显示。
- 漫步者 TWS 耳电量零值显示为未知；双耳不可用时继续更新盒电量并清除旧耳电量。
从 3.0.0 起，可复用系统原生的耳机连接展示：
- “连接时显示”提供智能、仅弹窗、仅超级岛、关闭。默认智能，按系统判断在桌面／外屏桌面 显示电量弹窗，在应用内显示连接超级岛。
- 弹窗显示左右耳、充电盒或头戴式整机电量；已知盒电量无需充电即可显示，未知电量及时清除。 充电标志保持耳机实际回报，图片使用模块提供的通用资源。
- 超级岛显示已知的左右耳或整机电量，使用系统原生动画和显示时长；当前没有充电盒区域。 只有系统整机电量的 TWS 使用耳机图形与一个百分比。
- “耳机电量通知”独立控制，默认关闭；通知随状态更新，可按用户选择打开耳机设置或执行原生断开操作。 清理通知后，后续状态回报可以重新发布。
- 从 3.1.0 起，点击通知或弹窗的耳机／电量内容区，沿用“点击卡片‘更多设置’”选项； 成功打开目标后关闭对应弹窗，原生关闭和断开动作保持不变。
从 3.1.1 起，连接提示和电量通知由系统耳机进程直接检查原生登记，无需先启动 MiLink 或打开 控制中心。系统已登记的耳机保留官方展示，读取失败时保持保守回退。
3.2.0 修复弹窗启动期间电量回报丢失的问题，首次显示读取最新状态，后续回报继续更新窗口。 连接结束或系统接管后，旧弹窗请求失效。
3.2.1 补齐部分 HyperOS 3 宿主的原生展示兼容。整机电量补齐为左右耳、充电盒电量时， 更新已有弹窗和通知；修复重复弹窗、通知不更新及点击误入小米专用耳机详情页的问题。 调试预览可以再次显示已结束的提示，并反馈未就绪、系统占用或入口不可用等原因。
3.3.0 补充已核对的 Android 15 / OS3.0.5.0.VMNCNXM 蓝牙扩展 15/35 的旧原生展示路径， 修复该构建的登记检查不可用、连接提示与电量通知兼容问题。最终维护包已获实机反馈；其他构建 按入口检查结果启用，不能据此认定全部 Android 15 系统已验证。
这些功能需在 LSPosed 中勾选 com.xiaomi.bluetooth，升级或调整作用域后重启设备。
已有 HyperOS 4 的 Bose QuietComfort Headphones、vivo TWS Air3 Pro 对应展示实测，
以及 HyperOS 3 / vivo TWS 4 修复包的正常反馈；
其他系统版本按宿主入口兼容情况启用。首次配对和仅开盖发现继续由系统及设备原有支持决定。
| 品牌或范围 | 当前适配范围 |
|---|---|
| vivo / iQOO | TWS Air3 Pro 实机验证；TWS 3e 公开实现；其他已登记型号使用家族协议确认 |
| OPPO Enco | Air2 Pro、Free4、X3、Air5 参考协议；其他 Enco 型号使用家族协议确认 |
| OnePlus | Buds 4 自动识别、组件电量与三态；维护版已复核，其他已登记 Buds / Buds Pro 代际家族探测 |
| Dreame / TheAstro | OpenPro S2 电量、充电与四档音效已复核；Dreame Flo S2 家族外推 |
| SWARMOO / 贝壳王子 | MO3 PRO 双耳电量、盒电量及四态已复核；单耳控制继续跟踪 |
| Technics EAH-AZ | AZ80 实机验证：组件电量、三态控制；其他 EAH-AZ TWS 公开协议探测 |
| StarRing / 籁特易耳 | Ultra 实机验证；其他型号使用标准耳机回退 |
| Bose | QuietComfort Headphones 实机验证；已登记 BMAP 产品按产品身份和控制方言细化 |
| Edifier / 漫步者 | W860NB PRO、花再 Evo Pro、FitClip Ultra 实机验证；FitBuds Turbo 原版实测、维护布局待复核；其他已登记型号协议探测 |
| ROSESELSA / 弱水时砂 | 琉璃 X / Ultra、Furina 实机验证；琉璃 X 同地址控制端点维护版已复核；其他已登记产品公开实现或协议探测 |
| NiceHCK / YuanDao | OriG in 公开实现；其他型号使用标准耳机回退 |
| MOONDROP / 水月雨 | Robin 公开协议；Pudding 自适应降噪与抗风噪、MIRAGE 和 ZZZ-ANGELS-OWS 维护版已复核；PILL 左右耳电量实测；其他标准回退 |
| 荣耀 | X5s Pro 实机验证；协议确认后提供组件电量和降噪、关闭、通透 |
| 华为 | 5i、Pro 3、FreeClip 2 实机验证；FreeClip 2 仅组件电量；其他型号公开实现或家族探测 |
| QCY | Crossky C50S 公开协议；同协议家族进行协议确认，其他型号使用标准耳机回退 |
| Sony | WF-1000XM6、WH-1000XM4 实机验证；其他已登记型号公开实现或家族探测 |
| Samsung Galaxy Buds | Buds2 Pro 原版实测、维护版待复核；其他已登记型号参考实现或家族外推，按有效回报开放组件电量、噪声与触控设置 |
| 其他标准 A2DP/HFP 耳机 | 设备流转、系统音量和 Android 整机电量回退 |
“公开实现”“参考协议”和“家族确认”不等于 HyperEars 实机验证。家族适配器默认不 开放未经确认的私有写能力；只有收到合法协议响应后，才向 MiLink 发布对应电量或噪声 控制能力。具体型号、证据等级、判型条件和开放能力以 完整兼容性矩阵为准。
FitBuds Turbo 与 Buds2 Pro 的原版实测记录保留，维护版实机复核继续跟踪；MIRAGE 协议维护版已复核。 新版 Bose 卡片修复已通过布局与模式映射测试，实际显示和点击仍待设备复核。 Space Travel 2 Ultra 目前只补充家族名称识别，提供系统整机电量、音量和流转。
- Xiaomi HyperOS，Android 15 或更高版本；
- root 与可正常工作的 LSPosed，API 101 或更高版本；
- 目标耳机已通过系统蓝牙完成配对；
- 使用原生连接展示或电量通知时，勾选
com.xiaomi.bluetooth作用域； - LSPosed 必选作用域为
com.android.bluetooth和com.milink.service；如需厂商 App 运行时退避，再按控制 App 目录 勾选实际使用的厂商应用。
公开测试范围包含 HyperOS 4 的 MiLink 原生三态卡片。AOSP、MIUI、非小米 ROM 和 Android 15 以下系统不在当前公开测试范围内。
- 从本仓库的 Releases 下载 APK。
- 安装 APK，在 LSPosed 中启用 HyperEars。
- 确认核心作用域为
com.android.bluetooth和com.milink.service；使用原生连接展示或 电量通知时，另外勾选com.xiaomi.bluetooth。 - 重启设备，使各作用域加载新版模块；仅切换蓝牙开关不保证系统蓝牙扩展重新加载。
- 连接耳机后打开 HyperEars，检查会话中的 Adapter、传输、协议和 MiLink 状态。
从 3.0.1 起，HyperEars 的“重启蓝牙”会重新加载系统蓝牙与系统耳机服务，并验证旧宿主进程 已退出。“重启 MiLink”只负责 MiLink；普通蓝牙开关不保证展示宿主重新加载模块。 从旧版升级到 3.2.1 后，若仍有旧版电量通知，请先划掉，再重新连接耳机。
首次从早期开发测试包迁移时，如遇签名不一致，应先在 LSPosed 中禁用旧模块、重启、 卸载旧 APK，再安装正式版本并重新启用。完整步骤见 安装指南。
设备匹配按以下顺序回退：
具体型号 Adapter → 厂商品牌/协议家族 Adapter → Standard Bluetooth Adapter
每台已连接耳机拥有独立的有状态 Adapter 和 ProtocolSession。Adapter 负责设备身份、
能力、传输策略与运行状态；ProtocolSession 保存流式解码、握手、序列号和请求队列；
WireCodec 只负责厂商帧的字节编解码。UI 和 MiLink 桥只消费统一状态快照，不识别具体
品牌实现。
新增型号通常只需扩展具体型号 Adapter 或家族协议配置。需要协议确认的候选设备先执行 只读探测，确认成功后再更新能力或替换为更具体的 Adapter。完整设计见 系统模块架构。
本仓库由 Xposed Modules Repository 托管，用于 LSPosed 模块索引元数据和 APK Release。 HyperEars 的源码、开发历史、Issue、Pull Request、完整文档和原始 Release 均由 主仓库维护。
新增设备适配应提供可复现的协议证据，并通过主仓库提交 Pull Request。请勿在 Issue、 日志或抓包中公开完整设备地址、账号信息、密钥或其他个人数据。
HyperEars 以 GNU GPL-3.0-only 发布。本项目与 Xiaomi、vivo、iQOO、OPPO、Panasonic、Technics、Bose、Edifier、 ROSESELSA、NiceHCK、MOONDROP、荣耀、华为、QCY、Sony、Samsung 及相关品牌无关；商标和产品名称 仅用于兼容性描述。
协议研究所参考项目及其许可证见主仓库的 第三方声明。