HuaweiPods

外观

快速开始 ​

HuaweiPods 是面向小米 HyperOS 的 Xposed 模块。从 1.2.0 起项目使用统一 APK，当前源码已接入 20 个型号（含 FreeClip 2 典藏版及待实测的 FreeBuds 4）；各型号的发布状态、实机验证程度和可用控制并不相同，请先查看支持型号。

安装前确认

HuaweiPods 需要正常工作的 LSPosed 环境，并会修改系统蓝牙相关进程的行为。请先确认你了解 Xposed 模块的启用、停用与恢复方式。

环境要求 ​

  • 小米或 Redmi 设备，运行 HyperOS；
  • Android 14 或更高版本（Android 14 / HyperOS 2 请安装 1.9.1 或更新版本）；
  • 正式版需要 LSPosed API 102 或更高；协议采集 Debug 版沿用 API 101；
  • 已在系统蓝牙中配对支持列表中的设备。

HyperOS 2 同时存在 Android 14 和 Android 15 版本，应以手机的 Android 版本为准。1.9.0 APK 最低要求 Android 15；从 1.9.1 起最低要求调整为 Android 14，并保留 API 102。LSPosed 是否支持 API 102 是启用模块的条件，与 Android 安装版本限制是两件事。HyperOS 2 兼容已覆盖本次提供的系统组件，其他组件版本仍需实机验证；超级岛样式需要宿主系统本身支持。系统蓝牙详情页中的“更多设置”会打开 HuaweiPods 对应耳机页，不再依赖小爱同学入口。

1. 安装 HuaweiPods ​

从 GitHub Releases 下载正式 APK，正常安装后打开 HuaweiPods。1.2.0 及以上版本无需寻找机型专用包。首次安装会显示简短引导，用于检查 LSPosed 服务和两个核心蓝牙作用域；缺少项目时仍可继续，之后再到 LSPosed 补齐。

2. 启用 LSPosed 作用域 ​

在 LSPosed 中启用 HuaweiPods，并勾选以下作用域：

text
com.android.bluetooth
com.android.settings
com.milink.service
com.xiaomi.bluetooth
com.huawei.smartaudio

3. 重启并连接耳机 ​

启用后可先在 HuaweiPods 中重启相关作用域；若系统组件没有重新加载模块，再完整重启手机。之后连接已配对的受支持设备。

模块会优先读取耳机协议中的设备标识，并按蓝牙地址记住已确认的型号。首次连接、耳机被改名或旧型号无法返回设备标识时，仍可在设备选择页选择一次真实型号；该选择只影响当前地址，不会把同名设备的控制协议混用。

首页右上角提供“使用文档”和“赞助支持”入口。“使用文档”会在 App 内安全加载 HuaweiPods 官网：站内页面留在 App，GitHub 等外部链接才交给系统浏览器；文档内容会随官网持续更新。底部栏保留“模块、耳机、关于”三个常用入口，完整设置可从“关于”页右上角进入。

耳机图片从华为官方 CDN 获取，无需安装智慧音频。支持 DeviceInfo 的型号自动读取 modelId/subModelId 并匹配配色；FreeBuds 3 等旧协议型号可在图片设置中检索并确认官方配色。身份不完整、网络不可用或校验失败时，继续使用缓存或内置图。FreeClip 2 空间音频可通过已运行的智慧音频同步，模块不会主动启动或保活它。

你可以依次检查：

  1. HuaweiPods 首页是否显示模块已激活；
  2. 左右耳与充电盒电量，或眼镜左右镜腿电量是否更新；
  3. 系统蓝牙详情页是否出现该型号支持的状态与控制；
  4. 重新连接耳机后，超级岛或系统弹窗是否出现；
  5. 融合设备中心是否显示耳机。

FreeClip、FreeClip 2 和 Eyewear 系列不提供传统主动降噪，看不到降噪入口是正常现象。标记为“待复测”的功能如果与官方 App 表现不一致，请保留复现步骤并反馈。

通知名称与电量岛常驻 ​

耳机通知和超级岛优先显示系统蓝牙设置中保存的设备名称。例如改为“HUAWEI Slime”， 通知标题也会使用这个名字；没有别名时显示原始名称。连接期间保存新名称后， 已有耳机通知会更新，不必等待下次电量变化或重新连接。名称变化不会改变真实机型、 控制协议或按地址保存的配置。

在 HuaweiPods 的“关于 → 设置”中选择超级岛样式，再开启“电量超级岛常驻”。 该开关默认关闭；开启后电量岛持续显示，收到耳机新电量时更新，断开连接后清除。 模块样式可独立于普通耳机通知使用；系统样式需要同时开启“耳机常驻通知”。 常驻不会让不支持超级岛的 ROM 获得超级岛，也不表示耳机每秒上报电量。

以上通知更新从 1.9.1 正式版起提供。

低时延更新说明 ​

1.9.1 修复模块低时延操作重复建立连接、自动开启与手动关闭相互覆盖的问题，并过滤旧版融合中心退出详情时误触发的关闭请求。若旧版本已把低时延自动保持改为关闭，更新后请在模块中手动开启一次，再正常重连。

通用低时延开关显示最近一次成功写入的设置，不代表实时状态回读；FreeBuds 6 / 7 专属面板另有回读。典藏版连续重连修复尚待群友实机复测。融合中心不支持安全快捷卡的版本，请从模块页面操作。

没有生效时 ​

按下面顺序排查，通常不需要反复卸载：

  1. 确认 LSPosed 中 HuaweiPods 已启用，且 API 版本满足要求；
  2. 核对五个作用域是否全部勾选；未安装华为智慧音频时可忽略对应项；
  3. 在 HuaweiPods 内重启相关作用域；仍无效时再重启手机；
  4. 在系统蓝牙中断开再连接耳机；
  5. 在设备选择页确认当前蓝牙地址绑定的是实际型号；
  6. 对照支持型号，确认该入口确实属于当前机型。

仍无法复现时，请加入 QQ 群 1022359908，附上耳机型号、手机型号、HyperOS 版本、LSPosed 版本、HuaweiPods 版本和复现步骤；也可以先查看 GitHub Issues 中是否已有相同问题。

更新或卸载 ​

  • 同签名的新版本可以直接覆盖安装；
  • 可在主界面底部“关于”页手动检查 GitHub 更新，也可关闭启动时自动检查；
  • 覆盖安装完成后，HuaweiPods 会提示选择并重启作用域，使新版 Hook 生效；
  • 如果系统提示签名不一致，请改用同一发布渠道提供的版本；
  • 停用或卸载前，先在 LSPosed 中取消 HuaweiPods 作用域，再重启相关进程或手机。

第三方开源项目，与华为、小米及其关联公司无隶属或合作关系。

Released under GPL-3.0 · HuaweiPods