HuaweiPods 是一个面向小米 / Redmi HyperOS 设备的 Xposed 模块，将华为耳机接入系统蓝牙详情页、连接弹窗、超级岛与融合设备中心。
1.9.1 已集成下列 19 个型号（含 FreeClip 2 典藏版），所有型号使用同一个 APK。本版新增 FreeBuds 6、FreeClip 2 典藏版与 Android 14 / HyperOS 2 兼容，改进通知名称、电量岛常驻和低时延控制。
| 型号 | 当前能力 |
|---|---|
| HUAWEI FreeBuds 3 | 电量、降噪开关、9 档降噪空间方向、双击手势与系统界面集成 |
| HUAWEI FreeBuds 4E | 电量、降噪 / 关闭与轻度 / 均衡两档降噪、状态回读、左右耳双击与按住、佩戴检测、轻滑音量说明、3 种官方音效和官方配色图片 |
| HUAWEI FreeBuds 5 | 电量、降噪 / 关闭与状态回读、智慧动态 / 轻度 / 均衡三档降噪、佩戴检测、4 种官方音效、高清音质与低时延自动保持；手势设置待补充 |
| HUAWEI FreeBuds 5i | 电量、通透 / 降噪 / 关闭与状态回读、智慧动态 / 轻度 / 均衡 / 深度四档降噪、左右耳双击、佩戴检测、4 种官方音效、高清音质、低时延自动保持与官方配色图片；长按和滑动设置待补充 |
| HUAWEI FreeBuds SE 4 ANC | 电量、通透 / 降噪 / 关闭与状态回读、智慧动态 / 轻度 / 均衡 / 深度四档降噪（智慧动态待实机对照）、防风噪、4 种官方音效、10 段自定义均衡器、低时延自动保持与官方配色图片；手势设置待补充 |
| HUAWEI FreeBuds 6i | 电量、通透 / 降噪 / 关闭与状态回读、4 档降噪、通透人声模式、双击 / 三击手势、4 种官方音效、10 段自定义均衡器、低时延设置保存与重连自动应用、融合设备中心同步与专属图片 |
| HUAWEI FreeBuds 6 | 电量与官方配色图片、降噪 / 关闭及 3 档降噪回读、部分音效、自适应音量、佩戴检测、掉落提醒、盒提示音、低时延回读与重连自动应用；协议与测试范围 |
| HUAWEI FreeBuds Pro 3 | 电量、三态控制与状态回读、4 档降噪、通透人声模式、长按 / 捏合 / 滑动手势与低时延自动保持 |
| HUAWEI FreeBuds Pro 4 | 电量、降噪 / 关闭两态控制；暂不支持降噪状态回读与手势设置 |
| HUAWEI FreeBuds Pro 5 | 电量、三态回读、4 档降噪、通透 / 透传人声 / 智慧动态透传、三击 / 按捏 / 轻滑音量、佩戴检测、自适应音量、头动与语音控制、空间音频、9 种悦彰 / 场景 / AI 音效、10 段自定义均衡器、高清音质、低时延自动保持、双设备连接、开盒提示音与耳塞材质 |
| HUAWEI FreeBuds 7 | 电量与官方图片、三态回读与 3 档降噪、空间音频、双击/三击/捏合/滑动设置、佩戴检测、8 种音效与 10 段均衡器、高清音质、低时延及部分智慧设置、原生设置页与融合设备中心控制；实机验证范围 |
| HUAWEI FreeBuds 7i | 电量、通透 / 降噪 / 关闭与状态回读、4 档降噪、双击 / 三击 / 长按 / 滑动音量、佩戴检测、头动控制、空间音频、4 种官方音效、10 段自定义均衡器、高清音质、低时延自动保持、双设备列表管理与官方配色图片 |
| HUAWEI FreeClip | 左右耳与充电盒电量；不提供传统主动降噪 |
| HUAWEI FreeClip 2 | 电量、双击 / 三击 / 滑动手势、空间音频、4 种官方音效、已保存的自定义音效、点头 / 摇头来电动作设置、嘈杂环境大音量、低时延自动保持及部分佩戴和音频设置；不支持传统主动降噪 |
| HUAWEI FreeClip 2 典藏版 | 独立产品身份与官方配色图片，复用 FreeClip 2 电量、手势、空间音频、音效及已接入设置，新增头动动作与大音量状态回读；协议与测试范围 |
| HUAWEI FreeArc | 左右耳与充电盒电量、双击 / 三击 / 按住 / 滑动手势、5 种官方音效、10 段自定义均衡器与官方配色图片；不支持传统主动降噪 |
| 华为智能眼镜（第一代） | 左右镜腿电量与系统界面集成；不提供主动降噪 |
| HUAWEI Eyewear 2 | 左右镜腿电量、双击 / 滑动手势与低时延自动保持；不提供主动降噪 |
| HUAWEI Eyewear 3 | 协议型号识别、左右镜腿电量、系统眼镜分类与官方配色图片；不提供主动降噪 |
表格仅列出当前已接入的能力；未列出的官方功能不代表已经支持，具体表现还会受到耳机固件和 HyperOS 系统组件版本影响。
需要适配其他华为耳机，可加入 QQ 群 1022359908 参与测试与协议采集。
- 在系统蓝牙详情页显示电量及机型支持的控制项
- 接入 HyperOS 连接弹窗和超级岛
- 可分别控制锁屏耳机通知与超级岛通知
- 通知可打开模块弹窗、系统设置或华为智慧音频；模块弹窗可直接切换低时延
- 耳机通知与超级岛优先显示系统蓝牙设置中的设备名称，连接期间改名会同步更新；机型识别仍使用原始信息与地址绑定
- 设置可开启“电量超级岛常驻”，默认关闭；连接期间随电量更新，断开后清除。系统样式需同时开启耳机常驻通知，并由 ROM 支持超级岛
- 接入融合设备中心，并支持已配对设备间流转；已验证的旧版宿主可复用“查找耳机”卡片快速切换低时延
- 显示左右耳、充电盒或眼镜左右镜腿电量
- 按机型提供主动降噪、通透模式、降噪等级和手势设置
- 直接从蓝牙协议读取现代型号的精确资源身份，并从华为官方 CDN 校验、缓存对应机型与配色图片
- 耳机名称被修改或无法自动识别时，可按蓝牙地址手动选择型号
- 首次启动提供设置引导，并可在应用内检查 GitHub 更新
- 独立的关于页面集中展示版本、更新、反馈与社区入口，完整设置收进右上角入口
- 覆盖安装新版本后提示重启作用域，无需直接重启手机
- 小米或 Redmi 设备
- HyperOS，Android 14 及以上（Android 14 / HyperOS 2 兼容从 1.9.1 起提供）
- LSPosed API 102 及以上（协议采集 Debug 版使用 API 101）
- 表中任一已集成型号
-
从 GitHub Releases 下载并安装 APK；首次打开可按引导检查 LSPosed 与核心作用域。
-
在 LSPosed 中启用 HuaweiPods。
-
勾选以下作用域：
com.android.bluetoothcom.android.settingscom.milink.servicecom.xiaomi.bluetoothcom.huawei.smartaudio（已安装时，用于 FreeClip 2 空间音频与自定义音效同步）
-
在 HuaweiPods 内重启相关作用域，或重启手机。
-
连接设备后，即可在 HuaweiPods、蓝牙详情页、超级岛或融合设备中心查看已接入能力。现代型号会直接读取设备标识；改名设备或旧协议型号识别失败时，再在 HuaweiPods 中选择一次真实型号。
正式版不需要安装或运行华为智慧音频来获取图片：现代型号由蓝牙协议直接确认机型与配色，旧协议型号可在图片设置中检索华为官方配色并手动确认。下载失败时始终回退到已有缓存或内置图，不会猜测默认配色。
融合设备中心低时延卡片只在已验证的旧版宿主中启用，并可在 HuaweiPods 设置中关闭；HyperOS 4 请从模块弹窗或详情页操作。1.8.3 修复了 FreeBuds 6i 等机型在弹窗内写入成功后设置未保存、再次打开又显示关闭的问题。现有协议没有可靠的低时延状态回读，界面显示最近一次成功写入且会在重连时恢复的设置，不代表耳机主动上报的实时状态；耳机端效果仍需实机验证。
更完整的安装说明见 快速开始。
1.9.1 将模块低时延操作交给蓝牙进程统一处理，避免重复建立连接，并防止旧的自动开启覆盖手动关闭；同时过滤旧版融合中心退出详情时误发的关闭请求。此前自动保持被关闭的用户，请更新后手动开启一次低时延。典藏版连续重连修复仍待群友实机复测，不能把命令写出成功视为耳机状态确认。
未支持型号需要先采集华为智慧音频（com.huawei.smartaudio）与耳机之间的真实通信数据。通用协议采集版按设备、噪声与音量、手势、音质、连接和充电盒等类别引导单变量操作；只负责记录，不代表该型号已经适配。
请勿直接公开包含设备地址、账号或其他个人信息的原始采集文件。提交前请检查并脱敏，完整流程见 华为耳机协议采集指南。
建议优先加入 QQ 群 1022359908 参与对应型号测试交流；可复现问题也可提交至 GitHub Issues。
# 正式版（LSPosed API 102）
./gradlew :app:assembleRelease
# 协议采集与调试版（LSPosed API 101，包含采集界面）
./gradlew :app:assembleDebugrelease 的图片识别不依赖华为智慧音频；仅在智慧音频本来就在运行时，注入一个 FreeClip 2 空间音频同步桥，不会主动启动或保活它，并使用 LSPosed API 102（含自动热重载元数据）。debug 仍固定使用 API 101，另外包含面向适配工作的智慧音频协议采集功能。两者使用相同应用 ID，无法同时安装。
- OppoPods by 1812z（HuaweiPods 初始适配来源）
- OppoPods by Leaf-lsgtky（上游原始项目）
- HyperPods by Art_Chen（HyperOS 耳机接入参考）
- OpenFreebuds by melianmiko（华为耳机协议参考）
- HyperIsland by 1812z（关于页、更新与首次引导交互参考）
- HyperLight by KiminonawaResa（HyperOS 材质层次与动效参考）
- Miuix by YuKongA（HyperOS 风格 Compose 界面组件）
本项目基于 GPL-3.0 开源。