HuaweiPods ColorOS 是一个使用独立应用 ID io.github.artifical0.huaweipods.coloros 的 Android 15+ Xposed 模块，不会被原版 HuaweiPods 的 LSPosed 商店条目覆盖更新。HyperOS 已接入系统蓝牙详情页、连接弹窗、超级岛与融合设备中心；ColorOS 已接入官方“快速设备连接”弹窗、“我的设备”耳机详情入口及 Android 16 流体云电量卡片。
ColorOS 说明：已针对 OnePlus PLK110（ColorOS 16.1、
com.heytap.mydevices17.4.15）接入“我的设备”详情入口，目前仍不是完整的 ColorOS 系统面板。私有宿主会随系统更新变化，其他版本可能仅保留模块内电量和通用蓝牙详情页。
连接手机并启用 USB 调试后，可在 Windows PowerShell 运行 ./tools/capture-coloros-environment.ps1，生成不含日志、账号和蓝牙地址的宿主环境包，供下一阶段适配使用。
当前统一版已集成下列 14 个型号，所有型号使用同一个 APK，不再按型号单独分发测试包。
| 型号 | 状态 | 当前能力 |
|---|---|---|
| HUAWEI FreeBuds 3 | 稳定 | 电量、降噪开关、9 档降噪空间方向、双击手势与系统界面集成 |
| HUAWEI FreeBuds 4E | 扩展支持 | 电量、降噪 / 关闭与轻度 / 均衡两档降噪、状态回读、左右耳双击与按住、佩戴检测、轻滑音量说明、3 种官方音效和官方配色图片 |
| HUAWEI FreeBuds 5 | 扩展支持 | 电量、降噪 / 关闭与状态回读、智慧动态 / 轻度 / 均衡三档降噪、佩戴检测、4 种官方音效、高清音质与低时延自动保持；手势设置待补充 |
| HUAWEI FreeBuds 5i | 扩展支持 | 电量、通透 / 降噪 / 关闭与状态回读、智慧动态 / 轻度 / 均衡 / 深度四档降噪、左右耳双击、佩戴检测、4 种官方音效、高清音质、低时延自动保持与官方配色图片；长按和滑动设置待补充 |
| HUAWEI FreeBuds 6i | 扩展支持 | 电量、通透 / 降噪 / 关闭、4 档降噪、通透人声模式、双击 / 三击手势、4 种官方音效、10 段自定义均衡器、低时延自动保持与专属图片 |
| HUAWEI FreeBuds Pro 3 | 扩展支持 | 电量、三态控制与状态回读、4 档降噪、通透人声模式、长按 / 捏合 / 滑动手势与低时延自动保持 |
| HUAWEI FreeBuds Pro 4 | 基础支持 | 电量、降噪 / 关闭两态控制；暂不支持降噪状态回读与手势设置 |
| HUAWEI FreeBuds Pro 5 | 扩展支持 | 电量、三态回读、4 档降噪、通透 / 透传人声 / 智慧动态透传、三击 / 按捏 / 轻滑音量、佩戴检测、自适应音量、头动与语音控制、空间音频、9 种悦彰 / 场景 / AI 音效、10 段自定义均衡器、高清音质、低时延自动保持、双设备连接、开盒提示音与耳塞材质 |
| HUAWEI FreeBuds 7i | 扩展支持 | 电量、通透 / 降噪 / 关闭与状态回读、4 档降噪、双击 / 三击 / 长按 / 滑动音量、佩戴检测、头动控制、空间音频、4 种官方音效、10 段自定义均衡器、高清音质、低时延自动保持、双设备列表管理与官方配色图片 |
| HUAWEI FreeClip | 扩展支持 | 左右耳与充电盒电量、双击 / 三击手势、佩戴检测、左右耳机自适应、掉落提醒、4 种官方音效和低时延自动保持；不支持传统主动降噪与自定义 EQ |
| HUAWEI FreeClip 2 | 扩展支持 | 电量、双击 / 三击 / 滑动手势、空间音频、低时延自动保持及部分佩戴和音频设置；不支持传统主动降噪 |
| HUAWEI FreeArc | 扩展支持 | 左右耳与充电盒电量、双击 / 三击 / 按住 / 滑动手势、5 种官方音效、10 段自定义均衡器与官方配色图片；不支持传统主动降噪 |
| 华为智能眼镜（第一代） | 基础支持 | 左右镜腿电量与系统界面集成；不提供主动降噪 |
| HUAWEI Eyewear 2 | 基础支持 | 左右镜腿电量、双击 / 滑动手势与低时延自动保持；不提供主动降噪 |
| HUAWEI Eyewear 3 | 基础支持 | 协议型号识别、左右镜腿电量、系统眼镜分类与官方配色图片；不提供主动降噪 |
“稳定”表示已完成较充分的实机验证；“扩展支持”表示已接入更多协议控制；“基础支持”表示已接入识别、电量或核心控制。除稳定型号外，其余型号仍建议继续进行真机回归。表中未列出的官方功能不代表已经支持。
如需适配其他华为耳机，可提交 Issue 或提供脱敏抓包数据。
- 在系统蓝牙详情页显示电量及机型支持的控制项
- 接入 HyperOS 连接弹窗和超级岛
- 接入 ColorOS 官方耳机连接弹窗；Android 16+ 可在流体云显示左右耳与充电盒电量
- 可分别控制锁屏耳机通知与超级岛通知
- 通知可打开模块弹窗、系统设置或华为智慧音频；模块弹窗可直接切换低时延
- 接入融合设备中心，并支持已配对设备间流转；支持低时延的机型可复用“查找耳机”卡片快速切换
- 显示左右耳、充电盒或眼镜左右镜腿电量
- 按机型提供主动降噪、通透模式、降噪等级和手势设置
- 直接从蓝牙协议读取现代型号的精确资源身份，并从华为官方 CDN 校验、缓存对应机型与配色图片
- 耳机名称被修改或无法自动识别时，可按蓝牙地址手动选择型号
- 首次启动提供设置引导，并可在应用内检查 GitHub 更新
- 覆盖安装新版本后提示重启作用域，无需直接重启手机
- 小米 / Redmi HyperOS，或 OPPO / OnePlus / realme ColorOS 设备
- Android 15 及以上
- LSPosed API 101 及以上
- 表中任一已集成型号
-
从 GitHub Releases 下载并安装 APK；首次打开可按引导检查 LSPosed 与核心作用域。
-
在 LSPosed 中启用 HuaweiPods。
-
按系统勾选作用域：
- ColorOS：
com.android.bluetooth、com.heytap.mydevices、com.heytap.accessory（com.heytap.accessory用于系统“快速设备连接”官方弹窗；可选勾选com.android.settings，用于打开通用蓝牙详情页） - HyperOS 完整集成：
com.android.bluetooth、com.android.settings、com.milink.service、com.xiaomi.bluetooth
- ColorOS：
-
在 HuaweiPods 内重启相关作用域，或重启手机。
-
ColorOS 16+ 首次使用流体云时，在 HuaweiPods 设置中点击“ColorOS 流体云”，并在系统通知设置开启“实时提醒”。
-
连接设备后，即可在 HuaweiPods 查看已接入能力；HyperOS 还可使用蓝牙详情页、超级岛或融合设备中心。现代型号会直接读取设备标识；改名设备或旧协议型号识别失败时，再在 HuaweiPods 中选择一次真实型号。
正式版不需要安装或运行华为智慧音频来获取图片：现代型号由蓝牙协议直接确认机型与配色，旧协议型号可在图片设置中检索华为官方配色并手动确认。下载失败时始终回退到已有缓存或内置图，不会猜测默认配色。
融合设备中心低时延卡片可在 HuaweiPods 设置中关闭。由于现有协议没有可靠的低时延状态回读，界面显示最近一次成功写入且会在重连时恢复的设置，不代表耳机主动上报的实时状态。
更完整的安装说明见 快速开始。
未支持型号需要先采集华为智慧音频（com.huawei.smartaudio）与耳机之间的真实通信数据。通用协议采集版按设备、噪声与音量、手势、音质、连接和充电盒等类别引导单变量操作；只负责记录，不代表该型号已经适配。
请勿直接公开包含设备地址、账号或其他个人信息的原始采集文件。提交前请检查并脱敏，完整流程见 华为耳机协议采集指南。
可复现问题请提交至 GitHub Issues。
# 正式版
./gradlew :app:assembleRelease
# 协议采集与调试版
./gradlew :app:assembleDebugrelease 的图片识别不依赖华为智慧音频；仅在智慧音频本来就在运行时，注入一个 FreeClip 2 空间音频同步桥，不会主动启动或保活它。debug 另外包含面向适配工作的智慧音频协议采集功能。两者使用相同应用 ID，无法同时安装。
- HuaweiPods by Nshpiter（本适配版的直接上游）
- OppoPods by 1812z（HuaweiPods 直接基于）
- OppoPods by Leaf-lsgtky（上游原始项目）
- HyperPods by Art_Chen
- HyperIsland by 1812z（更新与首次引导交互参考）
- Miuix
本项目基于 GPL-3.0 开源。