面向 HyperOS 的 Apple Music 深度适配与系统级歌词展示增强工具
HyperLyrics Enhanced 是一个为小米 HyperOS 设备打造的 Android 模块与独立应用,也为其他安卓品牌手机提供 Apple Music 体验优化。
- 将 Apple Music 的逐字歌词、翻译、伴唱和歌曲信息更完整地带入小米 HyperOS 的超级岛、媒体卡片与 AOD。
- 将 Apple Music 体验进一步优化,且面向所有安卓品牌手机。
- 内置 Lyricon Central 调度中枢与官方 Provider 插件中心,无缝兼容支持网易云音乐、QQ 音乐、Spotify 等其他主流播放器。
本项目基于 limczhh/HyperLyric 二次开发,现已形成独立的功能方向和维护边界。
Warning
HyperLyrics Enhanced 不是 HyperLyric 的官方后续版本。仅在本项目中出现的问题,请在本项目的 Issue 中反馈,不要打扰原项目维护者。
- 内置调度中枢:内置 Lyricon Central 核心调度服务与统一歌词管线,无需额外下载安装独立的词幕服务模块,开箱即用。
- 官方 Provider 插件管理:支持在应用内直接下载、安装、更新、启停主流音乐 App 的官方 Provider 插件(网易云音乐、QQ 音乐/Pad、Spotify、汽水音乐、酷狗/概念版、酷我音乐、椒盐音乐等),无需再为各个音乐 App 分别寻找并安装独立的 APK 模块。
- 损坏自修复与来源仲裁:支持插件损坏自动检测与修复;完美兼容已安装的第三方独立 LyricProvider 模块,在共存时自动遵循官方插件优先原则。
- 内置逐字歌词 Provider:Apple Music 用户不需要额外安装 Lyricon、Lyricon Central 或独立 LyricProvider,即可使用推荐作用域配置。
- 高可用直连同步:直接传递歌词、播放状态和进度,并在 SystemUI 重连、切歌或数据延迟后重新同步当前歌曲。
- 多维度体验调整:支持在 Apple Music App 内进行内容 UI 地区语言、歌曲信息地区化、原地区名称恢复、元数据检索缓存、繁体歌词转简体、歌词模糊效果、跟随系统字体粗细等优化。
- 为无歌词歌曲补充歌词:针对 Apple Music 无原生歌词的歌曲,可开启自动从三方在线源检索并注入展示,支持切源后播放时间轴平滑映射与精准定位。
- 应用内歌词源与翻译切换:支持在 Apple Music 播放界面内自由切换歌词源、在线翻译与发音,并直观展示匹配行数与百分比统计。
- 原生数据优先:Apple Music 的原生歌词、翻译和发音数据优先显示;缺失内容可按配置从在线歌词源补全。
- 统一构建管线:移除原有在线/离线构建分支,将在线歌词能力整合进统一版本。
- 原生优先与多源兜底:Apple Music 原生歌词优先;确认没有可用原生歌词后,从网易云音乐、QQ 音乐、酷狗音乐、酷我音乐等在线源获取歌词与译文兜底。
- 精准版本特征识别:根据标题、歌手、时长和版本特征进行匹配,尽量区分同名歌曲、Live、Remastered、翻唱和不同剪辑版本。
- 健壮的歌词格式解析:处理 LRC/QRC、逐行歌词和逐字歌词之间的结构转换,并修复无效行、重复时间戳、缺失结束时间、相邻重复歌词不刷新等常见问题。
- 智能时间轴与结构匹配:在线歌词和译文按时间轴与结构进行匹配,支持一行对多行、多行对一行等差异,减少翻译错位。
- 明确的优先级链条:Apple Music 原生译文优先。
- 四家在线源聚合与并发竞速:支持网易云音乐、QQ 音乐、酷狗音乐、酷我音乐四家在线翻译源;支持自定义排序与“自动选择最优来源”并发竞速机制,根据覆盖率和匹配质量选择更合适的结果。
- 智能显示模式:支持原文、仅翻译、仅发音等显示模式,并在单项缺失时智能回退。
- 灵活控制与 AI 补全:已匹配的在线译文优先于 AI 补全;支持按应用单独启用/禁用在线翻译,为椒盐音乐等提供优先使用在线源选项;AI 翻译(OpenAI 兼容接口)只补充缺失内容,需要时也可以开启强制 AI 翻译覆盖已有译文。
- 提供两套 AOD 歌词路径:锁屏 AOD 与经典 AOD。
- AOD 支持主句、伴唱、翻译、下一句歌词、对唱居中、暂停行为、下首歌曲预览和显示位置配置。
- 经典 AOD 还可以选择显示歌曲信息的样式:焦点通知样式或嵌入式文本样式。
| 模式 | 适合人群 | 主要能力 | 依赖 |
|---|---|---|---|
| Xposed / LSPosed 模式 | 已 Root、希望使用原生超级岛/系统界面注入 | HyperOS 超级岛、SystemUI 媒体卡片、Apple Music 深度适配、AOD 与系统白名单增强、主流播放器官方插件注入 | LSPosed v2.0+;HyperOS 3 相关功能需要对应 SystemUI |
| 通知歌词模式 | 未 Root 或不使用 Xposed 的设备 | 实时通知/焦点通知歌词、通知型灵动岛、基础媒体信息展示 | 通知发送权限、通知使用权;部分功能可选 Shizuku |
两种模式可以分别配置。Apple Music 内置 Provider、官方 Provider 插件与体验优化功能均属于 Xposed 侧能力;通知模式则依赖播放器提供媒体信息或歌词通知数据。
- 从本项目的 Releases 下载并安装 APK。
- 在 LSPosed 中启用 HyperLyrics Enhanced,并勾选推荐作用域:
- 核心系统组件:
com.android.systemuimiui.systemui.plugin
- 音乐播放器(根据使用需求勾选):
com.apple.android.music(Apple Music)com.netease.cloudmusic/com.hihonor.cloudmusic(网易云音乐)com.tencent.qqmusic/com.tencent.qqmusicpad(QQ 音乐 / HD)com.spotify.music(Spotify)com.luna.music(汽水音乐)com.kugou.android/com.kugou.android.lite(酷狗音乐 / 概念版)cn.kuwo.player(酷我音乐)com.salt.music(椒盐音乐)
- 核心系统组件:
- 打开应用主页的“超级岛歌词”,在“歌词设置”中配置歌词模式和歌词来源。
- 播放器 Provider 配置:
- Apple Music:直接使用内置 Provider,无需额外插件。
- 其他播放器:在应用内“Provider”页面一键下载对应音乐 App 的官方 Provider 插件并启用。
- 根据提示重启 SystemUI 和对应音乐 App。
- 打开应用主页的“通知型灵动岛歌词”。
- 授予发送通知权限和通知使用权。
- 在歌词白名单中添加需要显示歌词的音乐 App。
- 选择实时通知或焦点通知,并按需配置图标、进度条、歌曲信息和点击行为。
- 如果设备后台限制较严格,可以在页面内配置自启动、电池优化;焦点通知限制绕过功能需要运行中的 Shizuku。
具体系统版本、权限入口和通知表现可能因 HyperOS/Android 版本而变化,请以应用内“使用帮助”和设备实际行为为准。
项目最低支持 Android 13(API 33),但不同功能依赖不同的系统界面实现:
| 功能 | 当前目标环境 | 备注 |
|---|---|---|
| HyperOS 超级岛歌词与 SystemUI 注入 | Android 15+ / HyperOS 3 | 需要 LSPosed v2.0+ 以及 miui.systemui.plugin |
| Apple Music 内置 Provider 与深度适配 | Android 13+,配合 LSPosed | 作用于 com.apple.android.music;Apple Music 版本变化可能影响兼容性 |
| 主流播放器官方 Provider 插件 | Android 13+,配合 LSPosed | 需勾选对应音乐 App 作用域并在应用内下载启用插件 |
| 锁屏 AOD / 经典 AOD | 米系 Android 13+ | 取决于设备的 AOD 实现和对应作用域 |
| 通知型灵动岛歌词 | Android 13+ | 需要通知发送权限、通知使用权和播放器数据 |
| 小米焦点通知增强 | HyperOS 2 / HyperOS 3 | 可能需要移除焦点通知白名单 |
| 下拉小窗白名单增强 | Android 16 / HyperOS 3.0.300+ | 依赖对应系统版本 |
| Android 实时通知 | Android 16;部分 HyperOS 3 / ColorOS 16 | 是否显示为系统级实时通知由系统决定 |
系统更新、SystemUI 插件更新和音乐 App 更新都可能改变内部实现。遇到不适配时,建议先导出应用日志,并在 Issue 中附上设备型号、Android/HyperOS 版本、音乐 App 版本和复现步骤。
| 歌词源 | 说明 | 额外依赖 |
|---|---|---|
| Lyricon | 统一歌词管线与调度中枢 | 已完全内置;其他播放器直接在应用内下载官方插件即可,无需安装独立 Central 模块(仍兼容独立 LyricProvider APK) |
| SuperLyric | 获取逐行或逐字歌词以及更细粒度的时间轴 | SuperLyric,并按其说明开启广播 |
| LyricInfo | 读取媒体会话中的 lyricinfo 数据 | LyricInfo,可选 |
| 在线歌词与翻译 | Apple Music 补充歌词及在线翻译(支持网易云、QQ 音乐、酷狗、酷我四家来源) | 需要联网;可在歌词设置中关闭、排序或调整优先来源 |
| AI 翻译 | 对缺失译文进行补全,支持 OpenAI 兼容接口 | 需要用户自行提供 API Key、模型和接口地址 |
本项目使用 Gradle 和 Kotlin/Compose。常用本地检查命令:
./gradlew :app:testDebugUnitTest
./gradlew :app:assembleDebugRelease 构建需要在项目根目录提供 keystore.properties,或设置构建脚本读取的 Release 签名环境变量。APK 输出名称会包含版本名和 versionCode。
- Xposed 模式需要 LSPosed 及相应作用域;通知模式不要求 Root。
- 在线歌词、在线译文和 AI 翻译仅在对应功能开启时使用网络。
- AI 翻译使用的 API Key、模型和服务地址由用户自行配置,第三方服务的隐私政策和费用由用户自行承担。
- 焦点通知、实时通知、AOD 和 SystemUI 注入均受设备厂商实现、系统版本、电池策略和后台限制影响。
本项目采用 GNU General Public License v3.0 开源协议发布。
感谢以下项目和贡献者:
- HyperLyric:本项目的基础项目,原有能力和上游贡献仍归原作者及其贡献者。
- miuix-kmp:HyperOS 风格 Compose 组件库。
- lyricon:歌词订阅、数据模型和部分歌词动画基础。
- SuperLyric
- LyricInfo
- libxposed
请在提交 Issue 或 Pull Request 时保留相关上游项目、第三方库和原作者的归属信息。