HuaweiPods ColorOS 是一个使用独立应用 ID io.github.artifical0.huaweipods.coloros 的 Android 15+ Xposed 模块，不会被原版 HuaweiPods 的 LSPosed 商店条目覆盖更新。ColorOS 已接入官方“快速设备连接”弹窗、“我的设备”耳机详情入口、系统耳机电量通道及 Android 16+ 流体云电量卡片；HyperOS 保留上游的系统蓝牙详情页、连接弹窗、超级岛与融合设备中心集成。
ColorOS 说明：“我的设备”入口已适配 ColorOS 16.1（
com.heytap.mydevices17.4.15）与 ColorOS 17（17.25.10）两代详情页。ColorOS 17 部分目前依据 OnePlus PLK110PLK110_17.0.0.102(CN01)固件静态核对，尚待实机验证。私有宿主会随系统更新变化，未知版本会退回系统原样，仍保留模块内电量、流体云和通用蓝牙详情页。
连接手机并启用 USB 调试后，可在 Windows PowerShell 运行 ./tools/capture-coloros-environment.ps1，生成不含日志、账号和蓝牙地址的宿主环境包，供下一阶段适配使用。
当前统一版已集成下列 16 个型号，所有型号使用同一个 APK，不再按型号单独分发测试包。
- 同步上游 HuaweiPods 1.8.3：新增 HUAWEI FreeBuds SE 4 ANC，修复模块弹窗中低时延设置写入成功后未保存，并包含 1.7.x～1.8.x 的协议、界面与稳定性更新。
- 系统耳机电量：蓝牙进程把华为耳机的左右耳 / 充电盒电量写入 ColorOS 自有的耳机电量通道（与 AirPods、三方耳机相同），并同步 Android 标准电量。状态栏耳机电量、蓝牙设置和“我的设备”等系统界面可以直接读取。
- 快速设备连接弹窗：官方弹窗从仅 FreeClip 扩展到所有已支持型号；没有缓存官方图时使用对应机型的内置图。
- 我的设备（ColorOS 17）：适配改为 Preference 页面的新版详情页，原“蓝牙设置”入口改为显示 HuaweiPods 电量与设置，点击打开模块弹窗。
- 快速设备连接（ColorOS 17）：适配 17.6.x 改名后的卡片数据类与关闭方法，卡片不会被系统立即自动收起。
- 蓝牙进程 Hook、流体云实时通知、系统设置入口已对照 ColorOS 17 固件核对，签名与行为保持兼容。
- LSPosed API 102：正式版改用上游的 API 102 入口，在 API 102 框架（如 Vector）上覆盖安装新版后自动热重载，无需逐个重启作用域；只支持 API 101 的框架仍可正常加载，只是没有热重载。
- 在系统“自启动”页面开启 HuaweiPods ColorOS；在“应用详情 → 耗电管理”选择 完全允许后台行为。这可能增加后台耗电。重装后需重新检查这些设置。
- 允许蓝牙与通知权限，并开启系统通知设置中的“实时通知 / 流体云”。首次安装后打开应用一次，再连接耳机。
- 更新后重启蓝牙作用域，或重启手机，让蓝牙进程加载新版模块；期间耳机会短暂断连。
- 若流体云只在手动打开应用后恢复，请先检查上述自启动和后台权限。
- ColorOS 16 实测范围（2026-09-08，1.8.1-coloros.3）：OnePlus PLK110、
PLK110_16.0.10.500(CN01)、Android 16（API 36）、HUAWEI FreeClip。已确认模块服务连接正常、流体云可见；模拟应用进程被回收并重启蓝牙后，耳机重连可自动恢复流体云，无需打开应用。尚未验证整机重启后的自动恢复。 - 从 1.8.1-coloros.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 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 | 基础支持 | 协议型号识别、左右镜腿电量、系统眼镜分类与官方配色图片；不提供主动降噪 |
表格仅列出当前已接入的能力；未列出的官方功能不代表已经支持，具体表现还会受到耳机固件和 HyperOS 系统组件版本影响。
如需适配其他华为耳机，可提交 Issue 或提供脱敏抓包数据。
- 在系统蓝牙详情页显示电量及机型支持的控制项
- 接入 HyperOS 连接弹窗和超级岛
- 接入 ColorOS 官方耳机连接弹窗；Android 16+ 可在流体云显示左右耳与充电盒电量
- 可分别控制锁屏耳机通知与超级岛通知
- 通知可打开模块弹窗、系统设置或华为智慧音频；模块弹窗可直接切换低时延
- 接入融合设备中心，并支持已配对设备间流转；已验证的旧版宿主可复用“查找耳机”卡片快速切换低时延
- 显示左右耳、充电盒或眼镜左右镜腿电量
- 按机型提供主动降噪、通透模式、降噪等级和手势设置
- 直接从蓝牙协议读取现代型号的精确资源身份，并从华为官方 CDN 校验、缓存对应机型与配色图片
- 耳机名称被修改或无法自动识别时，可按蓝牙地址手动选择型号
- 首次启动提供设置引导，并可在应用内检查 GitHub 更新
- 独立的关于页面集中展示版本、更新、反馈与社区入口，完整设置收进右上角入口
- 覆盖安装新版本后提示重启作用域，无需直接重启手机
- 小米 / Redmi HyperOS，或 OPPO / OnePlus / realme ColorOS 设备
- Android 15 及以上
- LSPosed API 101 及以上（API 102 框架额外支持覆盖安装后自动热重载）
- 表中任一已集成型号
-
从 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 - 可选：
com.huawei.smartaudio（已安装华为智慧音频时，用于 FreeClip 2 空间音频与自定义音效同步）
- ColorOS：
-
在 HuaweiPods 内重启相关作用域，或重启手机。
-
ColorOS 16+ 首次使用流体云时，在 HuaweiPods 设置中点击“ColorOS 流体云”，并在系统通知设置开启“实时提醒”。
-
连接设备后，即可在 HuaweiPods 查看已接入能力；HyperOS 还可使用蓝牙详情页、超级岛或融合设备中心。现代型号会直接读取设备标识；改名设备或旧协议型号识别失败时，再在 HuaweiPods 中选择一次真实型号。
正式版不需要安装或运行华为智慧音频来获取图片：现代型号由蓝牙协议直接确认机型与配色，旧协议型号可在图片设置中检索华为官方配色并手动确认。下载失败时始终回退到已有缓存或内置图，不会猜测默认配色。
融合设备中心低时延卡片只在已验证的旧版宿主中启用，并可在 HuaweiPods 设置中关闭；HyperOS 4 请从模块弹窗或详情页操作。1.8.3 修复了 FreeBuds 6i 等机型在弹窗内写入成功后设置未保存、再次打开又显示关闭的问题。现有协议没有可靠的低时延状态回读，界面显示最近一次成功写入且会在重连时恢复的设置，不代表耳机主动上报的实时状态；耳机端效果仍需实机验证。
更完整的安装说明见 快速开始。
未支持型号需要先采集华为智慧音频（com.huawei.smartaudio）与耳机之间的真实通信数据。通用协议采集版按设备、噪声与音量、手势、音质、连接和充电盒等类别引导单变量操作；只负责记录，不代表该型号已经适配。
请勿直接公开包含设备地址、账号或其他个人信息的原始采集文件。提交前请检查并脱敏，完整流程见 华为耳机协议采集指南。
可复现问题请提交至 GitHub Issues。
# 正式版（按 LSPosed API 102 构建，兼容 101）
./gradlew :app:assembleRelease
# 协议采集与调试版（LSPosed API 101，包含采集界面）
./gradlew :app:assembleDebugrelease 的图片识别不依赖华为智慧音频；仅在智慧音频本来就在运行时，注入一个 FreeClip 2 空间音频同步桥，不会主动启动或保活它。release 按 API 102 构建并携带自动热重载元数据，运行时兼容 API 101 框架；debug 固定使用 API 101，另外包含面向适配工作的智慧音频协议采集功能。两者使用相同应用 ID，无法同时安装。
- HuaweiPods by Nshpiter（本适配版的直接上游）
- 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 开源。