ColorOS Live Lyrics Bridge v4.5.4

v4.5.4 是锁屏歌词行位与网易云显示歌词的修复版本，处理两类会让歌词“少一句、错一行”的问题：方括号开头的歌词被系统原生解析吞掉，以及网易云 9.6.20 的官方显示歌词尾部乱序。Bridge 与网易云音乐 Provider 有代码变化，其余 13 个歌词 Provider 与动态封面 Provider 1.0.6 的代码和内部版本不变，套件资产文件名更新到 4.5.4。

锁屏歌词

• 修复某些歌词以方括号开头时（例如 [so simple and clean]）整行不进入系统原生歌词列表的问题。ColorOS 解析器会把紧接时间标签的 [...] 当作标签继续消费；Bridge 现在在时间标签与这类正文之间写入一个不可见分隔符，原生扫描在此停止。可见文字、逐字时间、翻译、行数与滚动都不变，重复处理也不会累积字符。
• 该问题会让后续每一句在原列表与 Bridge 模型中相差一行，表现为某句开始失去实时高光、随后当前行持续偏移到歌词区上边界；修复后行位、高亮与滚动恢复一致。
• 行测量、文字匹配与自绘改为使用已提交的原生行绑定身份，而不是可能仍挂着上一行的可变 TextView 文本；被回收、旧事务或布局不支持的绑定不再提供绘制内容。
• 开头“标题/歌手”复用行现在只对已记录的槽位和确切文字生效，普通歌词不会再被误认为标题而选中前一行。

网易云音乐 Provider（1.2.2）

• 网易云 9.6.20 可能在官方显示歌词尾部给出乱序行，或包含超出曲目时长的占位行。系统按列表顺序渲染并按索引映射，一行错位就会让后面所有槽位偏移，出现保留空白行。
• Provider 现在会在宿主时间轴非递增、存在超出已知时长的行，或行数明显少于解码结果时，回退到解码后的有序时间轴；编码前统一排序，保证显示、逐字与翻译三条数据不会互相错序。
• 验证宿主补充网易云 9.6.20。

兼容矩阵与升级

Bridge 继续只作用于 system 和 com.android.systemui，不进入播放器进程，也不依赖 Provider 安装。Provider 仍通过播放器自己的 MediaSession MediaMetadata["lyricInfo"] 发布歌词。

1. 可直接覆盖安装 Bridge 4.5.4；Bridge 作用域保持 system 与 com.android.systemui。
2. 歌词 Provider 中只有网易云音乐需要更新到 1.2.2；其余模块内部版本与 4.5.3 相同，本 Release 中的文件名改为 v4.5.4。
3. 同一播放器只开一个 Provider：专属 Provider 与通用播放器 Provider 二选一，同时开启会互相覆盖 lyricInfo。
4. Debug 签名测试包不能覆盖正式签名包，需要先卸载。从 4.0 或更早版本升级前，仍建议在 Bridge 中完成配置备份。

验证与已知限制

• Bridge 本地门禁：876 项单元测试中 870 项通过、6 项既有外部样例条件测试跳过、0 失败/错误；assembleDebug 成功，git diff --check 通过。新增 4 项行为回归在修复前全部失败，修复后通过。
• Provider 本地门禁：受影响模块 :player-netease 10 项单元测试全部通过，含 3 项新增显示歌词校验用例。
• 用户已在设备确认修复后的测试包：全部歌词正常显示、同步正确，实时行不再偏移；日志 logs/lyrics-log-20261110-045844.txt。该结论对应测试构建，不替代正式签名 RC 的设备验收。
• 兼容性仍取决于厂商 SystemUI 版本和播放器通过 MediaSession 提供的歌词、翻译与进度数据。没有逐字标签的歌词只会使用逐行进度。

资产

正式 Release 包含 19 项已验证资产：1 个 Bridge APK、14 个歌词 Provider APK、1 个动态封面 Provider APK、1 个歌词 Provider ZIP、release-assets-v4.5.4.json 和 SHA256SUMS。Provider ZIP 只包含 14 个顶层歌词 Provider APK；动态封面 Provider 作为独立资产提供。

致谢

感谢提供复现曲目、逐步二分日志并完成设备复测的用户。

English

v4.5.4 fixes lyric-row alignment and NetEase display lyrics. It addresses two defects that could drop or shift a line: bracket-prefixed lyrics being consumed by the vendor's native parser, and an out-of-order tail in NetEase 9.6.20's official display lyric. Bridge and the NetEase Provider change; the other 13 lyric Providers and Dynamic Artwork Provider 1.0.6 keep their code and internal versions, and suite asset file names move to 4.5.4.

Lock-screen lyrics

• A lyric beginning with a bracket, such as [so simple and clean], no longer disappears from the system's native lyric list. ColorOS keeps consuming consecutive [...] groups after the time tag; Bridge now writes an invisible separator between the time tag and such text so the native scan stops there. Visible text, word timing, translations, row count, and scrolling are unchanged, and repeated normalization does not accumulate characters.
• That defect made every later line differ by one between the native list and the Bridge model: a line first lost its live highlight, then the live row drifted to the top edge of the lyric area. Row identity, highlight, and scrolling now stay aligned.
• Measurement, text matching, and custom drawing use the committed native row binding instead of a mutable TextView string that may still carry another row. Recycled, stale-epoch, or unsupported bindings no longer supply drawable content.
• The opening title/artist slot reuse now applies only to its recorded slot and exact text, so ordinary lyrics cannot impersonate a title and select the previous line.

NetEase Provider (1.2.2)

• NetEase 9.6.20 can publish a display lyric whose tail is out of order or that contains a placeholder past the track duration. The system renders rows in list order and maps them by index, so one stray row shifts every later slot and leaves reserved blank rows.
• The Provider now falls back to the decoded ordered timeline when the host timeline is not increasing, contains rows past the known duration, or is materially shorter than the decoded set. All lanes are sorted before encoding, so display, word-timing, and translation data cannot disagree.
• NetEase 9.6.20 is added to the validated hosts.

Compatibility and upgrade

Bridge still runs only in system and com.android.systemui. It does not enter player processes or depend on a Provider being installed. Providers continue to publish through the player's own MediaSession MediaMetadata["lyricInfo"].

1. Install Bridge 4.5.4 over the previous release. Keep its scope at system and com.android.systemui.
2. Only the NetEase Provider needs to move to 1.2.2; the other modules keep their 4.5.3 internal versions, and files in this Release are named v4.5.4.
3. Enable one Provider per player. A dedicated Provider and the Universal Provider overwrite each other's lyricInfo when both are on.
4. A debug-signed build cannot replace a release-signed install; uninstall it first. A configuration backup is still recommended before upgrading from 4.0 or older.

Verification and limits

• Local Bridge gates passed: 870 of 876 unit tests passed, 6 existing external-fixture conditional tests skipped, 0 failures or errors; assembleDebug succeeded and git diff --check passed. The four new behavior regressions failed before the fix and pass after it.
• Local Provider gates passed: all 10 unit tests in the affected :player-netease module, including three new display-lyric cases.
• The user confirmed the fixed test build on device: every lyric displays correctly, stays in sync, and the live row no longer drifts. Log logs/lyrics-log-20261110-045844.txt. This acceptance covers the test build, not the formal signed RC.
• Compatibility still depends on the vendor SystemUI build and on the lyrics, translations, and position data exposed by each player through MediaSession. Lyrics without word tags use line progress only.

Assets

The formal Release contains 19 verified assets: one Bridge APK, 14 lyric Provider APKs, one Dynamic Artwork Provider APK, one lyric Provider ZIP, release-assets-v4.5.4.json, and SHA256SUMS. The Provider ZIP contains only the 14 top-level lyric Provider APKs; the Dynamic Artwork Provider is a separate asset.

Thanks

Thanks to the user who provided the reproduction track, staged binary-search logs, and device acceptance.

Donate

ColorOS Live Lyrics Bridge v4.5.3

v4.5.3 是 realme UI7 锁屏歌词稳定性更新，修复切歌、展开歌词或亮屏后先短暂显示官方渲染的问题，并修复设置回执异常、UI7 歌词行布局适配和字符上浮动画切换实时行时先整体下沉。Bridge 是本次唯一有业务代码变化的组件；14 个歌词 Provider 与动态封面 Provider 1.0.6 的代码和内部版本不变，只有套件资产文件名更新到 4.5.3。

锁屏歌词

• realme UI7 可能在完整逐字报文之前先送来带定时文字的 native-only 更新。Bridge 现在会直接使用当前报文的逐行时间建立自绘模型；完整逐字数据到达后再切换为逐字模式，不再先清空模型、露出约一秒官方渲染。
• 同曲刷新仍优先保留已经绑定身份的完整逐字模型。播放器、观察曲目、songId 或 generation 明确冲突时不会复用旧模型，而是为当前报文建立独立模型，避免串曲。
• UI7 歌词 RecyclerView 的精确字段布局按 u:I 行距、v:J 滚动时长、B:F 非活动行缩放完成适配，恢复 Bridge 对行距、滚动和缩放的稳定控制。
• 修复启用“字符上浮动画”时，下一行成为实时行会先整体下沉 240ms、再随逐字进度上浮的问题；待唱行提前保持零进度位置，切换时直接衔接上浮。
• 切歌过渡改为整次渲染交接：主线程一起发布歌词模型、完整原生列表期待和 renderer 缓存；实际列表提交、行绑定与布局一致后再整批绘制，避免旧列表中的共有制作信息混用新曲模型、单独残留数行。异步列表只读取已提交数据，未重绑的未变行也须在整份新列表确认后迁移。

设置与诊断

• 修复部分设置页保存回执在 SystemUI 解包时触发 BadParcelableException 的问题。回执改用框架 ResultReceiver 代理，不再依赖被 R8 合并或改名的 App 子类。
• 新诊断区分模型解析/发布、原生列表提交、整批绘制提交、清空、同曲保留、原生逐行接管、交接超时和绘制回退。日志不输出完整歌词、原始稳定媒体 ID 或私人路径。
• Debug 日志仍默认关闭，开关只改变日志状态，不参与 Hook、取词、模型发布或绘制门禁。
• 修复正式混淆包的宿主 adapter 识别：从 SystemUI 自己的实际类型与方法签名发现绑定入口，避免 R8 把外部类名改成模块内部混淆名，导致自绘、翻译与高亮整条链路回退原生。

兼容矩阵与升级

Bridge 继续只作用于 system 和 com.android.systemui，不进入播放器进程，也不依赖 Provider 安装。Provider 仍通过播放器自己的 MediaSession MediaMetadata["lyricInfo"] 发布歌词。

1. 可直接覆盖安装 Bridge 4.5.3；Bridge 作用域保持 system 与 com.android.systemui。
2. 歌词 Provider 与动态封面 Provider 无需为本次修复重装；本 Release 中的歌词 Provider 文件名是 v4.5.3，内部版本与 v4.5.2 相同。
3. 同一播放器只开一个 Provider：专属 Provider 与通用播放器 Provider 二选一，同时开启会互相覆盖 lyricInfo。
4. Debug 签名测试包不能覆盖正式签名包，需要先卸载。从 4.0 或更早版本升级前，仍建议在 Bridge 中完成配置备份。

验证与已知限制

• 本地 Bridge 门禁通过：866 项单元测试中 860 项通过、6 项既有外部样例条件测试跳过、0 失败/错误；assembleDebug 成功，Debug/Release lint 均无错误，git diff --check 通过。宿主 adapter 契约、完整数据、事务归属、真实 Android View 及 native Canvas 共 57 项相关回归全部通过。
• 用户已用修复后的测试包在 realme UI7 设备确认：锁屏切歌时先显示官方渲染的问题已修复；同一修复覆盖此前“展开歌词/亮屏”也能触发的路径。
• 用户于 2026-10-25 确认最终正式签名 RC4 测试通过，切歌效果满意，切换过程中没有歌词残留。
• RC4 已经过 R8、lint、正式签名和独立资产校验，并检查过实际混淆 APK 中的宿主类型识别路径；设备验收对应这份签名候选包，debug 构建通过不能替代真机结论。
• 兼容性仍取决于厂商 SystemUI 版本和播放器通过 MediaSession 提供的歌词、翻译与进度数据。没有逐字标签的歌词只会使用逐行进度。

资产

正式 Release 包含 19 项已验证资产：1 个 Bridge APK、14 个歌词 Provider APK、1 个动态封面 Provider APK、1 个歌词 Provider ZIP、release-assets-v4.5.3.json 和 SHA256SUMS。Provider ZIP 只包含 14 个顶层歌词 Provider APK；动态封面 Provider 作为独立资产提供。

致谢

感谢提供 realme UI7 SystemUI 样本、录屏和分阶段 LSPosed 日志，并完成锁屏复测的用户。

English

v4.5.3 is a stability release for realme UI7 lock-screen lyrics. It removes the brief official-rendering flash after a track change, when the lyric page expands, or when the screen wakes. It also fixes settings receipt exceptions, UI7 lyric-row layout compatibility, and the downward dip when the character float-up animation activates the live row. Bridge is the only component with business-code changes. The 14 lyric Providers and Dynamic Artwork Provider 1.0.6 keep their code and internal versions; only suite asset file names move to 4.5.3.

Lock-screen lyrics

• realme UI7 can publish a native-only timed update before the full raw word-timing packet arrives. Bridge now builds a custom line-timed model directly from the timed display text in the current packet, then switches to word timing when the raw source arrives. It no longer clears the model and exposes the official renderer for about a second.
• A complete identity-bound word model is still retained for a same-track refresh. An explicit player, observed-track, songId, or generation conflict prevents reuse; Bridge renders the current packet instead and never reuses a model across tracks.
• The exact UI7 LyricsRecyclerView layout is bound with u:I line spacing, v:J scroll duration, and B:F inactive-row scale, restoring stable spacing, scrolling, and scaling.
• With character float-up enabled, the next row no longer dips for 240ms before becoming the live row. Upcoming rows already use the zero-progress position and continue directly into the reveal.
• Track transitions now commit a complete render transaction. The UI thread publishes the model, expected native dataset, and renderer-cache reset together. Pixels are emitted as one batch only after the committed native list, actual row bindings, and geometry agree, preventing shared credits in the old list from being rendered with the new model. Asynchronous lists use their committed data; unchanged rows can migrate only after the complete new dataset is confirmed.

Settings and diagnostics

• Settings save receipts no longer depend on an R8-merged App ResultReceiver subclass that could fail during SystemUI unmarshalling. The six affected settings activities now use a framework ResultReceiver proxy around the Binder write.
• Diagnostics distinguish model parsing/publication, native-dataset commits, pixel-batch commits, clearing, same-track retention, native line-timed takeover, handoff timeout, and draw fallback. They omit complete lyrics, raw stable media IDs, and private paths.
• Debug logging remains off by default and does not gate hooks, lyric acquisition, model publication, or drawing.
• Release builds discover adapter binding through SystemUI's actual types and method signatures. This prevents R8 from replacing a host class-name comparison with the module's own obfuscated AndroidX name and disabling custom rendering, translations, and highlights.

Compatibility and upgrade

Bridge still runs only in system and com.android.systemui. It does not enter player processes or depend on a Provider being installed. Providers continue to publish through the player's own MediaSession MediaMetadata["lyricInfo"].

1. Install Bridge 4.5.3 over the previous release. Keep its scope at system and com.android.systemui.
2. Lyric Providers and the Dynamic Artwork Provider do not need a reinstall for this fix. Lyric Provider files in this Release are named v4.5.3 and keep the v4.5.2 internal versions.
3. Enable one Provider per player. A dedicated Provider and the Universal Provider overwrite each other's lyricInfo when both are on.
4. A debug-signed build cannot replace a release-signed install; uninstall it first. A configuration backup is still recommended before upgrading from 4.0 or older.

Verification and limits

• Local Bridge gates passed: 860 of 866 unit tests passed, 6 existing external-fixture conditional tests skipped, with 0 failures or errors; assembleDebug succeeded, Debug/Release lint reported no errors, and git diff --check passed. All 57 focused host-adapter, dataset, transaction, real-View, and native-Canvas regressions passed.
• The user confirmed the fixed test build on a realme UI7 device: the official-rendering flash on lock-screen track changes is gone. The same repair covers the previously reproducible lyric-expansion and screen-wake paths.
• On 2026-10-25, the user accepted the final release-signed RC4: testing passed, track transitions were satisfactory, and no lyric residue appeared during switching.
• RC4 passed R8, lint, formal signing, and independent asset verification, including inspection of host-type discovery in the actual minified APK. Device acceptance applies to this signed candidate; a debug build does not establish device behavior.
• Compatibility still depends on the vendor SystemUI build and on the lyrics, translations, and position data exposed by each player through MediaSession. Lyrics without word tags use line progress only.

Assets

The formal Release contains 19 verified assets: one Bridge APK, 14 lyric Provider APKs, one Dynamic Artwork Provider APK, one lyric Provider ZIP, release-assets-v4.5.3.json, and SHA256SUMS. The Provider ZIP contains only the 14 top-level lyric Provider APKs; the Dynamic Artwork Provider is a separate asset.

Thanks

Thanks to the user who supplied the realme UI7 SystemUI sample, screen recording, staged LSPosed logs, and lock-screen acceptance.

Donate

ColorOS Live Lyrics Bridge v4.5.2

简体中文

v4.5.2 是 Bridge 的兼容与发布构建更新。同一 SystemUI / SystemUIPlugin 的 versionName 与
versionCode 不再被当成同一份二进制：RUS 参数、沉浸式封面写入和 C17 角色按唯一日志或类型定位，
核对过的混淆字母只做回退。正式 Bridge APK 从本版起使用 R8 压缩代码并收缩资源，与歌词 Provider
的 release 构建一致。14 个歌词 Provider 与动态封面 Provider 1.0.6 的代码不变，歌词 Provider 的
资产文件名随套件改为 4.5.2。从 v4.5.1 可直接覆盖升级。

跨设备 SystemUI 兼容

• 一加 16 最新 ColorOS 17 版本上 versionName 同为 17.99.02 / 17.000.002 的 SystemUI 与 SystemUIPlugin，内部方法
  和字段仍可能不同。Bridge 不再只按参考机的混淆字母绑定这些差异。
• RUS 的 dealEndTag、saveListToSP、updatePkgActionsRule 接受参考机与多一张 immersive
  full-background map 的参数形态。
• 沉浸式封面写入按日志 [updateAlbumArtView] animation is running, pending new drawable 定位，
  e(Drawable, boolean) 与 f(Drawable, boolean) 都接受。
• C17 沉浸控制器的槽位、待应用模型、切换标记和渲染器按对应日志的读写字段选择。模型字段可以是
  接口。选不中时回退已核对字母，并始终打出 ARTWORK_C17_PROFILE。
• MediaInfo.albumArt 按 toString 标签 , albumArt= 绑定；卡片弹簧的 running 位按
  cancel/start 的主线程文案交叉定位。
• metadata 变更入口按 onMetaDataChanged error: metaData is null 定位，同时接受命名实例方法
  onMetaDataChanged(String, MediaMetadata) 和合成方法
  access$onMetaDataChanged(..., Continuation)。设置里的歌词清理重放只调用可安全 invoke 的
  两参数实例方法。

发布构建

• Bridge release 启用 R8：minifyEnabled 与 shrinkResources 均为 true，规则沿用 libxposed
  入口适配，并保留 DexKit 的 JNI 类名。Debug 构建不压缩。
• 模块入口仍由 META-INF/xposed/java_init.list 指向 XposedModule 子类；类名被压缩改写时，
  该列表会一起改写。
• kotlin.coroutines.Continuation 保留原名。R8 会把本包里的这个类改名，并改写
  Class.getName() 用到的同名字面量；插件里的状态流参数仍是原名，改写后封面流绑定会失败。

兼容矩阵与升级

Bridge 仍只作用于 system 和 com.android.systemui，不进入播放器进程。

1. 覆盖安装 Bridge 4.5.2。歌词 Provider 与动态封面 Provider 无需为本次功能重装；若从本 Release
   补装歌词 Provider，文件名是 v4.5.2，内部版本与 v4.5.1 相同。
2. Bridge 作用域保持 system 与 com.android.systemui。
3. 同一播放器仍只开一个 Provider：专属 Provider 与通用播放器 Provider 二选一，同时开启会互相覆盖
   lyricInfo。
4. Debug 签名的测试包不能覆盖正式签名包，需要先卸载。

验证与已知限制

• 本地 debug 包已在本机确认：ARTWORK_C17_PROFILE 为 c17Profile=resolved roles=dexkit cardSpringRoles=dexkit，没有字母偏差；沉浸式动态封面两次进入播放。这不是 R8 正式签名包的
  设备验收。
• getArtWorkIconByMediaMetaData 与 loadMediaDataInBg 在当前 SystemUI 上不存在，Bridge 继续
  跳过，不对其做 DexKit。
• 正式签名 RC 的真机确认仍是公开 tag 之前的发布门禁。R8 可能改变反射与资源收缩结果，不能用
  debug 包的播放结果代替正式包验收。
• 兼容性仍取决于厂商 SystemUI 实现，以及播放器经 MediaSession 暴露的歌词与进度信息。

资产

正式 Release 包含 19 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个动态封面
Provider APK、1 个 Provider ZIP、release-assets-v4.5.2.json 和 SHA256SUMS。Provider ZIP
只包含 14 个顶层歌词 Provider APK，动态封面 Provider 单独提供。

致谢

感谢提供同一版本号、不同内部实现的 SystemUI / SystemUIPlugin 样本，并复核动态封面日志的用户。

English

v4.5.2 is a Bridge compatibility and release-build update. Identical SystemUI / SystemUIPlugin
versionName and versionCode values are no longer treated as the same binary: RUS parameters, the
immersive album writer, and C17 roles are located from unique log lines or types, and the reviewed
obfuscated letters are only a fallback. Release Bridge APKs are now minified and resource-shrunk
with R8, matching the lyric Provider release builds. The 14 lyric Providers and Dynamic Artwork
Provider 1.0.6 are unchanged; lyric Provider asset file names follow the suite as 4.5.2. Update in
place from v4.5.1.

Cross-device SystemUI compatibility

• On ColorOS 17, SystemUI and SystemUIPlugin builds that share versionName 17.99.02 / 17.000.002
  can still differ internally. Bridge no longer binds those differences only to the reference
  device's obfuscated letters.
• RUS dealEndTag, saveListToSP, and updatePkgActionsRule accept the reference shapes and the
  shape that adds the immersive full-background map.
• The immersive album writer is found from [updateAlbumArtView] animation is running, pending new drawable. Both e(Drawable, boolean) and f(Drawable, boolean) qualify.
• C17 immersive controller slots, the pending model, switch flags, and the renderer are chosen from
  the fields read or written beside their log lines. The model field may be an interface. If that
  scan misses, Bridge falls back to the reviewed letters and always logs ARTWORK_C17_PROFILE.
• MediaInfo.albumArt is bound from the toString label , albumArt=. The card spring running flag
  is the boolean both read by cancel and written by start.
• The metadata-changed entry is found from onMetaDataChanged error: metaData is null. Both the
  named onMetaDataChanged(String, MediaMetadata) and the synthetic
  access$onMetaDataChanged(..., Continuation) are accepted. Lyric-cleanup replay invokes only the
  two-argument instance method.

Release build

• Bridge release enables R8: minifyEnabled and shrinkResources are both true. The libxposed
  entry rule is unchanged, and DexKit's JNI classes keep their names. Debug builds are not
  minified.
• The module entry remains META-INF/xposed/java_init.list pointing at the XposedModule
  subclass. If shrinking renames that class, the list is rewritten with it.
• kotlin.coroutines.Continuation keeps its original name. R8 otherwise renames the copy in
  this APK and rewrites the matching Class.getName() literal, while the plugin's flow
  parameter keeps the original name and cover binding fails.

Compatibility and upgrade

Bridge still enters only system and com.android.systemui. It does not enter player processes.

1. Install Bridge 4.5.2 over the previous release. Lyric Providers and the Dynamic Artwork Provider
   do not need a reinstall for this change. Lyric Provider files from this Release are named
   v4.5.2 and keep the v4.5.1 internal versions.
2. Bridge scope remains system and com.android.systemui.
3. Enable one Provider per player. A dedicated Provider and the Universal Provider overwrite each
   other's lyricInfo when both are on.
4. A debug-signed test build cannot replace a release-signed install; uninstall first.

Verification and limits

• A local debug build was confirmed on device: ARTWORK_C17_PROFILE reported
  c17Profile=resolved roles=dexkit cardSpringRoles=dexkit with no letter mismatch, and the
  immersive motion cover reached playback twice. That is not device acceptance of the signed R8
  release.
• getArtWorkIconByMediaMetaData and loadMediaDataInBg are absent on the current SystemUI.
  Bridge still skips them and does not DexKit them.
• Device confirmation of the signed RC remains the gate before the public tag. R8 can change
  reflection and resource shrinking, so a passing debug build does not accept the release APK.
• Compatibility still depends on the vendor SystemUI and on the lyric and position data the player
  exposes through MediaSession.

Assets

The formal Release contains 19 verified assets: 1 Bridge APK, 14 Provider APKs, 1 Dynamic Artwork
Provider APK, 1 Provider ZIP, release-assets-v4.5.2.json, and SHA256SUMS. The Provider ZIP
contains only the 14 top-level lyric Provider APKs. The Dynamic Artwork Provider is separate.

Thanks

Thanks to the user who supplied SystemUI / SystemUIPlugin samples that share a version number but
not their internals, and who checked the motion-cover logs.

ColorOS Live Lyrics Bridge v4.5.1

简体中文

v4.5.1 是动态封面 Provider 的功能更新：动态封面 Provider 升至 1.0.6，新增本地视频导入，并改进
手动搜索与专辑匹配。Bridge 与 14 个歌词 Provider 的功能与 v4.5.0 相同；Bridge 版本号随套件升至
4.5.1，歌词 Provider 的内部版本号不变，仅资产文件名随套件版本更新。从 v4.5.0 可直接覆盖升级。

本地动态封面导入（新）

• 在动态封面 Provider「手动绑定专辑」页的“本地专辑”卡片中，“仅限歌手”下方新增 导入本地视频。
  填写专辑名后按钮才可点按；经系统文件选择器选一个视频，导入后直接绑定到该本地专辑名（可限定歌手）。
• 格式检查：必须是视频，时长 1 秒至 2 分钟（容器时长超出不到 1 秒时截断到 2 分钟），短边不低于
  320 像素；不合格时给出具体原因，如“视频超过 2 分钟，请先剪辑”“本机无法播放这个视频”。
• 分辨率限制与压缩：已是方形、不超过 1080、SDR 8 位 H.264 的视频只复制视频轨，保留原画质；其余
  视频（横竖屏、HEVC、HDR、带旋转、超过 1080、高帧率）居中裁剪为方形，压缩为最高 1080、30 帧的
  H.264，码率参照 Apple Music 封面并控制在 20 MB 以内。音轨一律去除。
• 保存与使用：导入结果经过与锁屏相同的文件校验，按内容哈希保存在应用私有目录，不随缓存清理；
  删除或替换绑定即删除不再使用的文件。锁屏播放到该专辑时直接使用导入的封面，不联网。
• 绑定列表显示视频首帧与“本地”标签。

搜索与匹配改进（Provider）

• 手动搜索改读所选市场的 Apple Music 网页专辑区：iTunes 专辑索引可能整张缺失某专辑（例如 US 的
  Lady Gaga《MAYHEM》），同时仍返回其他艺人的同名专辑，无法从结果判断缺失。非 CN 市场仅在网页为空
  或不可读时改用 iTunes；网页不可读且 iTunes 无结果时报告错误，不显示为“无结果”。
• 同名多版本：同一艺人、同名的多个已核验版本（如《MAYHEM》14 首版与 17 首版）在严格/标准档不替
  用户选择，最近记录标为“多个版本”，点按即列出各版本供绑定；宽松档自动选择（Explicit 优先，其次
  歌曲多的版本，最后目录 ID 较小者），有候选页面未读完时不做选择。
• 符号名称专辑：修复《=》《÷》《-》等纯符号名专辑无法绑定或匹配，以及《÷ (Deluxe)》与
  《- (Deluxe)》互相覆盖绑定、共用缓存的问题；以字母数字开头的专辑名比较方式完全不变。
• 匹配内部重构：商店附加的标签（艺人原生别名、Explicit/Clean、合作艺人、译名括注、发行类型）由各比较
  按需声明，“是否填写”只看原文。名称派生的查询缓存随之升版，已验证的视频与手动绑定保留。

兼容矩阵与升级

Bridge 仍只作用于 system 和 com.android.systemui，不进入播放器进程。

1. 需要新功能时，从 v4.5.1 Release 安装 动态封面 Provider 1.0.6 覆盖 1.0.5；设置、绑定、网易云
   登录与已下载的视频都会保留。
2. 歌词 Provider 与 v4.5.0 相同，已安装的无需重装；Bridge 4.5.1 只有版本号变化，可按需覆盖安装。
3. Bridge 作用域保持 system 与 com.android.systemui。
4. 同一播放器仍只开一个 Provider：专属 Provider 与通用播放器 Provider 二选一，同时开启会互相覆盖
   lyricInfo。

验证与已知限制

• 本地门禁：Provider 825 项测试（testV5Matrix 与动态封面 Provider 269 项单测），14 模块 debug 构建，
  动态封面 Provider release lint 0 errors，两份发布契约与协议镜像校验。
• 本地导入已在 PJZ110 / ColorOS 17 上设备验收：方形 1080 H.264 保留原画质、手机竖拍视频裁剪方向
  正确、HDR 视频颜色正常、超时长提示、取消导入、锁屏显示导入封面、删除绑定后恢复自动匹配。
• 导入的压缩速度与可用格式取决于设备的硬件编解码器；本机无法解码的格式会提示并拒绝。HDR 转 SDR 的
  色调映射只在支持的解码器上生效。压缩过程中旋转屏幕会取消导入。
• 锁屏动态封面本身仍只播放经过校验的方形 AVC/H.264 SDR MP4；HEVC、HDR、竖版与旋转视频需经本地
  导入转换后使用。自动匹配受来源网络、登录状态、专辑信息与页面变化影响。
• 兼容性仍取决于厂商 SystemUI 实现，以及播放器经 MediaSession 暴露的歌词与进度信息。

资产

正式 Release 包含 19 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个动态封面
Provider APK、1 个 Provider ZIP、release-assets-v4.5.1.json 和 SHA256SUMS。Provider ZIP
只包含 14 个顶层歌词 Provider APK，动态封面 Provider 单独提供。

致谢

感谢反馈 US 市场搜索缺失专辑、符号名专辑无法绑定，并提出本地视频导入需求的用户。

English

v4.5.1 is a feature update of the Dynamic Artwork Provider: Dynamic Artwork Provider 1.0.6 adds
local video import and improves manual search and album matching. Bridge and the 14 lyric Providers
behave as in v4.5.0; Bridge moves to 4.5.1 with the suite, the lyric Providers keep their internal
versions, and only their asset file names follow the suite version. Update in place from v4.5.0.

Local motion-cover import (new)

• In the Dynamic Artwork Provider's "Bind albums manually" page, the Local album card has a new
  Import local video button below "Only for this artist". It is enabled once an album name is
  entered; a video picked through the system file picker is bound to that local album name, optionally
  for one artist.
• Format check: it must be a video of 1 second to 2 minutes (a container less than a second over is
  trimmed to 2 minutes) whose shorter side is at least 320 px. A rejected video gets a specific reason,
  such as "longer than 2 minutes, trim it first" or "this device cannot play this video".
• Resolution limit and compression: a square SDR 8-bit H.264 video up to 1080 keeps its original
  picture by copying only its video track. Anything else (landscape or portrait, HEVC, HDR, rotated,
  larger than 1080, high frame rate) is centre-cropped to a square and compressed to H.264 of at most
  1080 and 30 fps, at Apple Music's cover density within 20 MB. Audio is always dropped.
• Storage and use: the result passes the same file check the lock screen runs and is kept privately
  under its content hash, outside the cache, so clearing the cache never removes it; deleting or replacing
  the binding deletes the file once nothing uses it. The lock screen uses the imported cover for that
  album without going online.
• The bindings list shows the video's first frame and a "Local" label.

Search and matching (Provider)

• Manual search reads the selected storefront's Apple Music album shelf: the iTunes album index can
  lack an album outright (Lady Gaga's MAYHEM in the US) while still answering with other artists' albums
  of the same name, so its results cannot reveal the gap. Outside CN, iTunes answers only when the shelf
  is empty or unreadable; an unreadable shelf without iTunes hits is an error, not an empty search.
• Several editions: several verified same-titled editions by one artist (MAYHEM's 14- and 17-song
  releases) are not chosen for you at Strict and Standard; the recent record shows "Several editions" and
  tapping it lists them to bind. Loose picks one (Explicit first, then the most songs, then the earliest
  catalog ID) and does not choose while any candidate page is unread.
• Symbol-named albums: albums named only with symbols, such as "=", "÷" and "-", can be bound and
  matched, and "÷ (Deluxe)" and "- (Deluxe)" no longer replace each other's binding or share a cache
  entry. Names that start with a letter or digit compare exactly as before.
• Matching internals: store labels (native artist alias, Explicit/Clean, guest credit, translated
  annotation, release type) are declared by each comparison, and "is this field filled in" reads the raw
  text. Name-derived query caches are versioned; verified videos and manual bindings are kept.

Compatibility and upgrade

Bridge still runs only in system and com.android.systemui and never enters player processes.

1. For the new features, install Dynamic Artwork Provider 1.0.6 from the v4.5.1 Release over 1.0.5;
   settings, bindings, the NetEase sign-in and downloaded videos are kept.
2. The lyric Providers are the same as in v4.5.0 and need no reinstall; Bridge 4.5.1 only changes its
   version and can be installed over 4.5.0 when convenient.
3. Keep the Bridge scope at system and com.android.systemui.
4. Still enable only one Provider per player: either its dedicated Provider or the Universal Player
   Provider, as both write lyricInfo and overwrite each other.

Validation and known limits

• Local gates: 825 Provider tests (testV5Matrix and 269 Dynamic Artwork Provider unit tests), debug
  builds of all 14 modules, Dynamic Artwork Provider release lint with 0 errors, and validation of both
  release contracts and the protocol mirror.
• Local import passed device acceptance on a PJZ110 / ColorOS 17 device: a square 1080 H.264 video keeps
  its original picture, a portrait phone recording is cropped the right way up, HDR colour is correct,
  an over-long clip is refused, an import can be cancelled, the lock screen shows the imported cover, and
  deleting the binding returns the album to automatic matching.
• Compression speed and supported formats depend on the device's hardware codecs; a format the device
  cannot decode is refused with a message. HDR-to-SDR tone mapping works only on decoders that support
  it. Rotating the screen during compression cancels the import.
• Lock-screen motion covers still play only verified square AVC/H.264 SDR MP4; HEVC, HDR, tall and
  rotated videos need local import to convert them first. Automatic matching depends on source network,
  sign-in state, album metadata and page changes.
• Compatibility still depends on the vendor SystemUI implementation and on the lyric and progress data a
  player exposes through MediaSession.

Assets

The formal Release contains 19 verified assets: 1 Bridge APK, 14 Provider APKs, 1 Dynamic Artwork
Provider APK, 1 Provider ZIP, release-assets-v4.5.1.json, and SHA256SUMS. The Provider ZIP holds
only the 14 top-level lyric Provider APKs; the Dynamic Artwork Provider ships separately.

Acknowledgements

Thanks to the users who reported the missing US search results and the unbindable symbol-named albums,
and who asked for local video import.

Donate

ColorOS Live Lyrics Bridge v4.5.0

简体中文

v4.5.0 把 v4.4.0 之后的各个预览版（C17 Preview、C16 Artwork、C17 Artwork Preview / Preview1 /
Preview2）整合为正式版，并加入锁屏性能优化与动态封面帧率设置。从 v4.4.0 或任一预览版均可直接覆盖升级。

ColorOS 17 适配

• 插件侧 Hook 改从插件 ClassLoader 工厂启动：C17 的插件 ClassLoader 已没有旧构造器入口。
• 沉浸式歌词适配官方行号、缩放中心、歌词模式入口与行模糊（合入 @bakaduang 的 PR #48）；官方字体
  变化后重新测量行高，测量与绘制使用同一字体，C17 歌词行读取与布局解析在缺失时安全降级。
• 酷我：插件歌词模型兼容 C17 的 MediaInfo，同曲媒体卡片重建时保留歌词及歌词支持标记，缓解锁屏
  只剩封面的问题（#46）。
• 翻译按钮改用 C17 的状态刷新入口，暂停时也会刷新；动作位被其他按钮复用后恢复显示。
• 酷狗概念版：放开 C17 对模块管理播放器的 OPlus 歌词声明门禁，锁屏可正常显示歌词。
• 锁屏动作规则：Bridge 重放规则时保留系统原始规则，解锁后恢复原样。
• ColorOS 16 及更早系统的行为不变。

动态封面（可选）

• 新增独立应用 动态封面 Provider 1.0.5：按歌曲信息匹配动态封面，下载并逐文件校验后交给 Bridge
  显示。安装同一 Release 中的 APK，在应用内打开来源，再到 Bridge「设置 → 动态封面」中选择、授权。
  Bridge 本身不联网、不进入播放器进程；不安装时锁屏保持官方静态封面，AOD 始终使用静态封面。
• 显示位置：锁屏歌词小封面、大封面可分别开关；C17 还支持全屏背景，中央画面与上下镜像使用同一
  视频帧，保留系统渐变模糊、歌词模式整体模糊与遮罩。同曲在不同位置间切换时复用同一个解码器。
• 过渡：尊重官方歌词/大封面模式及显隐状态；切歌过渡期间保留官方静态动画，新视频首帧就绪后
  柔和淡入（320 ms）；暂停时从当前画面淡回静态封面（220 ms）；同曲切换页面后等新帧再显现。
• 帧率设置（新）：10–30 fps 可调，默认 30 fps（视频原帧率）。动态封面的耗电主要来自画面刷新——
  每显示一帧视频，锁屏都要整体重绘并重新计算模糊，视频解码本身耗电很少。测试设备在 50% 亮度下，
  30 fps 时锁屏耗电约为静态封面的 3 倍，15 fps 时约 1.6 倍。调低更省电，但视频不够连贯。
• 保持屏幕常亮（可选）：仅在大封面上动态封面实际播放时保持亮屏；暂停、息屏/AOD、解锁或回到
  歌词小封面后释放，与“歌词显示时保持屏幕点亮”各自独立。
• 来源与匹配（Provider）：
  • Apple Music：专辑名优先搜索、身份未确认时补一次歌曲搜索；兼容简繁、艺人原生文字别名、合作
    艺人与 Single/EP 发行类型；保留中文版、现场、Remix、重录等版本边界；CN 市场搜索为空时回退
    同市场网页；Strict / Standard / Loose 三档匹配严格度。
  • 网易云（可选，默认关闭）：官方客户端扫码登录，会话加密保存；按曲目名搜索并核对歌手与录音标记。
  • 两路并发查找、AM 优先下载，AM 最终失败才使用网易云；临时网络故障在总期限内自动补两轮。
  • 原生方形 AVC SDR 视频：AM 1080×1080，网易云最高 1280×1280 原样使用，不缩放、不转码。
• Provider 设置：手动绑定专辑（本地专辑名与商店不一致时）、AM / 网易云独立搜索框与真实封面
  缩略图、市场切换、缓存上限（默认 512 MB，可选到 8 GB 或自定义，按最久未使用清理）、默认仅在
  非计费网络下载、Apple Music 商店连通性测试（新）。
• 诊断：可选的本地脱敏 TXT 日志（约 1 MiB），在“高级”中导出或清除；错误提示区分来源视频读取
  失败、格式不支持、大小超限与锁屏挂载失败。
• 动态封面设置独立保存，并纳入 Bridge 配置备份。

外观与歌词进度

• C17 光晕颜色“跟随封面取色”：复用系统媒体进度条的封面主色，只改变光晕颜色，无需安装动态封面。
• 修复 Unicode 词间空格未被识别、英文单词从中间换行的问题。
• “普通逐行歌词进度”快速切句衔接更稳：高光所属句与播放时间一致，句尾短暂全亮停留，翻译进度与
  字符上浮同步。

锁屏流畅度

使用 Perfetto 在锁屏、卡片切换和 AOD 进出场景逐项排查 Bridge 自身开销：

• 动态封面的显示资格检查不再每帧发起锁屏状态跨进程查询，主线程每帧耗时下降约 15%。
• 翻译按钮查找跳过专辑封面等大图，按图标资源缓存识别结果，消除冷启动和刷新卡片后最长约 200 ms
  的主线程卡顿。
• 字符上浮动画每个字只绘制自身及邻近字形，歌词行绘制耗时下降约 20%；连字（如 "fi"）不再错位。
• 对照测试显示：在没有安装 Bridge 的 ColorOS 17 测试版上，AOD 切换与卡片切换同样会掉帧；这部分
  来自系统本身，Bridge 无法修复。

Provider 更新

全部 14 个歌词 Provider 版本号各加一，动态封面 Provider 升至 1.0.5。

• 13 个专属 Provider 不再在桌面显示图标：请在 LSPosed 模块列表中点开对应 Provider 进入设置。
  覆盖安装更新后，旧桌面图标需重启桌面（启动器）才会消失，属预期行为。通用播放器 Provider 与
  动态封面 Provider 是需要配置的独立应用，仍保留桌面入口。
• 通用播放器 Provider 1.1.2：
  • 修复 ColorOS 17 上的模块加载失败：C17 的 MediaSessionRecord$SessionStub 不再有 this$0，
    旧版会抛 NoSuchFieldException 而对所有播放器无响应；现按名解析并按字段类型兜底。
  • 放开欢太音乐、QQ 音乐、酷狗及概念版、网易云及荣耀版，可在“播放器”页手动选择；目前仅酷我不可选。
  • 同一播放器只开一个 Provider：它的官方/专属 Provider 与通用 Provider 二选一，同时开启时两者
    都会写入 lyricInfo 而互相覆盖。

兼容矩阵与升级

Bridge 仍只作用于 system 和 com.android.systemui，不进入播放器进程。

1. 从同一个 v4.5.0 Release 安装 Bridge 与所需 Provider APK；需要动态封面时一并安装动态封面
   Provider。v4.4.0 与各预览版均可直接覆盖安装，设置与动态封面绑定保留。
2. Bridge 作用域保持 system 与 com.android.systemui。
3. 升级后强行停止播放器并重启 SystemUI；涉及作用域变化时重启手机。
4. 更新专属 Provider 后如仍看到旧桌面图标，重启桌面（启动器）即可。

验证与已知限制

• 本地门禁：Bridge 780 项单测、release lint、debug 构建与发布契约校验；Provider testV5Matrix、
  14 模块 debug 构建，以及动态封面 Provider 单测与构建。
• 正式签名 RC 已在 PJZ110 / ColorOS 17 实机验收通过；性能数据来自同一设备的 Perfetto 与电池计数器，
  其他机型与固件上的数值会有差异。
• ColorOS 17 测试版本身存在锁屏与 AOD 掉帧；C17 的官方歌词时钟对齐路径在部分固件上仍可能未生效，
  沿用时间守卫降级。
• 动态封面只支持经过校验的方形 AVC/H.264 SDR MP4，不支持 HEVC/HDR、竖版或旋转视频；匹配受来源
  网络、登录状态、专辑信息与页面变化影响；缺少资源、歧义或设备解码失败时保留静态封面。部分 C17
  内测设备存在系统媒体解析失败，本版不宣称修复。
• 尚未覆盖 Readify 章节首尾短窗口、酷我 SystemUI 侧封面快照等全部 C17 路径；平板与折叠屏布局验证有限。
• 兼容性仍取决于厂商 SystemUI 实现，以及播放器经 MediaSession 暴露的歌词与进度信息。

资产

正式 Release 包含 19 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个动态封面
Provider APK、1 个 Provider ZIP、release-assets-v4.5.0.json 和 SHA256SUMS。Provider ZIP
只包含 14 个顶层歌词 Provider APK，动态封面 Provider 单独提供。

致谢

感谢 @bakaduang 的沉浸式歌词 PR #48、动态封面跨平台匹配的贡献者，以及提供 C17 实机反馈、诊断
日志与锁屏掉帧线索的用户。

English

v4.5.0 folds every preview since v4.4.0 (C17 Preview, C16 Artwork, C17 Artwork Preview / Preview1 /
Preview2) into a stable release, and adds lock-screen performance work and a motion cover frame-rate
setting. You can update in place from v4.4.0 or any of those previews.

ColorOS 17 support

• Plugin-side hooks start from the plugin ClassLoader factory; C17's plugin ClassLoader no longer has
  the old constructor entry.
• The immersive lyric page follows the official row index, scale pivot, lyric-mode entry, and row blur
  (merging @bakaduang's PR #48). Rows are re-measured when the official typeface changes, measurement
  and drawing share one typeface, and C17 row reading and layout resolution degrade safely.
• KuWo: the plugin lyric model handles C17 MediaInfo, keeping lyrics and the lyric-support flag when the
  same song's media card is rebuilt; this mitigates the cover-only lock screen (#46).
• The translation button refreshes through C17's state-update entry, also while paused, and reappears
  after its action slot was reused by another button.
• KuGou Lite: lifts C17's OPlus lyric-declaration gate for module-managed players so lyrics show.
• Lock-screen action rules: Bridge keeps the system's original rules when replaying them and restores
  them after unlock.
• Behavior on ColorOS 16 and earlier is unchanged.

Dynamic artwork (optional)

• New standalone Dynamic Artwork Provider 1.0.5 matches a motion cover for the song, downloads and
  verifies it file by file, and hands it to Bridge. Install the APK from the same Release, turn a source
  on in the app, then pick and authorize it in Bridge under Settings → Dynamic artwork. Bridge itself
  never goes online or enters a player process; without the Provider the lock screen keeps the official
  static cover, and AOD always uses the static cover.
• Where it shows: the small lyric cover and the large cover can be toggled separately; on C17 it also
  drives the full-screen background, where the center and the mirrored bands use the same video frame
  and keep the system gradient blur, lyric-mode blur, and masks. Moving between surfaces for the same
  song reuses one decoder.
• Transitions: follows the official lyric/large-cover modes and visibility; keeps the official static
  animation during track changes and fades the first new frame in softly (320 ms); pausing fades back
  to the static cover from the current picture (220 ms); a same-song page switch waits for a fresh frame.
• Frame rate (new): adjustable from 10 to 30 fps, default 30 fps (the video's original rate). Most of
  the power goes into showing the video: every frame shown redraws the whole lock screen and recomputes
  its blur, while decoding costs little. On the test device at 50% brightness the lock screen drew about
  3× the power of a static cover at 30 fps and about 1.6× at 15 fps. Lower rates save battery but look
  less fluid.
• Keep screen on (optional): only while a motion cover is actually playing on the large cover;
  released on pause, sleep/AOD, unlock, or returning to the small lyric cover, independent of "Keep
  screen on while lyrics are shown".
• Sources and matching (Provider):
  • Apple Music: album-first search with one song-search fallback when identity is unconfirmed;
    Simplified/Traditional Chinese, native-script artist aliases, featured artists, and Single/EP
    release types; keeps language, live, remix, and re-recording boundaries; falls back to the same
    storefront's web page when CN search is empty; Strict / Standard / Loose matching levels.
  • NetEase (optional, off by default): QR sign-in with the official client and an encrypted session;
    searches by song title and checks artists and recording labels.
  • Both sources are prepared concurrently with AM download priority; NetEase is used only after AM
    fails. Transient network failures get two more attempts within the overall deadline.
  • Native square AVC SDR video: AM 1080×1080; NetEase up to 1280×1280 used as-is, never resized or
    transcoded.
• Provider settings: manual album binding (when local tags differ from the store), separate AM /
  NetEase searches with real cover thumbnails, storefront selection, cache limit (512 MB by default, up to
  8 GB or custom, least-recently-used eviction), unmetered-only downloads by default, and an Apple Music
  storefront reachability test (new).
• Diagnostics: optional local redacted TXT log (about 1 MiB) exported or cleared under Advanced;
  errors distinguish source-video read failures, unsupported formats, size limits, and lock-screen
  mounting failures.
• Dynamic artwork settings are stored separately and included in the Bridge configuration backup.

Appearance and lyric progress

• C17 "Glow color → follow artwork": reuses the system media progress bar's artwork color and only
  changes the glow; no dynamic artwork needed.
• Fixes Unicode word spaces not being recognized, which broke English words mid-word.
• Smoother fast line changes with Line-timed lyric progress: the highlighted line matches playback time,
  line ends hold full brightness briefly, and translation progress stays in step with character float-up.

Lock-screen smoothness

Bridge's own cost was profiled with Perfetto across the lock screen, card switching, and AOD transitions:

• The motion-cover eligibility check no longer makes a cross-process keyguard query on every frame;
  main-thread time per frame dropped by about 15%.
• Translation-button discovery skips large images such as album art and caches results per icon
  resource, removing main-thread stalls of up to about 200 ms after a cold start or card refresh.
• The character float-up animation draws only each glyph and its neighbours, cutting lyric-row draw time
  by about 20%; ligatures such as "fi" are no longer shifted.
• A baseline without Bridge showed that the ColorOS 17 beta drops frames on AOD and card transitions on
  its own; that part comes from the system and cannot be fixed in Bridge.

Provider updates

All 14 lyric Providers move up one version, and the Dynamic Artwork Provider moves to 1.0.5.

• The 13 dedicated Providers no longer show a home-screen icon: open a Provider's settings from the
  LSPosed module list. After an update the old home-screen icon disappears only once the launcher
  restarts; this is expected. The Universal Player Provider and the Dynamic Artwork Provider are
  standalone apps that need configuration and keep their home-screen entry.
• Universal Player Provider 1.1.2:
  • Fixes the module load failure on ColorOS 17: C17's MediaSessionRecord$SessionStub no longer has
    this$0, so older versions threw NoSuchFieldException and answered no player; the field is now
    resolved by name with a type-based fallback.
  • Opens HeyTap Music, QQ Music, KuGou and KuGou Lite, and NetEase Cloud Music and its Honor build for
    manual selection on the Players page; only KuWo stays unavailable.
  • Enable only one Provider per player: use either its official/dedicated Provider or the Universal
    Provider. With both on, each writes lyricInfo and they overwrite each other.

Compatibility and upgrade

Bridge still runs only in system and com.android.systemui and never enters player processes.

1. Install Bridge and the Provider APKs you need from the same v4.5.0 Release; add the Dynamic Artwork
   Provider if you want motion covers. v4.4.0 and every preview update in place; settings and artwork
   bindings are kept.
2. Keep the Bridge scope at system and com.android.systemui.
3. After upgrading, force-stop the player and restart SystemUI; reboot when scopes change.
4. If an old dedicated-Provider icon remains on the home screen after the update, restart the launcher.

Validation and known limits

• Local gates: 780 Bridge unit tests, release lint, debug build, and release-contract validation;
  Provider testV5Matrix, debug builds of all 14 modules, and Dynamic Artwork Provider tests and build.
• The formally signed RC passed device acceptance on a PJZ110 / ColorOS 17 device. Performance figures
  come from Perfetto and the battery counter on that device and vary across devices and firmware.
• The ColorOS 17 beta itself drops frames on the lock screen and AOD; C17's official lyric-clock
  alignment path may still be unresolved on some firmware and falls back to the time guard.
• Motion covers support only verified square AVC/H.264 SDR MP4; no HEVC/HDR, tall, or rotated video.
  Matching depends on source network, sign-in state, album metadata, and page changes; missing assets,
  ambiguity, or a device decode failure keep the static cover. Some C17 beta devices fail system media
  parsing; this release does not claim to fix that.
• Not every C17 path is covered yet (Readify chapter edge windows, KuWo SystemUI-side artwork snapshots);
  tablet and foldable layouts have limited validation.
• Compatibility still depends on the vendor SystemUI implementation and on the lyric and progress data a
  player exposes through MediaSession.

Assets

The formal Release contains 19 verified assets: 1 Bridge APK, 14 Provider APKs, 1 Dynamic Artwork
Provider APK, 1 Provider ZIP, release-assets-v4.5.0.json, and SHA256SUMS. The Provider ZIP holds
only the 14 top-level lyric Provider APKs; the Dynamic Artwork Provider ships separately.

Acknowledgements

Thanks to @bakaduang for the immersive lyric PR #48, to the contributors of cross-platform artwork
matching, and to the users who shared C17 device feedback, diagnostic logs, and lock-screen jank reports.

Donate

ColorOS Live Lyrics Bridge v4.4.0

简体中文

Provider：lyricInfo 只追加，封面与原生一致

• LX、Poweramp、Apple Music、Metrolist、酷狗、网易云、QQ 音乐七个 Provider 不再重建
  MediaMetadata，也不再重绘封面：只把 lyricInfo 这一个键写进播放器自己发布的
  metadata 对象，封面位图、URI、评分、ID、时长和未知字段全部原样交给 SystemUI。
  锁屏与 AOD 看到的封面与关闭模块时完全一致，不会再因为复制 metadata 被压成纯色。
• 写入前后都有 Binder 体积守卫，超限即恢复原值并跳过；个别系统无法访问 metadata
  内部数据时直接放弃附加歌词，不回退到重建。
• KuWo 改用同一套共享实现，行为不变；LX 蓝牙歌词模式下的标题还原也改为原地写入。

酷狗：歌词绑定与显示修复

• 切歌时不再先闪一下官方渲染：酷狗在发布新歌信息前就开始加载、或提前预取的歌词，
  只要文件名、首行「歌名 - 歌手」或与酷狗官方歌词逐行对得上，就立即绑定到新歌。
• 歌词文件名与播放信息不一致的歌曲不再整首回落官方渲染：按酷狗官方歌词的逐行文本与
  时间确认身份。
• 多歌手署名中带连字符的名字（如 知更鸟、HOYO-MiX、Chevy）不再被误拆，媒体卡片
  显示正确的歌名与歌手。
• 歌词开头不再出现一行空白占位：锁屏排版用的 lyric 与 Bridge 绘制的 rawLyric
  改为同一组歌词行，酷狗原始歌词开头的「歌名 - 歌手」行不再显示。

通用播放器 Provider 1.1.0

• 换曲后短时间内出现的「旧标题 + 当前歌手/专辑/时长」撕裂 metadata 会被识别，不会
  误判换曲或挂上旧歌词。
• 新增「进度粒度粗时自动逐行」：USB Audio Player PRO 等只按粗粒度上报进度的播放器，
  自动改用逐行 + 翻译，避免逐字进度抽搐；首页会提示已自动逐行，可在设置中关闭。
• 近期歌词列表会补全 App 未运行期间播放过的歌曲及其最终取词状态。

Bridge：行号时钟对齐

• 官方歌词列表的当前行与 Bridge 的逐字填充改为共用同一个平滑时钟：Bridge 只调整
  SystemUI 歌词列表控制器及其换行定时器收到的播放位置，动画、当前索引、滚动与定时器
  仍全部由 SystemUI 负责。行边界不再回跳，高亮行与逐字填充同时切换，进度上报粗糙的
  播放器改善尤其明显。
• 控制器按方法形状唯一匹配，不依赖混淆名；无法唯一匹配时只保留单调保护，不做对齐。

兼容矩阵与升级

Bridge 仍只作用于 system 和 com.android.systemui，不进入播放器进程。Provider 仍为
14 个 libxposed API 102 模块：

1. 从同一个 v4.4.0 Release 安装 Bridge 与所需 Provider APK。
2. Bridge 作用域保持 system 与 com.android.systemui。
3. 升级后强行停止播放器并重启 SystemUI；涉及作用域变化时重启手机。

验证与已知限制

• 本地门禁：Bridge 单测、debug/release lint、debug 构建与发布契约校验；Provider
  testV5Matrix（529 项单测）、14 模块 debug 构建与 13 个 release 模块的 R8 构建。
• 设备验收在 PJZ110 上完成，覆盖七个只追加 Provider 的封面与歌词、酷狗切歌与
  「希望有羽毛和翅膀」等问题曲目、通用播放器新行为以及 Bridge 行号时钟对齐。
• tag workflow 生成正式签名资产，校验包名/版本、证书、zipalign 与 DEX guards，并将
  Provider main 冻结到完整 commit。
• 酷狗原始歌词开头的「歌名 - 歌手」行不再显示在锁屏歌词中。
• Spotify、汽水音乐、Cone、Salt 仍沿用原有 metadata 复制方式，本版未改动。
• 播放器进度相对实际声音的固定偏差尚未校准。
• 兼容性仍取决于厂商 SystemUI 实现，以及播放器经 MediaSession 暴露的歌词与进度信息。

资产

正式 Release 包含 18 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个 Provider
ZIP、release-assets-v4.4.0.json 和 SHA256SUMS。Provider ZIP 只包含 14 个顶层
Provider APK。

致谢

感谢 Salt Player 提供字符上浮阶跃模型的视觉参考，也感谢 Lyrico 与 Lyrico-Plugins 在
本地音乐元数据、歌词管理和插件化歌词源上的开源工作与启发。

English

Providers: append-only lyricInfo, native artwork

• The LX, Poweramp, Apple Music, Metrolist, KuGou, NetEase, and QQ Music Providers no longer
  rebuild MediaMetadata or redraw artwork. They write the single lyricInfo key into the
  metadata object the player itself published, so artwork bitmaps, URIs, ratings, IDs,
  duration, and unknown fields reach SystemUI untouched. Lock-screen and AOD artwork now
  matches what you see with the module disabled and no longer collapses to a solid color.
• The write is Binder-size guarded and rolled back when oversized. If a system build does not
  expose the metadata's internal data, the Provider skips the lyric instead of falling back to
  a rebuild.
• KuWo moves onto the same shared implementation with unchanged behavior; LX's Bluetooth-lyric
  title restoration is now written in place as well.

KuGou: lyric binding and display fixes

• Switching tracks no longer flashes the official renderer first. Lyrics KuGou starts loading
  just before it publishes the new track, or prefetches during the previous one, bind to the
  new track as soon as their file name, leading "title - artist" line, or line-by-line content
  matches KuGou's own official lyric.
• Tracks whose lyric file name disagrees with the playing metadata no longer fall back to the
  official renderer for the whole song; the Provider confirms them by the official lyric's
  timed lines.
• Hyphenated names inside multi-artist credits (for example 知更鸟、HOYO-MiX、Chevy) are no
  longer split, so the media card shows the correct title and artist.
• The empty placeholder row at the start of the lyrics is gone: the lyric field SystemUI lays
  out and the rawLyric field Bridge draws now carry the same lines, and KuGou's leading
  "title - artist" line is no longer shown.

Universal Player Provider 1.1.0

• Torn metadata that pairs a stale title with the current track's artist, album, and duration
  right after a switch is recognized, so it neither starts a new track nor attaches old lyrics.
• New "Line lyrics for coarse clocks": players such as USB Audio Player PRO that report
  progress coarsely automatically switch to line timing plus translation instead of a jittery
  word fill. The home screen notes the fallback, and it can be turned off in settings.
• The recent-lyrics list fills in tracks played while the app was not running, with their final
  fetch state.

Bridge: line clock alignment

• The official lyric list's current row and Bridge's word fill now share one smooth clock.
  Bridge only adjusts the playback position handed to SystemUI's lyric-list controller and its
  line-switch timer; animation, current index, scrolling, and timers stay with SystemUI. Line
  boundaries no longer jump back, and the highlighted row switches together with the word fill,
  most visibly for players with coarse progress reports.
• The controller is matched uniquely by method shape, not by obfuscated names. When no unique
  match exists, only the monotonic guard remains and no alignment is applied.

Compatibility and upgrade

Bridge still scopes only system and com.android.systemui and never enters player processes.
Providers remain a 14-module libxposed API 102 matrix:

1. Install Bridge and the Provider APKs you need from the same v4.4.0 Release.
2. Keep the Bridge scope at system and com.android.systemui.
3. After upgrading, force-stop the player and restart SystemUI; reboot when scopes change.

Validation and known limits

• Local gates: Bridge unit tests, debug/release lint, debug build, and release-contract
  validation; Provider testV5Matrix (529 unit tests), debug builds of all 14 modules, and R8
  builds of the 13 minified release modules.
• Device acceptance on PJZ110 covered artwork and lyrics for the seven append-only Providers,
  KuGou track switching and previously affected tracks, the new Universal Player behavior, and
  Bridge line clock alignment.
• The tag workflow builds formally signed assets, checks package/version, certificate,
  zipalign, and DEX guards, and freezes Provider main to a full commit.
• KuGou's leading "title - artist" lyric line is no longer shown on the lock screen.
• Spotify, QiShui, Cone, and Salt keep their existing metadata copy path in this release.
• A player's fixed offset between reported progress and actual audio is not calibrated yet.
• Compatibility still depends on the vendor SystemUI implementation and on the lyric and
  progress data a player exposes through MediaSession.

Assets

The formal Release contains 18 verified assets: 1 Bridge APK, 14 Provider APKs, 1 Provider ZIP,
release-assets-v4.4.0.json, and SHA256SUMS. The Provider ZIP contains only the 14 top-level
Provider APKs.

Acknowledgements

Thanks to Salt Player for the visual reference behind the character float-up model, and to
Lyrico and Lyrico-Plugins for their open-source work and inspiration on local music metadata,
lyric management, and pluggable lyric sources.

Donate

ColorOS Live Lyrics Bridge v4.3.2

简体中文

状态栏与控制中心媒体卡片排版彻底根治

• 永不改写 QS 规则表：Bridge 彻底移除对 OPlus QS 规则表（args[1]）的修改，100% 保留系统原生 RUS 策略。无论是 QQ 音乐、网易云、还是通用 Provider 接入的 SaltPlayer、LX 等任意播放器，状态栏下拉控制中心的播放器卡片完全按照播放器原生排版呈现，彻底解决按钮错位、关闭按钮丢失等排版崩溃问题。
• 两类播放器针对性处理：
  • 第一类（原生内置 Rule0，如 QQ 音乐、网易云）：原生主表本就是 Rule0，不碰任何规则表，仅在锁屏时原位把收藏槽替换为翻译按钮（跳过重排，保持列表长度与顺序）。
  • 第二类（无内置 Rule0，如通用 Provider 播放器）：仅在锁屏主表（args[0]）前置 0, 优先级，绝不污染 QS 状态栏。

翻译按钮锁屏态门禁与即时刷新

• 锁屏态门禁：翻译按钮仅在设备处于锁屏状态（Keyguard locked）时激活注入；解锁进入桌面（USER_PRESENT）时，自动平滑撤出注入并恢复原生卡片。真机实测人脸与指纹解锁过渡无任何视觉闪烁、跳变或抽搐。
• 即时刷新修复：修复了此前内部重绑机制将包名误传为 Key 导致 SystemUI 忽略刷新的问题。现在灭屏锁屏或解锁进入桌面瞬间，媒体卡片即时响应并刷新形态，完全无需手动切歌或暂停。
• 延时锁屏保护：在亮屏时核验真实锁屏状态，解决灭屏延时锁定窗口内未上锁直接回桌面导致的卡片残留。

收紧翻译按钮注入门禁与防污染

• 严格歌词门禁：仅在当前播放器确实由歌词 Provider 服务且当前曲目确实包含有效翻译歌词时，才允许展示翻译按钮；未适配播放器或无翻译歌曲严格保持 100% 原生。
• 对象状态恢复：在关闭或撤出按钮时，自动恢复 SystemUI 内存中 MediaAction 的原始图标与回调，彻底消除多卡片对象共享引起的污染。

兼容矩阵与升级

• Bridge 仍只作用于 system 与 com.android.systemui，不进入播放器进程，不恢复私有歌词传输。
• 14 个 Provider 仍为 libxposed API 102 矩阵；KuWo 保持 1.2.0 (3)，其余模块版本不变。
• 升级：从同一个 v4.3.2 Release 安装 Bridge 与所需 Provider APK；更新 Bridge 或变更 scope 后重启 SystemUI。

资产

正式 Release 包含 18 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个 Provider ZIP、release-assets-v4.3.2.json 与 SHA256SUMS。

ColorOS 17 适配计划

ColorOS 17 的 nolog 版本封锁 bootloader，无法解锁并建立模块运行环境，因此本项目不会跟进 nolog 分支的更新与适配；同时主力机型一加 13 也尚未收到 ColorOS 17 nolog 版本，缺少可验证的设备条件。因此 ColorOS 17 适配将在 ColorOS 17 正式版发布之后再启动：届时先在正式版上核对 SystemUI 媒体/歌词实现与权限面差异，再给出 Bridge 与 Provider 的适配版本。在此之前，现有 ColorOS 16 版本继续接收 bug 修复。

致谢

感谢 Salt Player 提供字符上浮跃模态的视觉参考，也感谢 Lyrico 与 Lyrico-Plugins 在本地音乐元数据、歌词管理和插件化歌词源上的开源工作与启发。

English

Complete fix for status bar and Quick Settings media card action layout

• Never mutate the QS rule table: The Bridge completely ceases patching the OPlus Quick Settings action-rule table (args[1]), preserving 100% native RUS rules. Media cards in the notification shade and Quick Settings for QQ Music, NetEase, and universal provider players (SaltPlayer, LX Music, etc.) always adhere strictly to their native action order, eliminating misplaced controls and missing actions.
• Differentiated player classification:
  • Class 1 (Natively Rule0, e.g. QQ Music, NetEase): Left entirely untouched in rule tables; favorite slot replaced in-place without re-ordering the action list.
  • Class 2 (Non-Rule0, e.g. Universal Provider players): Prepends 0, strictly on the main lockscreen surface (args[0]), leaving the QS surface completely pure.

Lockscreen-only gate and instant state rebind

• Lockscreen-only gate: Translation toggle injection is only active while the device is locked (Keyguard locked); unlocking into the launcher (USER_PRESENT) smoothly withdraws the toggle and restores the native card. Verified on physical devices with zero flicker, layout jump, or white-screen artifacts during facial or fingerprint unlock.
• Instant rebind fix: Fixed a bug where the internal rebind passed a package name instead of the composite MediaEntry key, causing SystemUI to ignore state refreshes. Lockscreen and unlock transitions now refresh immediately without requiring a track switch or pause.
• Delay-lock protection: Re-checks actual keyguard lock state on screen-on to prevent stale toggle retention during smart-lock or delay-lock windows.

Tightened translation toggle gate and object contamination prevention

• Strict payload gate: Translation toggles are only permitted when the player is actively managed by a lyric provider and the current song contains verified translation lines. Unadapted players and non-translated tracks remain 100% native.
• Native action restoration: Automatically restores original icon drawables and callbacks on SystemUI MediaAction objects upon withdrawal, preventing cross-surface object sharing pollution.

ColorOS 17 adaptation plan

ColorOS 17 nolog builds lock the bootloader, preventing root and Xposed environments. Therefore, this project will not track or support nolog firmware. Furthermore, our primary test device (OnePlus 13) has not received any C17 nolog builds. Full ColorOS 17 adaptation will begin after the official ColorOS 17 release is publicly available. Until then, the ColorOS 16 codebase will continue to receive maintenance and bug fixes.

Donate

ColorOS Live Lyrics Bridge v4.3.1

简体中文

媒体卡控制按钮错位修复（QQ 音乐）

修复 QQ 音乐媒体卡控制按钮顺序错乱（现场表现为 下一首 / 翻译 / 上一首 / 暂停）。根因是
Bridge 为了让翻译按钮出现在收藏槽，把 QQ 的 OPlus action rule 强制到 Rule0 并重新下发规则表，
SystemUI 因此改用语义动作模板重拼整行；关闭播放器的翻译按钮设置也不能阻止该改写。

v4.3.1 对这类播放器保留系统原生 action row，不再改写规则表：QQ 的按钮顺序恢复，翻译按钮
仍通过收藏槽原地替换呈现（锁屏界面已真机确认）。其它播放器行为不变。

翻译按钮接入：合成动作兜底

对既不暴露 PlaybackState.CustomAction、也没有 OPlus heart 动作的播放器，Bridge 现在会合成
一个与 framework 同类型的 SystemUI MediaAction 注入 Rule0 自定义动作列表，并同步置位
hasCustomAction；按钮点击仍在 Bridge 内处理，不依赖播放器配合。

歌词时钟平滑

播放中媒体会话若重新发布一个略有差异的位置（部分播放器按 400 ms 粒度上报），Bridge 不再
把它当作跳变或回退：小于 600 ms 的正负偏差按本地时钟修正处理，状态切换与大幅跳变仍以宿主
发布值为准，避免歌词前沿被微小抖动带偏。

Provider：KuWo 1.2.0 (3) 只追加 lyricInfo

KuWo Provider 现在只往宿主自己的 MediaMetadata bundle 写入 lyricInfo 一个键：不再重建
metadata、不再改写任何封面通道，并删除了此前的联网补封面与 240px 重绘策略。ColorOS 的封面
取用顺序（loadBitmapFromUri → ART → ALBUM_ART）与 Bitmap 实例完全保持宿主原样。

真机验证（酷我 12.2.0.0）：metadata 由 9 键变为 10 键，ALBUM_ART 保持 360x360
ARGB_8888 varied，SystemUI 正常 NATIVE_LYRIC_RECEIVED，锁屏封面与歌词同时正确。
其余 13 个 Provider 在本版本中不改变行为。

兼容矩阵与升级

• Bridge 仍只作用于 system 与 com.android.systemui，不进入播放器进程，不恢复私有歌词传输。
• 14 个 Provider 仍为 libxposed API 102 矩阵；KuWo 模块版本 1.2.0（versionCode 3），其余模块版本不变。
• 升级：从同一 v4.3.1 Release 安装 Bridge 与所需 Provider APK；更新 Bridge 或变更 scope 后重启
  SystemUI，更新 Provider 后重启对应播放器。

验证与已知限制

• 本地门禁覆盖 Bridge 单测、debug/release lint、debug 构建、发布契约校验与 14-Provider Debug 矩阵。
• tag workflow 生成正式签名资产，校验包名/版本、证书、zipalign 与 DEX guards，将 Provider main
  冻结到完整 commit，并从同一验证批次发布 Bridge 与 LSP mirror。
• 兼容性仍取决于厂商 SystemUI 实现与播放器经 MediaSession 暴露的歌词时间信息。
• 微小时钟修正阈值（600 ms）为固定值；超出该范围的位置变化仍按宿主处理。

资产

正式 Release 包含 18 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个 Provider ZIP、
release-assets-v4.3.1.json 与 SHA256SUMS。Provider ZIP 只包含 14 个顶层 Provider APK。

ColorOS 17 适配计划

ColorOS 17 的 nolog 版本封锁 bootloader，无法解锁并建立模块运行环境，因此本项目不会跟进
nolog 分支的更新与适配；同时主力机型一加 13 也尚未收到 ColorOS 17 nolog 版本，缺少可验证的
设备条件。因此 ColorOS 17 适配将在 ColorOS 17 正式版发布之后再启动：届时先在正式版上核对
SystemUI 媒体/歌词实现与权限面差异，再给出 Bridge 与 Provider 的适配版本。在此之前，现有
ColorOS 16 版本继续接收 bug 修复。

致谢

感谢 Salt Player 提供字符上浮阶跃模型的视觉参考，也感谢 Lyrico 与 Lyrico-Plugins 在本地音乐
元数据、歌词管理和插件化歌词源上的开源工作与启发。

English

Media card control row fix (QQ Music)

Fixes the mis-ordered QQ Music media-card control row (observed as next / translate / previous /
pause). The Bridge used to force the player's OPlus action rule to Rule0 and re-dispatch the rule
table so the translation toggle could occupy the favorite slot; SystemUI then recomposed the whole
row from the semantic-action template, and disabling the player's translation button did not stop
that rewrite.

v4.3.1 keeps the native action row for such players and no longer rewrites the rule table: QQ's
button order is restored while the translation toggle still replaces the favorite slot in place
(confirmed on device in the lockscreen card). Other players are unaffected.

Translation toggle: synthetic action fallback

For players that expose neither a PlaybackState.CustomAction nor an OPlus heart action, the Bridge
now synthesizes a SystemUI MediaAction of the same type the framework uses, injects it into the
Rule0 custom-action list and sets hasCustomAction. The click is handled entirely inside the
Bridge and needs no player cooperation.

Lyric clock smoothing

When a media session re-publishes a slightly different position while playing (some players report
in 400 ms steps), the Bridge no longer treats it as a jump or rewind: deviations below 600 ms are
handled as local clock corrections, while state changes and large jumps stay authoritative.

Provider: KuWo 1.2.0 (3) appends only lyricInfo

The KuWo Provider now writes exactly one key — lyricInfo — into the host's own
MediaMetadata bundle. It no longer rebuilds metadata and no longer touches any artwork lane;
the former network cover completion and 240 px redraw policy were removed. ColorOS's artwork order
(loadBitmapFromUri → ART → ALBUM_ART) and the Bitmap instances stay exactly as the host
published them.

Device validation (KuWo 12.2.0.0): metadata grew from 9 to 10 keys, ALBUM_ART stayed
360x360 ARGB_8888 varied, SystemUI reported NATIVE_LYRIC_RECEIVED and the lockscreen showed the
real cover together with the lyrics. The other 13 Providers are unchanged in this release.

Compatibility and upgrade

• The Bridge still scopes only system and com.android.systemui; it never enters player processes
  and does not restore any private lyric transport.
• All 14 Providers remain on the libxposed API 102 matrix; the KuWo module is 1.2.0 (versionCode 3),
  the other modules keep their versions.
• Upgrade: install the Bridge and the needed Provider APKs from the same v4.3.1 Release; restart
  SystemUI after a Bridge update or scope change, and restart the player after a Provider update.

Validation and known limitations

• Local gates cover Bridge unit tests, debug/release lint, debug build, release contract validation
  and the 14-Provider debug matrix.
• The tag workflow builds the signed assets, verifies package/version, certificate, zipalign and DEX
  guards, freezes the Provider main to a full commit, and publishes the Bridge and LSP mirror from
  the same verified batch.
• Compatibility still depends on the OEM SystemUI implementation and on the lyric timing a player
  exposes through its MediaSession.
• The small-correction threshold (600 ms) is a fixed constant; larger position changes stay
  authoritative.

Assets

The release contains 18 verified assets: one Bridge APK, 14 Provider APKs, one Provider ZIP,
release-assets-v4.3.1.json and SHA256SUMS. The Provider ZIP contains the 14 top-level Provider
APKs only.

ColorOS 17 adaptation plan

ColorOS 17 nolog builds lock the bootloader, so the module runtime environment cannot be unlocked or
set up; this project will therefore not follow the nolog branch. In addition, the primary test device
(OnePlus 13) has not received a ColorOS 17 nolog build, so there is no device to validate against.
ColorOS 17 support will start after the official ColorOS 17 release: we will first compare the
SystemUI media/lyric implementation and permission surface on the official build, then publish
Bridge and Provider updates. Until then the current ColorOS 16 line keeps receiving bug fixes.

Credits

Thanks to Salt Player for the visual reference of the character lift step model, and to Lyrico and
Lyrico-Plugins for their open-source work on local music metadata, lyric management and pluggable
lyric sources.

Donate

ColorOS Live Lyrics Bridge v4.3.0

简体中文

字符上浮动画

v4.3.0 为 ColorOS / OPlus 原生歌词界面新增可选的 Salt Player 式字符上浮动画。未唱
字素会停在正常基线下方，既有揭示前沿经过时沿升余弦阶跃回到基线，已唱文本则保持在
基线。它与当前的 clip-reveal、羽化和 glow 共用同一个时钟，不会引入第二条歌词进度线。

• 默认关闭；低帧率 AOD 路径会自动关闭该效果。
• “字符浮动幅度”可调 0–200%；100% 时下沉约为歌词字号的 10%，且只在动画开启时显示。
• 行激活时有 240 ms 下沉窗口；逐字行结束时有 240 ms 收尾窗口，使稳定状态回到同一基线。
• 开启“普通逐行歌词进度”后，普通 LRC 行时间戳歌词也会以整行线性前沿驱动上浮，无需
  新歌词 payload 或时间格式。

渲染可靠性

换行多段行现在通过累加每段已揭示 advance 计算整行上浮前沿，修复此前前沿钉在首段末端、
只在末段可见动画的问题。可选 lift 路径保持隔离：运行时绘制异常会回退到既有整段绘制并
记录 CHAR_LIFT_UNAVAILABLE，不会让 SystemUI coordinator 拉黑歌词绑定。

设备验收覆盖逐字歌词（包含换行多段行）和已开启进度的普通逐行歌词。普通逐行最后约
1.5 个字宽会在行切换前留在过渡窗口内，由既有行切换动画吸收；提前改写映射会让上浮与
羽化前沿失步，因此保留这一已接受的行为。

架构、兼容性与升级

Bridge 仍只作用于 system 和 com.android.systemui。Provider 继续从各自 scope 内发布
标准 MediaMetadata["lyricInfo"]；本版本不恢复播放器进程 Bridge Hook 或私有歌词传输。

Provider 源码仍为 14 模块的 libxposed API 102 矩阵：12 个专属 Provider、通用播放器
Provider 与 Readify TTS Provider。v4.3.0 不改变 Provider 的业务行为，但会同步推进
规范 Provider 资产文件名与发布契约。

1. 从同一 v4.3.0 Release 安装 Bridge 与所需 Provider APK。
2. Bridge scope 只保留 system 和 com.android.systemui。
3. 开启“字符上浮动画”；普通 LRC 歌词还需开启“普通逐行歌词进度”。
4. 升级或变更 scope 后重启播放器与 SystemUI。

验证与已知限制

• 本地发布门禁覆盖 Bridge 单测、debug/release lint、debug 构建、发布契约校验以及
  14-Provider Debug 矩阵。
• tag workflow 生成正式签名资产，校验包名/版本、证书、zipalign 与 DEX guards，将
  Provider main 冻结到完整 commit，并从同一验证批次发布 Bridge 与 LSP mirror。
• 低帧率 AOD 下动画有意关闭。拖长音缓慢推进时仍可能有极轻微的像素阶跃感，已在设备上
  验收并接受。
• 兼容性仍取决于厂商 SystemUI 实现，以及播放器经 MediaSession 暴露的歌词时间信息。

资产

正式 Release 包含 18 项已验证资产：1 个 Bridge APK、14 个 Provider APK、1 个 Provider
ZIP、release-assets-v4.3.0.json 和 SHA256SUMS。Provider ZIP 只包含 14 个顶层
Provider APK。

致谢

感谢 Salt Player 提供字符上浮阶跃模型的视觉参考，也感谢 Lyrico 与 Lyrico-Plugins 在
本地音乐元数据、歌词管理和插件化歌词源上的开源工作与启发。

English

Character float-up

v4.3.0 adds an optional Salt Player-style character float-up effect to the native
ColorOS / OPlus lyric surface. Unsung graphemes rest below the normal baseline and
rise back along a cosine step as the existing reveal front reaches them; sung text
then remains at the baseline. It follows the same clip-reveal, feather, and glow
timing already used by the renderer rather than introducing a second lyric clock.

• The effect is off by default and automatically disabled on the low-frame-rate
  always-on display path.
• Character float amount is available from 0–200%; 100% is a sink of about
  10% of the lyric text size, and the control appears only while the effect is on.
• It uses a 240 ms sink-in at line activation and a 240 ms finish window so a
  completed word-timed row returns to one stable baseline.
• With Line-timed lyric progress enabled, ordinary LRC-style line-timed lyrics
  use the same float-up front across the whole line. No new lyric payload or timing
  format is required.

Rendering reliability

Wrapped lines now resolve their float-up front by summing each segment's revealed
advance. This fixes the former first-segment pinning that could leave animation
visible only on a trailing wrapped segment. The optional lift path remains isolated:
if a runtime draw error occurs, it falls back to the existing whole-segment draw and
records a CHAR_LIFT_UNAVAILABLE warning instead of allowing SystemUI's coordinator
to blacklist the lyric binding.

Device validation covered word-timed lyrics, including wrapped multi-segment lines,
and line-timed lyrics with progress enabled. The accepted visual behavior keeps the
final roughly 1.5 glyph widths in their transition window until an ordinary
line-to-line handoff; changing that mapping would desynchronize lift from the
feathered reveal front.

Architecture, compatibility, and upgrade

Bridge remains scoped only to system and com.android.systemui. Providers continue
to publish standard MediaMetadata["lyricInfo"] from their own scoped processes; this
release does not restore a player-process Bridge hook or a private lyric transport.

The Provider source remains the 14-module libxposed API 102 matrix: 12 dedicated
providers, Universal Player Provider, and Readify TTS Provider. Provider business
behavior is unchanged in v4.3.0; the canonical Provider asset names and release
contract advance together with Bridge.

1. Install the Bridge and any required Provider APKs from the same v4.3.0 release.
2. Keep Bridge scope limited to system and com.android.systemui.
3. Enable Character lift animation to use the new effect. For ordinary LRC
   lyrics, also enable Line-timed lyric progress.
4. Restart the player and SystemUI after upgrading or changing scope.

Validation and known limits

• Local release gates cover Bridge unit tests, debug/release lint, debug assembly,
  release-contract validation, and the 14-Provider debug matrix.
• The tag workflow produces the formal signed assets, validates package/version,
  certificate, zipalign, and DEX guards, freezes Provider main to a full commit,
  and publishes the Bridge and LSP mirror from the same verified batch.
• The effect is intentionally disabled in low-frame-rate AOD mode. Slowly advancing
  sustained syllables can still have a very slight pixel-step character that is
  inherent to raster frames; it was evaluated on device and accepted.
• Compatibility still depends on the vendor SystemUI implementation and the lyric
  timing that the selected player exposes through its MediaSession.

Assets

The formal release contains 18 verified assets: one Bridge APK, 14 Provider APKs,
one Provider ZIP, release-assets-v4.3.0.json, and SHA256SUMS. The Provider ZIP
contains only the 14 top-level Provider APKs.

Acknowledgements

Thanks to Salt Player for the visual reference behind the float-up step model, and
to Lyrico and Lyrico-Plugins for their open-source work and inspiration around local
music metadata, lyric management, and plugin-based lyric sources.

Donate

ColorOS Live Lyrics Bridge v4.2.1

Readify TTS Provider / Readify TTS Provider

4.2.1 将 io.github.andrealtb.coloroslyrics.provider.readify 纳入正式 Provider
矩阵。它面向 Readify AI 3.1.0 的 com.readin.app，通过宿主已有 MediaSession
发布事件驱动的句子窗口；Bridge 保持只运行于 system 和
com.android.systemui。

All 14 Provider modules use libxposed API 102 with static scope and protective exception handling.

• sentence-window-v1 使用当前句索引保持高亮，避免 TTS 在未知时长时提前滚动。
• 最多五句的窗口可完整展示长文本，未伪造音频时间轴、播放状态或额外 MediaSession。
• Provider 仅读取宿主已预取的 Chunk AI/Readium 缓存，不推进朗读器或发起额外合成请求。
• Readify 继续严格锁定宿主 3.1.0；未知版本不发布歌词。正式 APK 的最终真机安装验证仍待补充。

发布与升级

1. 安装同一 v4.2.1 Release 中的 Bridge 与所需 Provider APK。
2. Readify Provider 仅在 LSPosed 中勾选 com.readin.app；Bridge scope 只保留 system
   与 com.android.systemui。
3. 不要同时启用历史测试包 de.sqlsec.readifylyrics 与正式 Readify Provider。
4. 更新后重启 Readify、SystemUI；首次安装或 scope 变更后按设备需要重启。

Release validation

• Provider matrix now contains 14 API 102 modules: 12 dedicated providers, Universal Player, and Readify.
• The tag workflow validates 14 Provider APKs, 15 APKs total, and 18 release assets, including
  package/version metadata, certificate, zipalign, DEX guards, Provider ZIP, manifest, and SHA256SUMS.
• The workflow resolves Providers main to a full commit SHA before build; the release manifest
  records that SHA and later stages use only the frozen commit.

Assets

The formal Release contains 18 assets: 1 Bridge APK, 14 Provider APKs, 1 Provider ZIP,
release-assets-v4.2.1.json, and SHA256SUMS. The Provider ZIP contains 14 top-level APKs only.

Donate

ColorOS Live Lyrics Bridge v4.2.0

通用播放器 Provider / Universal Player Provider

4.2.0 新增 Universal Player Provider 1.0.0 (1)。全部 Provider 继续使用 libxposed API 102。
它在 system_server 观察用户在设置
App 中明确选中的 MediaSession 播放器，并将已解析歌词安全附加到该播放器的原生 metadata；
Bridge 仍只运行于 system 和 com.android.systemui，不会进入任意播放器进程，也不会接收
旧版私有歌词 transport。

• Bridge 新增受限的通用 Provider 绑定同步：仅接受固定 action 与受控绑定集合，变更后重建
  SystemUI 侧兼容策略，不扩大 Bridge scope。
• 通用 Provider 仅处理用户选中的包；未选择的音乐、视频或其他 MediaSession 不会被注入。
• Provider 设置 App 支持播放器选择、来源优先级、缓存、手动匹配及诊断；正式版本为
  1.0.0 (1)。
• 12 个既有专属 Provider 保持其既有内部版本与实现；本次套件新增第 13 个 APK。

使用、升级与限制

1. 安装同一 4.2.0 Release 的 Bridge 和需要的 Provider。
2. 专属 Provider 继续只在 LSPosed 中勾选其对应播放器；通用 Provider 仅保留 system
   scope，并在它自己的设置 App 内选择目标播放器。
3. 使用通用 Provider 时，关闭播放器的蓝牙歌词、车载歌词或其他会用当前歌词覆写媒体标题的
   功能。两者同时启用时，首曲识别、缓存命中和切歌判定可能不可靠。
4. 更新模块、修改 scope 或绑定列表后，重启 SystemUI 与目标播放器。回滚请使用已发布的
   4.1.1 Bridge 与配套 Provider APK；Android 可能要求显式允许降级安装。

发布验证

• Provider 契约现在精确列出 13 个 API 102 模块，并把通用 Provider 的 system_server
  静态 scope、applicationId、入口、版本和正式资产名称纳入校验。
• CI、收集脚本、Bridge 跨仓库契约、签名/zipalign/包元数据校验及 Provider ZIP 均升级为
  13 个 Provider APK；最终 Release 为 14 个 APK、17 项资产。
• 最终 tag workflow 会重新执行 Bridge unit tests/lint、Provider matrix tests、正式签名
  release/R8 构建、DEX 禁用字符串检查、SHA-256 清单和 Bridge/LSP 双 Release 发布。
• 通用 Provider 的已知蓝牙/车载歌词边界及当前真机回归状态见 Provider 仓库的
  docs/4.1/UNIVERSAL-PROVIDER-*.zh-CN.md；未列为本次发布阻断项的场景不应表述为已完成
  真机验收。

资产

正式 Release 恰好包含 17 项：1 个 Bridge APK、13 个 Provider APK、1 个 Provider ZIP、
release-assets-v4.2.0.json 和 SHA256SUMS。Provider ZIP 只是顶层 APK 下载合集，不是
Recovery 刷机包。

Universal Player Provider

4.2.0 adds Universal Player Provider 1.0.0 (1). It observes only the MediaSession players that
the user selects in its settings app, enriches their native metadata from system_server, and
leaves Bridge scoped to system and com.android.systemui. No player-process Bridge hook or
legacy private lyric transport is restored.

• Binding updates are limited to the fixed Universal Provider action and a controlled package set.
• Unselected music, video, and other MediaSession apps are not injected.
• The existing 12 dedicated Providers retain their implementation and internal versions; this suite
  adds a thirteenth Provider APK.

Install matching 4.2.0 assets. Keep dedicated Providers scoped to their matching player; keep the
Universal Provider scoped only to system and select target players in its app. Disable Bluetooth,
car-lyrics, or similar features that overwrite media titles while using Universal Provider. Restart
SystemUI and the target player after an update, scope change, or binding change.

The signed workflow validates 13 Provider APKs, 14 APKs total, and 17 release assets, including
package/version metadata, certificate, zipalign, DEX guards, the Provider ZIP, and SHA-256 sums.
Device scenarios not marked complete in the Universal Provider regression matrix remain pending.

Donate

ColorOS Live Lyrics Bridge v4.1.1

中文

4.1.1 是 4.1 系列的 Bridge 修复版。Bridge 仍只运行在 system 和
com.android.systemui，播放器歌词仍由播放器自己的 MediaSession 及独立 Provider
发布；本版没有改变 Provider 版本或私有播放器 Hook。

翻译按钮与 OPlus 媒体卡片

• 修复翻译动作在同一个 OPlus 媒体模型重复重建时丢失原始动作身份的问题。
• 翻译按钮关闭、歌词明确没有翻译，或切歌处于暂态空窗时，分别执行安全撤销或保留未知状态，恢复播放器原生动作及顺序。
• 修复设置重应用路径遗漏“用户关闭翻译按钮”的门禁，并在设置或歌词模型变化后请求媒体动作重新绑定。
• 普通媒体卡片和下拉控制中心的 OPlus action-rule 表同时更新，避免两个界面命中不同规则。
• MD3Music 的 com.md3music.md3music 加入已验证的 OPlus media-history / translation 兼容名单；有翻译时接管桌面歌词动作，保留收藏动作，无翻译时恢复桌面歌词。
• 翻译动作的语义图标仍要求资源型 Icon，避免 SystemUI 对 bitmap、URI 或 data 图标调用不兼容接口。

架构与兼容范围

• Bridge 继续只消费播放器 MediaSession 的标准 lyricInfo，不进入播放器进程，也不恢复旧的私有歌词传输。
• 4.1.1 复用已验证的 12 个 Provider 源码并建立发布标签 providers-v1.1.1；Provider 包名、作用域和内部版本保持不变。
• Bridge APK 的作用域仍为 system、com.android.systemui；不需要为 MD3Music 增加 Bridge 的播放器进程作用域。
• ColorOS 锁屏歌词和 OPlus 媒体卡片属于厂商私有实现，系统或播放器升级后仍可能需要重新验证。

升级与回滚

1. 在支持 libxposed API 102 的 LSPosed 环境中安装 ColorOS-Live-Lyrics-Bridge-v4.1.1.apk。
2. 保持 Bridge 只勾选 system 与 com.android.systemui，并重启 SystemUI；翻译动作设置变化后重启对应播放器。
3. 使用 4.1.1 Release 中的 Provider APK；本版 Provider 源码只变更发布契约，标签为 providers-v1.1.1，内部版本沿用 1.1.0。
4. 如需回滚，使用已发布的 4.1.0 Bridge 与对应 Provider；Android 可能要求显式允许版本降级。

验证

• Bridge 本地 testDebugUnitTest：510 项通过，6 项明确跳过，0 failure/error。
• Debug APK 的 API 102 元数据、作用域、DEX 修复标记、v2 签名和 zipalign 已通过本地检查。
• 用户已完成本次翻译按钮回归：按钮接管、关闭/恢复和控制中心显示通过。
• 正式 tag workflow 重新执行 release lint、签名 release 构建、Provider 矩阵构建、13 APK 校验、16 项资产打包和 SHA-256 复核。

发布资产

正式 Release 恰好包含 16 项：1 个 Bridge APK、12 个 Provider APK、1 个 Provider ZIP、
release-assets-v4.1.1.json 和 SHA256SUMS。Provider ZIP 只是 APK 下载合集，不是 Recovery
刷机包。

感谢所有提供播放器样本、ColorOS SystemUI 证据、日志和实机回归结果的贡献者。

English

4.1.1 is a Bridge maintenance release for the 4.1 line. Bridge remains limited to system and
com.android.systemui; player lyrics still come from player-owned MediaSessions and independent
Providers. Provider versions and private player hooks are unchanged.

Translation actions and OPlus media cards

• Preserve the original action identity when an OPlus media model is rebound repeatedly.
• Safely undo a translation takeover when the button is disabled or a track is known to have no
  translation, while leaving a transient track-change gap unresolved until the next model arrives.
• Apply the user-disabled button gate during settings reapplication and request a media-action rebind
  after settings or lyric-model changes.
• Update both the regular media-card and Quick Settings OPlus action-rule tables so they select the
  same Rule0 policy.
• Add com.md3music.md3music to the device-validated OPlus media-history/translation compatibility
  policy. With translations, Bridge takes over the desktop-lyrics action and keeps favorite; without
  translations, it restores desktop lyrics.
• Keep resource-backed semantic icons as the only safe icon type for this SystemUI path.

Architecture and compatibility

• Bridge consumes standard lyricInfo from player MediaSessions and never enters player processes or
  restores the retired private lyric transport.
• The release uses the validated Provider source with the metadata-only tag providers-v1.1.1; Provider package IDs,
  scopes, and internal versions remain unchanged.
• Bridge scope remains exactly system and com.android.systemui.
• ColorOS lock-screen lyrics and OPlus media cards are private vendor surfaces and may require renewed
  validation after system or player updates.

Upgrade and rollback

1. Install ColorOS-Live-Lyrics-Bridge-v4.1.1.apk in an LSPosed environment supporting libxposed API 102.
2. Keep only system and com.android.systemui selected for Bridge and restart SystemUI; restart the affected player after translation-action setting changes.
3. Use the Provider APKs from the same 4.1.1 Release; their source tag is providers-v1.1.1 and internal versions remain 1.1.0.
4. Roll back with the published 4.1.0 Bridge and matching Providers if needed; Android may require an explicit downgrade install method.

Validation

• Local Bridge testDebugUnitTest: 510 passed, 6 explicitly skipped, 0 failures/errors.
• The debug APK passed local API 102 metadata, scope, DEX-marker, v2-signature, and zipalign checks.
• The user confirmed the translation-action takeover, disable/restore path, and Quick Settings display.
• The formal tag workflow reruns release lint, signed release builds, the Provider matrix, 13-APK checks, 16-asset packaging, and SHA-256 verification.

Release assets

The formal Release contains exactly 16 files: one Bridge APK, 12 Provider APKs, one Provider ZIP,
release-assets-v4.1.1.json, and SHA256SUMS. The Provider ZIP is an APK download bundle, not a
Recovery package.

Thanks to everyone who supplied player samples, ColorOS SystemUI evidence, logs, and device
regression results.

Donate

ColorOS Live Lyrics Bridge v4.1.0

中文

4.1 是一次稳定性与现代 LSPosed API 升级。Bridge 继续只运行于 system 和
com.android.systemui，播放器专属逻辑仍由 12 个独立 Provider 在播放器自己的
MediaSession 中发布标准 MediaMetadata["lyricInfo"]。本版把全部 Provider 统一迁移到
libxposed API 102，并集中修复 4.0 实机回归、完整代码审查以及歌词/封面边界问题。

12 Provider 全量 API 102 迁移

• Salt、Cone、酷我、LX、Poweramp、Metrolist、酷狗、QQ、网易云、Apple、Spotify 与汽水
  全部改用唯一的 XposedModule 入口和 META-INF/xposed 现代资源。
• 12 个 Provider 均声明 minApiVersion=102、targetApiVersion=102、静态作用域、
  exceptionMode=protective，并明确关闭 Hot Reload。
• 移除旧 Hook 入口、旧共享偏好和兼容层；Debug 配置切换到 libxposed Remote Preferences，
  默认仍关闭，开启或关闭后需要完全重启目标播放器进程。
• 每个 Provider 的 package/process/profile、歌词获取、曲目 generation、翻译 lane、封面、
  PlaybackState 与 action 所有权保持 4.0 已验证语义。
• 全部 Provider 内部版本统一提升到 1.1.0：Salt versionCode=6，其余 11 个
  versionCode=2，可覆盖安装正式 4.0 Provider。

Bridge 稳定性与歌词修复

• 收紧 SystemUI 主进程路由，修复 MediaController 回调在控制器切换后的注册/注销与事件代际，
  避免旧控制器或旧歌词结果污染当前曲目。
• 歌词发布新增本地 epoch 与曲目身份门禁；稳定 track key 优先，缺少身份的 payload 不再跨曲
  复用任意旧歌词。
• 修复酷狗冷启动首曲身份和时间轴事务：fallback key、mediaId、songId 的同曲补全不再制造
  新 generation；宿主官方 lyric 时间倒退时改用同批 KRC 生成的单调时间轴，完整保留制作
  人员 credit，避免《回家的路》第一句在冷启动时丢失。QQ 音乐正常首句行为保持不变。
• 统一识别普通空格、NBSP 与 Unicode 空白占位，防止空白行被误判为翻译。
• 官方歌词自绘失败时立即回退宿主绘制，并确保 Canvas 状态始终恢复，避免单帧空白或后续绘制
  污染。
• 修复 OPlus 媒体 action 图标在旧 Android API 上的类型读取风险；只有图标反射写入并回读成功
  时才替换/提升翻译 action。
• 完成反射/Class 缓存、插件 Hook 生命周期、负速率回绕以及设置颜色对话框键盘与无障碍行为的
  稳定性收口。
• 结构化日志不再记录完整歌词、稳定 media ID、URL query 或私人路径，诊断只保留计数、类型与
  脱敏 hash。

酷我首曲封面

• 酷我 Provider 在播放器首次歌词早于宿主 metadata 到达时保持当前 MediaSession，避免首曲错过
  立即发布窗口。
• 对酷我官方封面主机使用 HTTPS、无重定向、有限超时/大小/分辨率的封面补全；结果严格绑定
  track identity 与 generation，切歌后的旧结果会被丢弃。
• 修复首次打开酷我时首曲封面降级为纯色、后续切歌却正常的问题；后续宿主原生 bitmap 仍优先。

Provider 支持矩阵 / Provider matrix

从 4.0 升级

1. 需要支持 libxposed API 102 的 LSPosed/LSP 环境；建议使用 LSPosed 2.2.0 或更新版本。
2. 使用正式 ColorOS-Live-Lyrics-Bridge-v4.1.0.apk 覆盖安装 4.0.0，Bridge 作用域仍只保留
   system 与 com.android.systemui。
3. 使用同一 4.1.0 Release 中自己需要的 Provider APK 覆盖 4.0 Provider，并保持每个 Provider
   只勾选对应播放器。
4. Provider Debug 已迁移到 Remote Preferences，升级后会按默认关闭处理；需要日志时重新打开
   Debug，并完全停止后重启播放器。
5. 本版不支持 Hot Reload。更新 Provider、修改作用域或切换 Debug 后必须重启目标进程；首次
   升级建议重启设备。
6. 不要让旧词幕 Provider 与当前 Provider 同时 Hook 同一播放器。

需要回滚时可重新安装 4.0.0 正式 Bridge 与对应 Provider。Provider applicationId 和正式签名
保持不变；若 Android 阻止降版本，需要使用允许版本降级的安装方式。Bridge 设置 schema 未
变更，但仍建议升级前导出完整配置备份。

验证

• 12/12 Provider 已完成 API 102 资源、入口、scope、依赖、Remote Preferences、legacy 字符串、
  单元测试和 Debug 全矩阵门禁；488 tests，0 failure/error/skip，生成恰好 12 个 Debug APK。
• Wave A–E 覆盖全部 12 个 Provider 及多宿主/profile 的用户真机回归；网易云 9.0.40 构造
  profile 按其特殊安装前提验收。
• 本次 Bridge 审查修复通过 503 tests（0 failure/error，6 项明确 skipped）、debug/release
  lint（0 error）与 Debug 构建门禁；酷狗首句、酷我首曲封面和 OPlus 媒体 action 崩溃路径
  均由用户实机确认。
• 正式签名 RC/GA 流水线会重新构建 13 个 APK，并校验 R8、包名、内部版本、API 102 资源、
  scope、证书、zipalign、DEX 禁用字符串、16 项资产与 SHA-256。

已知限制

• ColorOS 锁屏歌词属于私有 SystemUI 功能，系统更新后可能需要重新适配。
• 播放器私有歌词接口可能随播放器更新变化。
• Spotify 与 Metrolist 当前不提供翻译；QQ 音乐 HD 不在支持矩阵。
• 歌词源没有逐字或翻译 lane 时，Bridge 不会凭空生成。
• 4.1 Provider 要求 libxposed API 102；不提供旧 Hook API 回退或 Hot Reload。

本项目不分发词幕 Provider。需要词幕时请前往
LyricProvider 原项目，词幕显示或产品问题也请
向原项目反馈。

开发文档、致谢与支持

• 播放器主动发布 lyricInfo 协议
• Provider 适配技术指南

感谢 tomakino/LyricProvider 原项目及贡献者、Accompanist Lyrics Core，以及提供播放器样本、
SystemUI 证据、日志、录屏和实机验证的所有用户。第三方来源与许可证保留在 Bridge
LICENSE、Provider NOTICE、源码头和迁移报告中。

如果项目对你有帮助，可在
Bridge README 查看支持方式。
支持完全自愿，不影响 Issue 优先级或 Release 资产获取。

English

4.1 is a stability and modern LSPosed API release. Bridge remains limited to system and
com.android.systemui; player-specific code still lives in 12 independent Providers that publish
standard MediaMetadata["lyricInfo"] through player-owned MediaSessions. This release migrates the
entire Provider matrix to libxposed API 102 and closes the 4.0 device regressions, full code-review
findings, and lyric/artwork edge cases.

Complete 12-Provider API 102 migration

• Salt, Cone, KuWo, LX, Poweramp, Metrolist, KuGou, QQ, NetEase, Apple, Spotify, and QiShui now use
  a single XposedModule entry and modern META-INF/xposed resources.
• Every Provider declares API 102 as both minimum and target, static scope, protective exception
  mode, and explicitly disabled Hot Reload.
• Legacy hook entries, preferences, and compatibility layers were removed. Debug configuration now
  uses libxposed Remote Preferences, remains off by default, and takes effect after a full player
  process restart.
• Existing package/process profiles, lyric acquisition, track generation, translation lanes,
  artwork, PlaybackState, and action ownership preserve the device-validated 4.0 behavior.
• All Provider internal versions move to 1.1.0: Salt uses versionCode=6; the other 11 use
  versionCode=2, allowing in-place upgrades from the official 4.0 packages.

Bridge stability and lyric fixes

• Tightened the SystemUI main-process route and repaired MediaController callback registration,
  teardown, and event epochs across controller changes.
• Added local publication epochs and track-identity gates. Stable track keys are authoritative, and
  identity-free payloads can no longer retain arbitrary lyrics across tracks.
• Fixed KuGou cold-start identity and timeline transactions. Enriching the same track from a
  fallback key to mediaId/songId no longer advances generation; a non-monotonic official lyric
  is replaced by a monotonic timeline generated from the same KRC while retaining every production
  credit. This prevents the first real line from disappearing and preserves the correct QQ path.
• Unified normal spaces, NBSP, and Unicode whitespace placeholder handling.
• Renderer failures immediately fall back to host drawing and always restore Canvas state.
• Removed the old-API OPlus media-action icon type risk; translation action replacement/promotion
  now requires successful semantic icon writeback and readback.
• Closed reflection/cache, plugin-hook lifecycle, negative rewind, settings keyboard, and
  accessibility issues.
• Structured diagnostics no longer expose full lyrics, stable media IDs, URL queries, or private
  local paths.

First-track KuWo artwork

• KuWo keeps the current MediaSession when lyrics arrive before the first host metadata update, so
  the first-track publication window is not lost.
• Official KuWo artwork hosts are fetched over HTTPS with no redirects and bounded timeout, size,
  and dimensions. Completion is tied to track identity and generation; stale results are dropped.
• This fixes the first KuWo track degrading to a solid color while later track changes work. A
  later host-provided bitmap still has priority.

The single bilingual Provider matrix above is shared by both language sections.

Upgrade from 4.0

1. Use an LSPosed/LSP environment that supports libxposed API 102; LSPosed 2.2.0 or newer is
   recommended.
2. Install the official ColorOS-Live-Lyrics-Bridge-v4.1.0.apk over 4.0.0 and keep Bridge scope
   limited to system and com.android.systemui.
3. Install the matching Provider APKs from the same 4.1.0 Release over their 4.0 versions, keeping
   each Provider scoped only to its player.
4. Provider Debug moved to Remote Preferences and starts from the disabled default after upgrade.
   Re-enable it when logs are needed, then fully restart the player.
5. Hot Reload is not supported. Restart the target process after Provider, scope, or Debug changes;
   a device reboot is recommended for the first upgrade.
6. Never let an old Lyricon Provider and the current Provider hook the same player simultaneously.

Rollback uses the official 4.0.0 Bridge and Provider packages. Application IDs and release signing
remain unchanged; Android may require an install method that explicitly permits version downgrade.
The Bridge settings schema is unchanged, but exporting a complete backup before upgrade is still
recommended.

Validation

• All 12 Providers passed API 102 resource, entry, scope, dependency, Remote Preferences, legacy
  string, unit-test, and debug-matrix gates: 488 tests with no failures, errors, or skips, and exactly
  12 debug APKs.
• User-run Wave A–E device regression covered all Providers and multi-host/process profiles;
  NetEase 9.0.40 was accepted under its documented special installation prerequisite.
• The Bridge review fixes passed 503 tests (no failures/errors, six explicit skips), debug/release
  lint with no errors, and the debug build gate. The KuGou first line, first-track KuWo artwork, and
  OPlus media-action crash paths were confirmed on device by the user.
• The signed RC/GA workflow rebuilds all 13 APKs and verifies R8, package IDs, internal versions,
  API 102 resources, scopes, certificate, zipalign, forbidden DEX strings, 16 assets, and SHA-256.

Known limits

• ColorOS lock-screen lyrics are a private SystemUI feature and may require renewed compatibility
  work after system updates.
• Player-private lyric APIs can change after player updates.
• Spotify and Metrolist currently have no translations; QQ Music HD is outside the matrix.
• Bridge cannot invent word timing or translations absent from the source.
• 4.1 Providers require libxposed API 102; there is no legacy hook fallback or Hot Reload support.

This project does not distribute Lyricon Providers. Obtain them from the
original LyricProvider project, and report Lyricon
display/product issues there.

Developer documentation, acknowledgements, and support

• Player-owned lyricInfo protocol
• Provider adaptation guide

Thanks to the original tomakino/LyricProvider project and contributors, Accompanist Lyrics Core,
and everyone who supplied player samples, SystemUI evidence, logs, recordings, and device
validation. Third-party provenance and licenses remain in the Bridge LICENSE, Provider NOTICE,
source headers, and migration reports.

Support is optional and never changes issue priority or access to release assets. See the
Bridge README for
support options.

Assets / 发布资产

The Release contains exactly 16 files / Release 恰好包含 16 项文件：

• ColorOS-Live-Lyrics-Bridge-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Salt-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Cone-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-KuWo-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-LX-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Poweramp-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Metrolist-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-KuGou-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-QQ-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-NetEase-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Apple-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-Spotify-v4.1.0.apk
• ColorOS-Live-Lyrics-Provider-QiShui-v4.1.0.apk
• ColorOS-Live-Lyrics-Providers-v4.1.0.zip
• release-assets-v4.1.0.json
• SHA256SUMS

The Provider ZIP is an APK download bundle, not a Recovery package. / Provider ZIP 只是 APK 下载
合集，不是 Recovery 刷机包。

Donate

ColorOS Live Lyrics Bridge v4.0.0

中文

4.0 是一次完整架构升级。
播放器专属 Hook 已迁移到 12 个独立 Provider，由 Provider 从
播放器自己的 MediaSession 发布原生 MediaMetadata["lyricInfo"]。
Bridge 现在只运行于system 和 com.android.systemui，
负责通用逐字渲染、AOD、外观、翻译按钮与 SystemUI兼容增强。
并移除对词幕lyricon的兼容支持。

这是从 3.8.x 升级时需要完整迁移的破坏性版本。
重要！！请从同一个 4.0.0 Release 安装 Bridge 与自己需要的 Provider，
并在启用新 Provider 前取消旧 Provider 对同一播放器的作用域。

Bridge 架构

• 删除 direct-v4 receiver、来源/发送者注册表、外部协议模块与播放器进程 Adapter。
• Bridge 不再识别 Provider applicationId，也不再请求或接收私有歌词 payload。
• Bridge 作用域缩减为 system 与 com.android.systemui。
• 每次原生 lyricInfo 发布只解析一次，身份、清理、翻译对齐、官方列表和 renderer 共用
  同一个快照。
• SystemUI 大型 Hook 已拆分为 bootstrap、diagnostics、media/lyrics policy、model
  assembly、frame resolve、draw coordinator 和具名兼容 owner。
• Debug 默认关闭，采用结构化 [CLL] 事件、节流、脱敏以及 logcat/Xposed 双写；开启
  Debug 不会改变歌词行为。

歌词外观与渲染

• 新增独立“歌词亮度与渐隐”页面。
• 可分别调整实时文字、实时未高亮部分、实时翻译、翻译进度、非实时文字和非实时翻译。
• 非实时翻译可跟随正文亮度，也可独立设置。
• RecyclerView 上下边缘渐隐支持开关和长度调节。
• 非活动行额外淡化与模糊、缩放互相独立。
• 默认、柔和、鲜明、极简四套预设覆盖新增参数；任意偏离预设的设置显示为“自定义”。
• 根据实机反馈调整了预览行距、垂直居中、整数 dp 渐隐步进、全宽底部 Dock 和滑动条长度。
• 修复居中、右对齐歌词仍从左侧 pivot 缩放的问题。

翻译、配置与清理

• 默认亮度层级调整为：实时正文最亮，实时翻译稍暗，非实时翻译与对应非实时正文一致。
• 翻译基础亮度与翻译逐字进度亮度分别控制。
• 媒体卡翻译按钮现在立即刷新，不再等待暂停/继续播放。
• 翻译图标统一使用白色基准 tint，并通过 alpha 表示开关状态，避免部分播放器显示成黑色。
• 新增 Bridge 全量配置备份与恢复，覆盖 UI/schema、全局及逐播放器翻译、开头清理规则、
  逐曲修正、Debug 与设置语言；恢复失败会回滚。
• 全量重置需要二次确认。
• 内置歌词开头清理规则继续保留，但默认关闭；Bridge 不再无条件修补所有原生 payload。

原生播放器主动接入

Halcyon、Flamingo、QZ Music 与 PrismMusic 已加入纯包名的 SystemUI 歌词入口、媒体历史和
AOD 兼容策略。这不是歌词来源白名单：播放器仍必须从自己的 MediaSession 发布标准
lyricInfo，旧广播不会被接收，也不需要额外 Provider APK。

Provider 支持矩阵 / Provider matrix

以下表格由中英文说明共用。Provider 可以独立安装；受支持的 ColorOS SystemUI 能直接
消费其原生 lyricInfo，Bridge 只增加可选的通用增强。

从 3.8.x 升级

1. 在 Bridge 主设置页备份完整配置。
2. 使用正式 4.0.0 Bridge APK 覆盖安装官方 3.8.1。
3. Bridge 作用域只保留 system 和 com.android.systemui。
4. 卸载旧 Provider，或至少取消旧模块对同一播放器的全部作用域。
5. 安装对应的 ColorOS-Live-Lyrics-Provider-<Name>-v4.0.0.apk，只勾选表中宿主。
6. 重启播放器与 SystemUI；首次安装或作用域迁移后建议重启设备。
7. 不要让旧、新 Provider 同时 Hook 同一个播放器。

完整 applicationId、作用域和降级说明：

• 3.8.x → 4.0 迁移指南

降级到 3.8.x 不能保证配置无损，因为旧版本不认识全部 schema-v3 字段。请保留 4.0 完整
备份，并准备在旧版中重置设置。

验证与发布资产

• Bridge 标准 Gradle：481 tests，0 failure/error，6 项明确 skipped；debug/release lint、
  构建、包名、作用域、证书、zipalign、DEX 与 manifest 门禁通过。
• Provider testV5Matrix：462 tests，0 failure/error/skip；12 个 release/R8 构建通过。
• RC5 run 33301880289 的正式签名包已通过用户实机回归。
• 正式 run 33305725280
  完成不可变源码解析、Bridge/Provider 签名构建、16 资产打包以及 Bridge/LSP 双发布。
• 两个公开 Release 各 16 项资产，名称、字节数与 SHA-256 完全一致；13 个 APK 和
  12-APK Provider ZIP 已重新下载独立复核。
• Bridge commit：6ebced30a6af3fa5015af0c8ab212ea339fd9d91。
• Provider commit：950c3b170271e3a0f9bccdf3fa18735451740c80。
• Bridge APK SHA-256：3be16859c347740ca47c5bd99f0180d45fcb45615a2e90a5398417f2e98751f6。
• Provider ZIP SHA-256：3465696f5355a55379dad7ab70d637cd42659449f480f67d54ac697882b8e07d。

Release 恰好包含 16 项资产：1 个 Bridge APK、12 个 Provider APK、1 个 Provider ZIP、
release-assets-v4.0.0.json 和 SHA256SUMS。Provider ZIP 只是 APK 下载合集，不是
Recovery 刷机包。

已知限制

• ColorOS 锁屏歌词属于私有 SystemUI 功能，系统更新后可能需要重新适配。
• 播放器私有歌词接口可能随播放器更新变化。
• Spotify 与 Metrolist 当前不提供翻译。
• QQ 音乐 HD 不在 4.0 支持矩阵。
• 歌词源没有逐字或翻译 lane 时，Bridge 不会凭空生成。

本项目不再兼容适配词幕 Provider。
需要词幕时请前往LyricProvider 原项目下载对应 词幕 Provider。
词幕显示或相关问题也请向词幕原项目仓库反馈。

开发文档、致谢与支持

• 播放器主动发布 lyricInfo 协议
• Provider 适配技术指南

感谢 tomakino/LyricProvider 原项目及贡献者、Accompanist Lyrics Core，以及提供播放器
样本、SystemUI 证据、日志、录屏和实机验证的所有用户。第三方来源与许可证保留在
Bridge LICENSE、Provider NOTICE、源码头和迁移报告中。

如果项目对你有帮助，可在
Bridge README 查看支持方式。
支持完全自愿，不影响 Issue 优先级或 Release 资产获取。

English

4.0 is a full architecture release. Player-specific hooks now live in 12 independent Providers
that publish native MediaMetadata["lyricInfo"] from player-owned MediaSessions. Bridge runs only
in system and com.android.systemui and focuses on generic word rendering, AOD, appearance,
translation controls, and SystemUI compatibility.

This is a coordinated breaking upgrade from 3.8.x. Install Bridge and the Providers you use from
the same 4.0.0 Release, and remove the old Provider scope from a player before enabling its 4.0
replacement.

Bridge architecture

• Removed the direct-v4 receiver, source/sender registry, external protocol module, and
  player-process adapters.
• Bridge no longer knows Provider application IDs or accepts a private lyric payload.
• Scope is reduced to system and com.android.systemui.
• Native lyricInfo is parsed once per publication and shared by identity, cleanup, translation
  alignment, official-list handling, and renderer preparation.
• Large SystemUI responsibilities were split into bootstrap, diagnostics, media/lyrics policy,
  model assembly, frame resolution, draw coordination, and named compatibility owners.
• Debug remains off by default and uses structured [CLL] events, throttling, redaction, and
  logcat/Xposed sinks without changing lyric behavior.

Lyrics, appearance, translation, and configuration

• Added a dedicated Lyric brightness & fading page.
• Active text, unrevealed active text, active translation, translation progress, inactive text,
  and inactive translation have separate controls.
• Inactive translation can follow the main inactive opacity or keep its own value.
• Native RecyclerView top/bottom edge fading has configurable enable and length controls.
• Optional inactive-row fade is independent from blur and scale.
• Default, Soft, Vivid, and Minimal presets own the new fields; any deviation becomes Custom.
• Preview spacing, vertical centering, integer fade-length steps, the full-width bottom dock, and
  slider length were refined from device feedback.
• Center and right alignment now scale around the correct pivot.
• Media-card translation state updates immediately without waiting for pause/play.
• Translation icons use a canonical white tint and enabled/disabled alpha instead of inheriting a
  black host tint.
• Complete Bridge backup/restore covers UI/schema, global and per-player translation settings,
  opening-cleanup rules, per-track corrections, debug settings, and locale, with rollback on error.
• Built-in opening-cleanup rules remain available but default to disabled.

Native player integration

Halcyon, Flamingo, QZ Music, and PrismMusic have package-only SystemUI lyric-entrance,
media-history, and AOD compatibility. This is not source admission: each player must publish
standard lyricInfo from its own MediaSession. Old broadcasts are not accepted, and no additional
Provider APK is required.

The single bilingual Provider matrix above is shared by both language sections. Provider-only
installation can drive stock ColorOS lyrics on supported systems; Bridge adds optional generic
enhancements.

Upgrade from 3.8.x

1. Back up the complete Bridge configuration from the main settings page.
2. Install the official 4.0.0 Bridge APK over the official 3.8.1 build.
3. Keep only system and com.android.systemui in Bridge scope.
4. Uninstall/disable the old Provider or remove its player scope.
5. Install the matching ColorOS-Live-Lyrics-Provider-<Name>-v4.0.0.apk and select only its host.
6. Restart the player and SystemUI; reboot after the first installation or scope migration.
7. Never let old and new Providers hook the same player simultaneously.

See the complete 3.8.x → 4.0 migration guide
for application IDs, scopes, and downgrade details. Downgrading is not configuration-lossless
because 3.8.x does not understand every schema-v3 field.

Validation and release assets

• Bridge standard Gradle suite: 481 tests, 0 failures/errors, 6 explicit skips; debug/release lint,
  builds, package, scope, certificate, zipalign, DEX, and manifest gates passed.
• Provider testV5Matrix: 462 tests, 0 failures/errors/skips; all 12 release/R8 builds passed.
• The signed RC5 batch from run 33301880289 passed user device validation.
• Formal run 33305725280
  resolved immutable sources, built signed Bridge/Providers, packaged 16 assets, and published both
  Bridge and LSP Releases.
• Both public Releases contain the same 16 files with identical sizes and SHA-256 values; all 13
  APKs and the 12-APK Provider ZIP were downloaded and independently reverified.
• Bridge commit: 6ebced30a6af3fa5015af0c8ab212ea339fd9d91.
• Provider commit: 950c3b170271e3a0f9bccdf3fa18735451740c80.
• Bridge APK SHA-256: 3be16859c347740ca47c5bd99f0180d45fcb45615a2e90a5398417f2e98751f6.
• Provider ZIP SHA-256: 3465696f5355a55379dad7ab70d637cd42659449f480f67d54ac697882b8e07d.

The Release contains exactly 16 assets: one Bridge APK, 12 Provider APKs, one Provider ZIP,
release-assets-v4.0.0.json, and SHA256SUMS. The Provider ZIP is an APK download bundle, not a
Recovery-flashable package.

Known limits

• ColorOS lock-screen lyrics are a private SystemUI feature; system updates can require renewed
  compatibility work.
• Player-private lyric interfaces can change after player updates.
• Spotify and Metrolist do not provide translations in the current matrix.
• QQ Music HD is not supported.
• Bridge cannot invent word timing or translations that the lyric source does not provide.

This project is no longer compatible with the lyricon.
For LyricProvider support, please download the corresponding provider from the original lyricon Provider project: [https://github.com/tomakino/LyricProvider].
For any issues related to LyricProvider display, please report them to the original LyricProvider project repository.

Developer documentation, acknowledgements, and support

• Player-owned lyricInfo protocol
• Provider adaptation guide

Thanks to the original tomakino/LyricProvider project and contributors, Accompanist Lyrics Core,
and everyone who supplied player samples, SystemUI evidence, logs, recordings, and device
validation. Third-party provenance and licenses remain in the Bridge LICENSE, Provider NOTICE,
source headers, and migration reports.

Support is optional and never changes issue priority or access to release assets. See the
Bridge README for
support options.

Donate

ColorOS Live Lyrics Bridge v3.8.1

v3.8.1 修复酷我通知栏媒体卡片在播放数秒后封面被降级为纯色的问题，并为酷我 Provider 的歌词拉取增加有界重试。锁屏歌词链路无功能性变更。

Bridge

• Bridge 版本更新为 versionCode=135 / 3.8.1。

• 酷我开启或未开启"蓝牙车载歌词"时，酷我都会周期性重发当前曲目的 metadata，其 ART / ALBUM_ART bitmap lane 只有 1x1 占位图。SystemUI 的通知栏卡片消费点会把该占位图直接写入 MediaData.artwork 并放大为纯色，而锁屏 Seedling 路径已有独立修复，因此表现为锁屏封面正常、状态栏媒体卡片纯色。

• 现在在 SystemUI 媒体 metadata 封面查找的同一身份归一化分支内，当原生查找结果为空或小于 96px 时，按严格同曲身份（mediaId 与稳定 title/artist 双键）从最近有效快照恢复；快照缺失时回退酷我 https 封面端点；两者都不可用时才保留原生结果。

• 合理尺寸的原生封面仍直接走系统路径，不额外发送或覆盖 metadata，不干涉酷我到 SystemUI 的原生封面传递。

• 新增限流日志 Restored KuWo album artwork for same-identity metadata from the same-track snapshot，便于真机确认修复命中。

LyricProvider（KuWo 2.1.0）

• 酷我自身歌词拉取 e0.f 因网络波动等返回空或抛异常时，Provider 过去没有补偿，切歌后有小概率卡在大封面状态，必须手动暂停触发重拉。现在按 2s/5s/10s 退避在后台线程以原调用参数重试，最多 3 次。
• 切歌事件、歌词到达或拉取成功都会自动取消重试；网络失败先于曲目身份到达的竞态也会被切歌事件接管重试。
• 新增日志 KuWo lyric fetch retry scheduled / KuWo lyric fetch retry succeeded，便于真机确认重试命中。

Provider 版本

• kuwo-music 提升到 versionCode=12 / versionName=2.1.0；其余 Provider 无功能性变更。

验证

• Bridge testDebugUnitTest、assembleDebug 通过。
• KuWo Provider testDebugUnitTest（含 KuWoLyricFetchRetryPolicyTest）、assembleDebug 通过。
• 酷我真机完成回归：首播、切歌、暂停、seek、车载歌词开关均正常，锁屏与通知栏媒体卡片封面不再出现播放数秒后降级纯色的问题。

升级说明

• 更新 Bridge APK；酷我用户同时更新 LyricProvider-KuWo-v3.8.1.apk（Provider 2.1.0），其余 Provider 无功能性变更。
• 更新后重启 SystemUI 进程使 Hook 生效。
• 酷我 Provider 更新后需重启酷我进程使注入生效。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.8.1.apk
• LyricProvider-QQMusic-v3.8.1.apk
• LyricProvider-163Music-v3.8.1.apk
• LyricProvider-AppleMusic-v3.8.1.apk
• LyricProvider-Poweramp-v3.8.1.apk
• LyricProvider-Spotify-v3.8.1.apk
• LyricProvider-QiShui-v3.8.1.apk
• LyricProvider-KuGou-v3.8.1.apk
• LyricProvider-KuWo-v3.8.1.apk
• LyricProvider-LXMusic-v3.8.1.apk
• LyricProvider-Metrolist-v3.8.1.apk
• LyricProvider-All-v3.8.1.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.8.0

v3.8.0 聚焦播放器兼容性、酷我完整歌词接入和酷狗歌词稳定性。

Bridge

• 酷我锁屏歌词按钮完成稳定适配：保持歌词入口、翻译按钮和媒体卡片行为，覆盖首播、切歌、暂停、seek 与车载歌词元数据变化。
• 酷我封面链路保持原生传递；歌词触发的 MediaData 重建遇到无效 bitmap 时，仅按严格同曲身份恢复封面。
• Bridge 与 SystemUIPlugin 增加结构化 DexKit 发现，降低 ColorOS/SystemUIPlugin 混淆类名或方法名变化造成的失配；旧版本名称仍保留回退。
• 注册 Halcyon（com.ella.music）与 Flamingo（yos.music.player）的原生 v4 Provider source-to-player 绑定。
• Bridge 版本更新为 versionCode=134 / 3.8.0。

LyricProvider

• 酷我 Provider 升级为 versionCode=11 / 2.0.0：直接把完整逐行、逐字和翻译歌词送入 Lyricon 词幕，不再依赖车载歌词模式。
• 酷我 Provider 增加酷我歌词获取方法、官方 LRCX 解析器和字段结构的 DexKit 兼容；官方 LRCX 行时间异常时只在词幕副本中修正，不改变锁屏 lyricInfo 数据。
• 酷狗 Provider 修复预取歌词串曲、车载歌词元数据身份变化和原生封面恢复问题，避免异步歌词绑定到上一首歌曲。
• 其他 Provider 没有功能性变更，仍随统一 Release 构建并按需安装。

验证

• Bridge testDebugUnitTest、assembleDebug 通过。
• 酷我 Provider testDebugUnitTest、assembleDebug 通过。
• 酷我真机完成首播、切歌、暂停、seek、翻译按钮、封面和词幕回归；DexKit 日志确认酷我歌词入口与 SystemUIPlugin 模型均命中结构发现。

升级说明

• 从同一 3.8.0 Release 更新 Bridge 和正在使用的 Provider，避免新旧协议或版本配合异常。
• 酷我用户需要更新 2.0.0 Provider；更新后重启 SystemUI、酷我及其他正在使用的 Provider 进程。
• 未使用酷我或酷狗的用户无需因本版本功能变化额外安装对应 Provider。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.8.0.apk
• LyricProvider-QQMusic-v3.8.0.apk
• LyricProvider-163Music-v3.8.0.apk
• LyricProvider-AppleMusic-v3.8.0.apk
• LyricProvider-Poweramp-v3.8.0.apk
• LyricProvider-Spotify-v3.8.0.apk
• LyricProvider-QiShui-v3.8.0.apk
• LyricProvider-KuGou-v3.8.0.apk
• LyricProvider-KuWo-v3.8.0.apk
• LyricProvider-LXMusic-v3.8.0.apk
• LyricProvider-Metrolist-v3.8.0.apk
• LyricProvider-All-v3.8.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.7.3

适配 Salt Player 12.2.1：官方在该版本把歌词发布协程方法名混淆（invokeSuspend 被重命名），
模块改为按结构签名回退解析，歌词获取恢复正常；旧版本 Salt Player 不受影响。

兼容与验证

• 旧版本 Salt Player（12.0.x / 12.2.0-alpha02 / 12.2.0）仍走原解析路径，行为不变。
• scripts\dev.cmd bridge testDebugUnitTest assembleDebug 通过（含新增 4 项方法解析单测）。
• 真机验证（Salt 12.2.1，debug 构建）：Hook 安装成功，SALT_FINAL_EMBEDDED 歌词正常接收并注入。

升级说明

• 更新 Bridge 为 ColorOS-Live-Lyrics-Bridge-v3.7.3.apk；本次无 Provider 变更，无需更新 Provider。
• 更新后重启 Salt Player 进程；如 LSPosed 仍加载旧模块，请重启设备。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.7.3.apk
• LyricProvider-QQMusic-v3.7.3.apk / LyricProvider-163Music-v3.7.3.apk /
  LyricProvider-AppleMusic-v3.7.3.apk / LyricProvider-Poweramp-v3.7.3.apk /
  LyricProvider-Spotify-v3.7.3.apk / LyricProvider-QiShui-v3.7.3.apk /
  LyricProvider-KuGou-v3.7.3.apk / LyricProvider-LXMusic-v3.7.3.apk /
  LyricProvider-Metrolist-v3.7.3.apk
• LyricProvider-v3.7.3.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.7.2

v3.7.2 重构“播放器翻译设置”：翻译开关按钮统一占用锁屏媒体卡收藏槽位（媒体卡固定 5 个按钮，
只能替换、不能新增），并为 QQ 音乐、原版酷狗修复此前失效的翻译按钮；新增分播放器
“锁屏媒体卡翻译按钮”开关；设置页建立播放器卡片接入约定（按是否有翻译源显示开关），
Spotify/Metrolist 明确显示“不支持翻译”。外部歌词 v4 协议、Provider 准入规则与既有
AOD/渲染行为保持兼容，本次无 Provider 变更。

播放器翻译设置重构

• 代码分层：新增 PlayerTranslationTogglePolicy（纯决策）与
  TranslationToggleMediaActionBinder（媒体卡模型操作：定位收藏、原地替换、提升、呈现、
  点击绑定），LockscreenLyricsModule 不再承载媒体动作操作，只保留 Hook 入口与运行时状态。
• 收藏定位三级兜底：PlaybackState.CustomAction 映射 → OPlus heart 标记
  （getHeartAction / hasHeartFromRating）→ Rule0 列表唯一动作。QQ 音乐、原版酷狗的收藏
  不携带 CustomAction（设备日志确认），此前翻译按钮完全失效，现经兜底恢复可用。
• 分播放器“锁屏媒体卡翻译按钮”开关（默认开）：开 = 收藏槽位换成翻译开关；关 = 恢复播放器
  自带收藏。开关覆盖三条按钮路径：替换收藏（QQ/酷狗/网易云/Apple/汽水/酷狗 Lite）、公开注入
  按钮（LX/Poweramp/Cone 等，关闭时从媒体卡移除）、Salt 自带桌面歌词按钮（关闭时恢复播放器
  自身行为）。
• 图标加载修复：模块 ic_translation 改为从资源所属包 Context 直接加载；此前
  Icon.loadDrawable 在 SystemUI 侧对跨包资源静默返回 null，导致按钮图标未被替换。
• 无翻译歌曲恢复播放器自带收藏：修复媒体卡按钮视图回收复用导致“只剩 4 个按钮”的问题，
  媒体卡始终 5 个按钮。

设置页卡片接入约定

• 播放器卡片新增 supportsTranslation 声明：有翻译源的播放器显示“默认显示翻译 / 锁屏媒体卡
  翻译按钮 / 清除记忆”；无翻译源的播放器（Spotify、Metrolist）保留卡片用于检测
  LyricProvider 安装状态，显示“不支持翻译”且不显示任何开关。
• 新增 Metrolist 卡片，并修复其 Provider 检测（manifest <queries> 补充
  io.github.proify.lyricon.metrolistprovider，此前 Android 11+ 包可见性导致卡片误灰置）。
• 新播放器接入约定见 docs/TRANSLATION_TOGGLE_INTEGRATION.md。

OPlus 媒体黑名单放行

• 新增 OplusMediaControlService.isInMediaBlackList(String) 拦截：模块管理播放器（内置
  适配器与 Provider 桥接播放器）在黑名单查询命中时放行（返回未命中），避免被 OPlus 媒体控制
  过滤；其他包需在清单中显式声明接入（opt-in），并经 LockscreenIntegrationPolicy 策略
  门控后放行。未命中黑名单或未声明接入的包保持系统原判定，不影响既有白名单/历史逻辑。

已知特殊案例

• Apple Music：收藏采用评分式槽位，其渲染图标来自媒体卡模型之外的来源，静态替换不可达；
  翻译按钮图标保留播放器自带（与翻译功能匹配），按钮功能与其余行为正常。

LyricProvider

• 本次无 Provider 功能变更；全部 Provider APK 仍随 Release 附带，供按需更新。

兼容与验证

• 外部歌词协议仍为 v4；现有 Provider 的 source / playerPackage / senderPackage /
  senderKind 静态白名单校验不变。
• 未修改官方 Renderer 的 AOD 切换时序、LyricsRecyclerView prime 或普通 TextView
  Hook 范围。
• scripts\dev.cmd bridge testDebugUnitTest assembleDebug 通过（423 项测试 0 失败）。
• 真机验证（OPPO 设备，debug 构建）：
  • QQ 音乐、原版酷狗：收藏槽位变为翻译按钮、点击切换翻译行、开关关恢复收藏 —— 通过；
  • Salt/Cone/LX/Poweramp/汽水：媒体卡翻译按钮开关开/关全部生效，Salt 图标修复为模块
    翻译图标 —— 通过；
  • 无翻译歌曲恢复播放器自带收藏、媒体卡保持 5 个按钮 —— 通过；
  • Metrolist 卡片亮起并显示“不支持翻译”、无开关 —— 通过；
  • Apple Music 图标为播放器自带（特殊案例，见上）。

升级说明

• 更新 Bridge 为 ColorOS-Live-Lyrics-Bridge-v3.7.2.apk；本次无 Provider 变更，无需更新
  Provider。
• 更新后重启对应播放器进程；如 LSPosed 仍加载旧模块，请重启设备。
• “播放器翻译设置”新增的“锁屏媒体卡翻译按钮”默认开启；不希望收藏槽位被替换的用户可
  逐播放器关闭。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.7.2.apk
• LyricProvider-QQMusic-v3.7.2.apk
• LyricProvider-163Music-v3.7.2.apk
• LyricProvider-AppleMusic-v3.7.2.apk
• LyricProvider-Poweramp-v3.7.2.apk
• LyricProvider-Spotify-v3.7.2.apk
• LyricProvider-QiShui-v3.7.2.apk
• LyricProvider-KuGou-v3.7.2.apk
• LyricProvider-LXMusic-v3.7.2.apk
• LyricProvider-Metrolist-v3.7.2.apk
• LyricProvider-v3.7.2.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

ColorOS Live Lyrics Bridge v3.7.1

v3.7.1 修复两项关键问题：ColorOS 16.0.10.x（OPPO X9s Pro 等新版本系统）的 SystemUI
private-hook 解析失效，以及 v3.7.0 引入的普通逐行歌词"实时行高亮消失"。Bridge 的外部歌词
v4 协议、Provider 准入规则与既有 AOD/渲染行为保持兼容。

SystemUI 兼容修复（ColorOS 16.0.10.x）

• 新版本系统界面（版本号仍为 16.99.12/169912，但媒体 RUS 管理器已重构）中，
  OplusMediaRusUpdateManager.getRusWhiteList() 被删除、saveListToSP 变为静态 10 参数、
  updatePkgActionsRule 由 5 个 Map 增至 6 个 Map，白名单改经 Kotlin data class
  MediaRusConfig.getWhiteList() 暴露，并新增与 getLyricEntrance 同形的
  getLyricEnable(String)。
• Bridge 的 DexKit 目标解析升级为"双锚点集 + 新旧形态兼容"：
  • RUS 管理器类使用 anyOf 双锚点集，16.0.9.x 与 16.0.10.x 各自唯一命中；
  • saveListToSp / updatePkgActionsRule 谓词同时接受新旧两种签名；
  • 白名单 getter 按构建变体选择（getRusWhiteList 或 MediaRusConfig.getWhiteList），
    后者按精确方法名解析以避免 Kotlin data class 的 componentN 歧义；
  • getLyricEntrance 按方法名排除同形的新增 getLyricEnable；
  • legacy 反射回退路径同步容错，解析日志新增 rusVariant（OLD/NEW）便于排查。
• 16.0.9.x 及更早构建的目标解析行为保持字节级一致，无回归。

实时行高亮修复

• 修复 v3.7.0 回归：普通逐行歌词（无逐字时间戳）的实时行不再以 100% 不透明度高亮，
  与相邻行不透明度一致。根因是 v3.7.0 将激活行绘制改为仅在 AOD 低帧率填充时使用
  activePaint，而无词行无法进入逐字 reveal 路径。
• 恢复激活行整行高亮：drawCompactLine 与 drawSegment 在无逐字进度时以 activePaint
  绘制实时行；lineTimedProgressEnabled（普通逐行歌词进度）开启时无词行同样回退整行
  高亮，不再出现"开关开着反而没有高亮"。
• 带逐字时间戳的歌词仍走逐字 reveal，主色仅用于逐字覆盖与扫光；AOD 低帧率整行填充
  行为不变。

LyricProvider

• 本次无 Provider 功能变更；全部 Provider APK 仍随 Release 附带，供按需更新。

兼容与验证

• 外部歌词协议仍为 v4；现有 Provider 的 source / playerPackage / senderPackage /
  senderKind 静态白名单校验不变。
• 未修改官方 Renderer 的 AOD 切换时序、LyricsRecyclerView prime 或普通 TextView
  Hook 范围。
• scripts\dev.cmd bridge testDebugUnitTest assembleDebug 通过（42 套件 / 412 项测试
  0 失败）。
• SystemUI 兼容修复：16.0.9.x（PJZ110）真机验证 rusVariant=OLD 全链路正常；16.0.10.500
  （OPPO X9s Pro）真机验证歌词接收、词幕模型缓存、官方渲染与 AOD 正常，并完成
  MediaRusConfig 新白名单 getter 与六 Map 规则更新路径验证。
• 实时行高亮修复：开发者设备与反馈用户真机实测通过（普通逐行歌词实时行恢复 100%
  不透明度；带逐字歌词与 AOD 无回归）。

升级说明

• 更新 Bridge 为 ColorOS-Live-Lyrics-Bridge-v3.7.1.apk；如使用对应播放器 Provider，
  建议从同一 Release 同步更新 Provider APK（本次无功能变更，可按需）。
• 更新后重启对应播放器进程；如 LSPosed 仍加载旧模块，请重启设备。
• ColorOS 16.0.10.x 用户本次为必须升级：旧版本在该系统上 SystemUI hook 无法安装，
  锁屏歌词整体失效。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.7.1.apk
• LyricProvider-QQMusic-v3.7.1.apk
• LyricProvider-163Music-v3.7.1.apk
• LyricProvider-AppleMusic-v3.7.1.apk
• LyricProvider-Poweramp-v3.7.1.apk
• LyricProvider-Spotify-v3.7.1.apk
• LyricProvider-QiShui-v3.7.1.apk
• LyricProvider-KuGou-v3.7.1.apk
• LyricProvider-LXMusic-v3.7.1.apk
• LyricProvider-Metrolist-v3.7.1.apk
• LyricProvider-v3.7.1.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.7.0

v3.7.0 完成设置页面的整体 UI 重构，并修复 LX Music 与汽水音乐 Provider 的歌词覆盖层稳定性问题。Bridge 的外部歌词 v4 协议、Provider 准入规则与既有 AOD/渲染行为保持兼容。

设置 UI 重构

• 主设置页按「状态 → 预览 → 风格预设 → 颜色与光晕 → 排版 → 动效与刷新 → 兼容与屏幕」重新组织，并加入分区头、图标与分组卡片；所有控件改为 Material 风格实现，不再使用原生 Spinner / 原生弹出菜单。
• 新增静态迷你锁屏预览：预览使用真实配置的字号、颜色、光晕、模糊、缩放与对齐效果，在页面滚动时吸顶浮动；预览卡可通过底部手势条上滑收纳为标题栏「预览」按钮，点击后原路展开，滚回原位自动恢复。
• 新增激活状态实时查询：标题下方显示模块是否运行，并提供「重启系统界面」按钮与统一的「应用并保存」底部操作栏；未保存修改时显示 UNSAVED 徽标，返回前弹出居中确认面板。
• 颜色与光晕设置改为 mockup 风格：主色/光晕色板、滑块与开关保持即时联动，自定义颜色使用锚定色块的圆角面板（HEX 输入、颜色预览、取消/应用），点击预览色块可展开 HSV 取色，并针对输入法避让做了键盘上方定位。
• 二级页面（播放器翻译设置、歌词开头信息清理）同步完成新版式改造，包含与主页一致的操作栏、分区结构与沉浸式手势导航栏。
• 修正主歌词颜色的语义：普通行与非实时行歌词始终为低透明度白色，主歌词颜色只作用于实时行的逐字覆盖与扫光过渡，避免整行染色与过渡区白色断层。
• 纯白主色选项增加常驻深色细描边，未选中时不再与卡片背景融为一体。
• UI国际化语言支持：中文、English。

LyricProvider

• LX Music：移除 MediaSession 播放状态/元数据回调中对 Lyricon 的重复 setPlaybackState 与 setSong 调用，歌词覆盖层由 LyricModule 锚点同步循环独占驱动，修复歌词闪烁与进度错位。
• 汽水音乐：Lyricon 歌曲去重改为按 id + lyrics 比较，仅元数据变化（歌名、歌手、时长）不再重置覆盖层，修复同曲元数据更新时的闪烁与过渡动画丢失。
• LX Music 内部版本提升到 1.0.3（versionCode 5），汽水音乐提升到 1.2.7（versionCode 10）；其余 Provider 本次没有内部版本变更。

兼容与验证

• 外部歌词协议仍为 v4；现有 Provider 的 source、playerPackage、senderPackage 与 senderKind 白名单校验不变。
• 本次不修改 SystemUI Renderer、AOD 切换时序、LyricsRecyclerView prime 或普通 TextView Hook 范围。
• 设置 UI 重构以真机手动验证为准，scripts\dev.cmd bridge testDebugUnitTest assembleDebug 通过；LX Music / 汽水音乐修复已通过 Provider 侧源码验证，正式实机验证随 Release 进行。

升级说明

• 更新 Bridge 与需要修复的 Provider APK；LX Music 用户更新 LX Music Provider，汽水音乐用户更新 QiShui Provider。
• 更新后重启对应播放器进程；如 LSPosed 仍加载旧模块，请重启设备。
• 其他播放器用户无需因功能变化单独更新 Provider，完整 Release 仍附带全部 Provider APK 与 LyricProvider-v3.7.0.zip。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.7.0.apk
• LyricProvider-QQMusic-v3.7.0.apk
• LyricProvider-163Music-v3.7.0.apk
• LyricProvider-AppleMusic-v3.7.0.apk
• LyricProvider-Poweramp-v3.7.0.apk
• LyricProvider-Spotify-v3.7.0.apk
• LyricProvider-QiShui-v3.7.0.apk
• LyricProvider-KuGou-v3.7.0.apk
• LyricProvider-LXMusic-v3.7.0.apk
• LyricProvider-v3.7.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.6.0

v3.6.0 新增 Metrolist 的完整 LyricProvider 适配，并修复外部歌词已经成功送达、锁屏原生歌词列表却要等到暂停或继续播放才刷新的问题。本次继续使用 v4 直达协议，不改变既有 Provider 的准入和兼容方式。

Bridge

• 在静态外部歌词注册表中加入 lyricprovider/metrolist-music 与宿主包名 com.metrolist.music 的固定绑定，支持 Provider 上报播放状态、曲目 generation 和当前曲目权威信息。
• Metrolist Provider 的 v4 广播仍按完整 source、playerPackage、senderPackage 与 senderKind 规则校验；未知来源、宿主不匹配和旧协议不会被动态放行。
• 修复部分首次播放或切歌场景：Bridge 已经接收并提升有效歌词模型，但 ColorOS SystemUI 的官方 LyricsRecyclerView 仍为空，只有暂停或继续播放触发元数据重载后才出现歌词。
• 外部歌词提升成功后，Bridge 现在会在验证播放器包名、当前曲目和上下文时效后，有限次重放最近一次 SystemUI 原生歌词加载事务，让官方列表及时填充。
• 重放逻辑是通用外部歌词恢复流程，不依赖 Metrolist 包名分支，也不会强制 setAodModeStyle、延迟首次 RecyclerView prime，或扩大普通 TextView Hook 范围。
• 新增 Metrolist v4 fixture、source/host 准入测试和 canonical enhanced-LRC 逐字解析测试。

Metrolist LyricProvider

• 新增独立的 LyricProvider-Metrolist，作用域为 com.metrolist.music。Provider 从 Metrolist 当前媒体模型取得歌曲 ID、标题、歌手、专辑和秒级时长，并转换成 Bridge 所需的毫秒级媒体身份。
• Metrolist是适用于安卓系统的第三方 YouTube Music 客户端，它将作为替代适用于对 YouTube Music 的适配而发布。
• Provider 读取 Metrolist 的 files/datastore/settings.preferences_pb，解析 LyricsProviderOrderKey 与供应商启用状态，保持用户配置的相对顺序，不再使用猜测路径或扫描 protobuf 可打印字符串。
• 当前实现依次支持 BetterLyrics、LrcLib 与 KuGou。BetterLyrics 使用标题、歌手、时长和专辑参数；LrcLib 接收 album_name；KuGou 搜索词也包含专辑信息，减少错误候选。
• BetterLyrics TTML 会保留毫秒级行时间、逐字 span、结尾时间、audio lyricOffset 和真实单词边界。无空白的相邻拉丁 span 会先合并为同一单词，修复 call ing、a lone、mega phone 等错误空格；CJK span 仍保持独立逐字时间。
• KuGou 优先下载并解析 KRC 逐字歌词，生成标准 [行时间]<词时间>文本...<结束时间> enhanced LRC；仅在 KRC 不可用时回退逐行 LRC。
• 首次播放和切歌搜索绑定当前 track generation。切歌会取消旧任务及正在进行的 OkHttp 请求，每个供应商具有独立 8 秒超时，过期结果不会覆盖新曲。
• 修复 Hooker 在 zygote 初始化阶段提前创建主线程 Handler 导致的初始化失败，以及发送前歌词清洗正则异常。主线程对象现在延迟到真实应用回调中创建。
• Provider 继续保留 Lyricon 的正常 player.setSong / playback state 路径，并在同一当前曲目校验后发送 Bridge v4 payload。

诊断与文档

• 新增统一的 Bridge / Provider 日志抓取说明与脚本，明确 adb logcat -s 只过滤输出，不能开启 Log.isLoggable 控制的调试日志。
• Provider 日志现在区分曲目识别、供应商顺序、命中来源、timing=word|line、行内时间标签数量、v4 发送和 Bridge 接收阶段，便于定位“搜索成功但未发送”或“已接收但未填充官方列表”。
• Provider 适配文档补充 DataStore、异步 generation、逐字格式、TTML 单词边界、KRC 回退和可取消网络请求等门禁。

兼容与验证

• Bridge 全量 testDebugUnitTest 与 assembleDebug 通过。
• Metrolist Provider testDebugUnitTest 与 assembleDebug 通过；测试覆盖 DataStore protobuf、供应商顺序与超时、BetterLyrics TTML、KuGou KRC、enhanced-LRC 清洗和 v4 payload。
• Android 16 实机验证通过首次播放、连续切歌、暂停恢复、供应商优先级、BetterLyrics 专辑匹配、KuGou KRC 逐字时间和拉丁音节合并。
• 实机日志确认 Bridge 能接收并提升 Metrolist 文档、重放 SystemUI 元数据歌词加载、生成非零 RecyclerView itemCount 并完成首次 prime，无需再手动暂停或继续播放。
• Salt Player、ConePlayer 和已有 8 个 LyricProvider 的适配方式保持不变；外部歌词协议版本仍为 v4。本次不调整已知良好的 AOD 切换时序和官方歌词几何策略。

升级说明

• Metrolist 用户需要同时安装同一 Release 中的 ColorOS-Live-Lyrics-Bridge-v3.6.0.apk 与 LyricProvider-Metrolist-v3.6.0.apk。
• 在 LSPosed 中启用 Metrolist Provider，并只勾选 Metrolist 作为作用域；随后强行停止并重新打开 Metrolist。首次安装或作用域变化后建议重启设备。
• 已使用其他播放器的用户可以直接更新 Bridge；原有 Provider 的作用域和使用方式无需改变。Bridge 与 Provider 应来自同一 Release。
• Metrolist Provider 当前发送原文逐字或逐行歌词，不生成歌词源未提供的翻译。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.6.0.apk
• LyricProvider-Metrolist-v3.6.0.apk
• LyricProvider-QQMusic-v3.6.0.apk
• LyricProvider-163Music-v3.6.0.apk
• LyricProvider-AppleMusic-v3.6.0.apk
• LyricProvider-Poweramp-v3.6.0.apk
• LyricProvider-Spotify-v3.6.0.apk
• LyricProvider-QiShui-v3.6.0.apk
• LyricProvider-KuGou-v3.6.0.apk
• LyricProvider-LXMusic-v3.6.0.apk
• LyricProvider-v3.6.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.5.2

v3.5.2 是一次 Salt Player 内置适配更新，适配最新的 12.2.0-alpha02 版本，并继续兼容原先已支持的旧版本。

Bridge

• Salt Player 12.2.0-alpha02 将混淆后的歌词来源枚举、滚动枚举、歌词结果和最终发布协程从 androidx.obf 整体迁移到了 androidx.media3，导致旧版 Bridge 的 DexKit 查询无法发现歌词发布链路。
• Bridge 现在通过独立的 SaltPlayerDexKitSearchPolicy 同时搜索 androidx.obf 与 androidx.media3，恢复 12.2.0-alpha02 的歌词捕获，同时保留旧版本兼容。
• Salt Player 的 Song#getId/getTitle/getArtist、MusicService 和媒体按键接收器路径保持不变；最终歌词仍在播放器完成当前歌曲 ID 校验后提交，避免把异步返回的旧歌词绑定到新歌曲。
• versionCode 从 127 提升到 128，默认 versionName 从 3.5.1 提升到 3.5.2。
• 本次不修改外部歌词 v4 协议、Provider 准入、SystemUI Renderer、AOD、LyricsRecyclerView prime 或普通 TextView Hook 范围。

LyricProvider

• 8 个 LyricProvider 本次没有功能源码或内部版本变更。
• 统一 Release 工作流仍构建并附带全部 Provider APK 与合集 ZIP，方便新安装或按需更新。

验证

• Salt Player 12.2.0-alpha02 适配测试通过。
• Bridge 全量 testDebugUnitTest 与 assembleDebug 通过，新增测试覆盖新旧 DexKit 包根及防御性副本行为。
• GitHub Actions 正式发布构建通过：Bridge、QQ 音乐、网易云音乐、Apple Music、Poweramp、Spotify、汽水音乐、酷狗音乐、LX Music 和双仓库 publish job 全部成功。

升级说明

• Salt Player 用户更新 Bridge 后重启 Salt Player 进程；如 LSPosed 仍加载旧模块，请重启设备。
• 本次 Salt Player 修复不需要安装额外 Provider。其他播放器用户无需因功能变化单独更新 Provider。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.5.2.apk
• LyricProvider-QQMusic-v3.5.2.apk
• LyricProvider-163Music-v3.5.2.apk
• LyricProvider-AppleMusic-v3.5.2.apk
• LyricProvider-Poweramp-v3.5.2.apk
• LyricProvider-Spotify-v3.5.2.apk
• LyricProvider-QiShui-v3.5.2.apk
• LyricProvider-KuGou-v3.5.2.apk
• LyricProvider-LXMusic-v3.5.2.apk
• LyricProvider-v3.5.2.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.5.1

v3.5.1 是一次网易云音乐 LyricProvider 定向修复。Bridge 本体没有业务逻辑变更；本次提升 Bridge 版本并触发统一 Release 工作流，用于发布修复后的 163 Music Provider。

Bridge

• Bridge 本体保持 v3.5.0 的协议、渲染、AOD 与 Provider 准入行为不变。
• versionCode 从 126 提升到 127，默认 versionName 从 3.5.0 提升到 3.5.1。

LyricProvider

• 网易云音乐 Provider 内部版本提升到 1.1.7。
• 修复网易云音乐 9.0.40 LSPatch 包中词幕无法显示双排翻译的问题：LSPatch 外层 wrapper ClassLoader 在 Hook 初始化阶段看不到原包的 com.netease.cloudmusic.utils.o2.a() 偏好访问器，导致 showLyricSetting 读取为 -1，词幕同时关闭翻译与罗马音。
• Provider 现在会在 Application.onCreate 后使用原包 application.classLoader 重新解析偏好访问器，再读取 showLyricSetting 并注册词幕 Provider。宿主自带冲突 libdexkit.so 时仍不会加载 Provider 自带 DexKit，保留对 LSPatch 包的进程安全保护。
• Bridge 侧歌词数据链路原本已正确携带翻译；本次不修改 Bridge、SystemUI Renderer、AOD 或 LyricsRecyclerView 行为。
• QQ 音乐、Apple Music、Poweramp、Spotify、汽水音乐、酷狗音乐与 LX Music Provider 本次没有源码或内部版本变更；统一 Release 工作流仍会构建这些 APK，以保持 Provider ZIP 合集完整。

验证

• CloudMusicPlaybackPolicyTest 通过。
• :163-music:assembleDebug --offline 与 :163-music:assembleRelease --offline 通过。
• 网易云音乐 9.0.40 LSPatch 真机日志确认偏好访问器由 unavailable 恢复为 com.netease.cloudmusic.utils.o2.a，Provider 以 translationType=0 注册。
• 真机确认词幕恢复双排翻译显示；Bridge 原有歌词检测与锁屏显示保持正常。

升级说明

• 本次实际功能修复只在 LyricProvider-163Music-v3.5.1.apk。网易云音乐用户更新该 Provider 后，重启网易云音乐进程；如仍加载旧 Hook，重启设备。
• 其他播放器用户无需因功能变化单独升级 Provider；完整 Release 仍会附带全部 Provider APK 与 LyricProvider-v3.5.1.zip。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.5.1.apk
• LyricProvider-QQMusic-v3.5.1.apk
• LyricProvider-163Music-v3.5.1.apk
• LyricProvider-AppleMusic-v3.5.1.apk
• LyricProvider-Poweramp-v3.5.1.apk
• LyricProvider-Spotify-v3.5.1.apk
• LyricProvider-QiShui-v3.5.1.apk
• LyricProvider-KuGou-v3.5.1.apk
• LyricProvider-LXMusic-v3.5.1.apk
• LyricProvider-v3.5.1.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。

Donate

ColorOS Live Lyrics Bridge v3.5.0

v3.5.0 把 v4 外部歌词协议补到可在长歌词场景稳定运行的形态：Bridge 与 Provider 各自新增并对齐了大小限制常量，Provider 侧加入逐行截短重试，LyricInfoContract 支持纯逐字歌词走完整流水线；这一版本同时收紧 BridgePayloadGate 的去重窗口并把 LockscreenLyricsModule 的渲染/时序逻辑拆到独立类，便于后续按层迭代。

Bridge

• LyricInfoContract.parse 现在接受 lyric 字段为空、rawLyric 含时间戳的 payload：纯逐字歌词会被视为合法 lyric 进入流水线，原始 rawLyric 仍按字渲染路径使用，避免 Provider 主动把逐字降级成逐行后丢字。
• external-lyric-protocol 新增大小限制常量 MAX_LYRIC_FIELD_CHARS = 1_500_000、MAX_TOTAL_LYRIC_CHARS = 3_000_000、MAX_METADATA_FIELD_CHARS = 16_384、MAX_PARCEL_BYTES = 512 KiB，与 Provider 端 ExternalLyricV4Protocol 同名常量镜像；Bridge 端按字符、Provider 端按 Parcel 字节校验，数字差异由两端的度量单位差异解释，并显式写在常量注释中。
• 新增独立的 LyricTimingTuningConstants 与 render/ 子包，把渲染与时序调整从 LockscreenLyricsModule 拆出；模块类体不再直接承载逐字进度、扫光、首句清理与时序微调逻辑，便于单独 review 与单元测试。
• 文本匹配、清理与核心 adapter 配合协议层变更同步更新：LyricTextMatchPolicy、LyricTextSanitizer、LyricsCoreAdapter 与 ExternalLyricIngress 调整接收侧数据形态与默认值。
• app/build.gradle.kts 开启 testOptions.unitTests.isReturnDefaultValues = true，方便本地单元测试在不依赖 Android 桩时通过运行。
• Bridge 端 README 中英文版同步更新 Provider 安装与常见问题说明。

LyricProvider

• share/extensions-android 中 SystemUiBroadcastSender 新增 submitWithLyricLineFallback：当标准 submit 流程因 payload 超大被 SystemUI 拒收（且行级降级后仍超限），会调用 LyricLineTruncator 对三个 lyric extras 做一次有界、按字节预算的中间行截短并重试；retry 时会以调用方传入的原始 lyric/rwLyric/translationLyric 为输入，避免在已降级字符串上重复裁剪。MAX_PARCEL_BYTES 改为引用 ExternalLyricV4Protocol.MAX_PARCEL_BYTES，统一阈值来源。
• share/extensions-kt 新增 LrcTimeFormatter、TrackKeyBuilder、LyricLineTruncator、WordTimeNormalizer、ProviderDiagnostics 等桥接辅助类，分别承担时间格式化、track key 计算、行截短预算、逐字时间归一化与 Provider 端诊断输出；现有 BridgeEventGates.BridgePayloadGate 由单 key 改为 ArrayDeque<Entry> 的多键 LRU，默认保留最近 8 条 30 秒窗口内的 key，支持按 key 主动 forget，避免跨曲目共用同一去重 slot。
• QQ 音乐、网易云音乐、Apple Music、Spotify、汽水音乐与酷狗音乐 Provider 的 SaltLyricBridge 同步切换到 submitWithLyricLineFallback：当 lyric 为空但 rawLyric 含时间标签时仍把 rawLyric 作为 lyric 兜底，并把 TrackKeyBuilder / WordTimeNormalizer / LrcTimeFormatter 等辅助接入主流程；QQ 音乐与 Spotify 同时把增强 LRC 与纯 LRC 分别装入 rawLyric / lyric，避免时间信息丢失。
• 酷狗音乐 Provider 移除 KuGouOriginalMediaMetadataPolicy，原职责并入 KuGouOriginalLyricCandidatePolicy：取消"临时车机歌词元数据"覆盖专辑封面路径，恢复真实专辑封面，并修复同曲不同标题版本互相切换时偶发的"暂无歌词"或歌曲信息串用。
• share/krckit、share/qrckit、share/yrckit 中的 KRC/QRC/YRC parser 与语言识别器微调：保持现有 API，仅修正对部分边界（极短行、空逐字、单次消费）解析的稳定性；QQ QRC 翻译对齐仍使用共享扩展层的有界一对一匹配，不退回逐行 findClosest。
• 新增与本次改动配套的单测：ProviderDiagnosticsTest、ExternalLyricV4ProtocolSizeLimitsTest、LrcTimeFormatterTest、LyricLineTruncatorTest、TrackKeyBuilderTest、WordTimeNormalizerTest、YrcParserTest 及更新后的 BridgeEventGatesTest。

本次有内部版本更新的 Provider：网易云音乐 1.1.6、QQ 音乐 1.1.6、Apple Music 1.1.4、Spotify 1.1.6、汽水音乐 1.2.6、酷狗音乐 1.1.9。Poweramp 与 LX Music 本次没有 Provider 侧改动，但 Release 工作流仍会构建它们的 APK 以保持 ZIP bundle 完整。

升级说明

• 请将 Bridge 与正在使用的 Provider 从本次 Release 一起更新；升级后重启设备，或至少重启 SystemUI 与对应播放器进程。
• 如果你使用的 Provider 在 v3.5.0 之前曾因歌词过大被 SystemUI 拒绝，现在会自动通过逐行截短重试一次；如仍失败，请导出 LSPosed 日志并按 [BRIDGE_GATE]、[SystemUiBroadcastSender]、[LyricLineTruncator]、[ProviderDiagnostics] 关键字定位日志。
• AOD 首次 attach、prime、槽高、官方行缩放与低刷新切换路径继续沿用 v3.3.0 起的已验证基线，本次未引入新的 AOD 可见性、透明度、尺寸或 readiness 门控。

验证

• Bridge：testDebugUnitTest、assembleDebug、lintDebug、LSPosed metadata 校验与 git diff --check 通过。
• LyricProvider：根项目 testDebugUnitTest 通过；新增的协议大小限制、桥接工具类与 Parser 单测全部覆盖；BridgePayloadGate LRU 行为已通过更新后的 BridgeEventGatesTest 覆盖。
• Provider 发布包通过 Bridge workflow 同一 tag（v3.5.0）一次性构建：Bridge 主 APK + 8 个 Provider APK + LyricProvider-v3.5.0.zip 一起上传到 GitHub Release 与 LSPosed 仓库。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.5.0.apk
• LyricProvider-QQMusic-v3.5.0.apk
• LyricProvider-163Music-v3.5.0.apk
• LyricProvider-AppleMusic-v3.5.0.apk
• LyricProvider-Poweramp-v3.5.0.apk
• LyricProvider-Spotify-v3.5.0.apk
• LyricProvider-QiShui-v3.5.0.apk
• LyricProvider-KuGou-v3.5.0.apk
• LyricProvider-LXMusic-v3.5.0.apk
• LyricProvider-v3.5.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐启用"还原内联钩子"，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.4.1

v3.4.1 是一次兼容性与稳定性小修复，重点处理 Provider 安装检测、歌词开头清理、酷狗切歌，以及 LX Music 的切歌诊断。

Bridge

• 修复 Android 11 及以上版本中，播放器翻译设置把已安装的 LyricProvider 误判为“未安装”的问题；现在会正确识别 QQ 音乐、网易云音乐、Apple Music、LX Music、Poweramp、Spotify、汽水音乐与酷狗音乐 Provider。
• 补全英文制作人员信息的开头清理识别，并在清理后收紧歌词行，避免这些信息留下大段空白。
• 修正官方歌词列表含有插入行时的行位映射，避免后续歌词被错位匹配、抑制或显示为空白。

LyricProvider

• 修复网易云音乐、QQ 音乐、Spotify 与汽水音乐在 Bridge 的切歌门控下影响词幕原有歌曲提交的问题，恢复与词幕并用时的正常歌词检测与显示。
• 修复酷狗同曲不同标题版本互相切换时串用歌曲信息或显示“暂无歌词”的问题；同时保留真实专辑封面，不再被临时车机歌词元数据覆盖为纯色封面。
• LX Music 改进播放器进程重启后的轨道代次，避免 SystemUI 因旧代次拒收新歌词；新增低频、脱敏的 LSPosed 探针日志，便于排查极少数切歌后歌词入口消失的问题。

本次有内部版本更新的 Provider：网易云音乐 1.1.5、QQ 音乐 1.1.5、Spotify 1.1.5、汽水音乐 1.2.5、酷狗音乐 1.1.8、LX Music 1.0.2。Apple Music 与 Poweramp 本次无需单独升级。

升级说明

• 请将 Bridge 与正在使用的 Provider 从本次 Release 一起更新；升级后重启设备，或至少重启 SystemUI 与对应播放器进程。
• 如 LX Music 仍复现“切歌后歌词入口消失”，请导出 LSPosed 日志并筛选 [LX_PROBE]、LXMusicProbe 与 LockscreenLyrics，不要附带完整歌词正文。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.4.1.apk
• LyricProvider-QQMusic-v3.4.1.apk
• LyricProvider-163Music-v3.4.1.apk
• LyricProvider-AppleMusic-v3.4.1.apk
• LyricProvider-Poweramp-v3.4.1.apk
• LyricProvider-Spotify-v3.4.1.apk
• LyricProvider-QiShui-v3.4.1.apk
• LyricProvider-KuGou-v3.4.1.apk
• LyricProvider-LXMusic-v3.4.1.apk
• LyricProvider-v3.4.1.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐启用“还原内联钩子”，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.4.0

v3.4.0 将 Bridge 与配套 LyricProvider 统一到新的歌词传递链路，重点是让完整歌词、逐字进度、翻译与切歌状态在 ColorOS 锁屏上更稳定地协同工作。

Bridge

• Bridge 主模块新增专属应用图标，替换此前的系统默认图标。
• 统一外部歌词 v4 传递协议，并按已登记的播放器与来源接收数据，减少切歌、后台恢复和播放器进程重载后的歌词丢失。
• 优化外部歌词的轨道切换、播放进度与翻译状态衔接；锁屏翻译按钮在播放器提供翻译时保持可用。
• 修复酷狗 Lite / 酷狗概念版部分逐字歌词行的渲染错位与空白问题。
• 优化逐字进度扫光和已播放文字的过渡，使高亮变化更连贯自然。
• 改进歌词开头清理：规则与逐曲“第一句正式歌词”不再被旧容量限制截断，跨歌词轨道时能更可靠地保留用户选择的首句。

LyricProvider

• 网易云音乐 Provider 兼容历史 9.0.40 的 :play 播放进程及荣耀版包名；对内置 LSPatch / DexKit 的特殊 APK 使用兼容初始化，避免冲突。
• 修复 QQ 音乐 QRC 原文与翻译时间戳存在偏差时的翻译行遗漏，改为按时序一对一对齐，并保留“无翻译”行的语义。
• 新增 LX Music Provider，支持 ToSide 与 Walnut 两个 LX Music 变体；可传递完整时间轴和可用的翻译歌词。
• QQ 音乐、网易云音乐、Apple Music、Poweramp、Spotify、汽水音乐、酷狗音乐/概念版与 LX Music 共 8 个 Provider 已统一适配 v4 链路。
• 保留 LyricProvider / 词幕原有功能；本次只调整面向 Bridge 的传递与诊断路径。

升级说明

• 请将 Bridge 与已安装的 Provider 一起更新，避免混用旧版 Provider。
• 首次安装或升级后请重启设备，使 SystemUI 与播放器进程重新加载模块。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.4.0.apk
• LyricProvider-QQMusic-v3.4.0.apk
• LyricProvider-163Music-v3.4.0.apk
• LyricProvider-AppleMusic-v3.4.0.apk
• LyricProvider-Poweramp-v3.4.0.apk
• LyricProvider-Spotify-v3.4.0.apk
• LyricProvider-QiShui-v3.4.0.apk
• LyricProvider-KuGou-v3.4.0.apk
• LyricProvider-LXMusic-v3.4.0.apk
• LyricProvider-v3.4.0.zip

Provider 为独立 LSPosed 模块，只需安装自己使用的播放器对应 APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐启用“还原内联钩子”，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.3.1

v3.3.1 主要完善歌词排版和设置页操作，并修复一类短英文逐字歌词识别问题。AOD 首次挂载、prime、槽高和低刷新时序继续沿用 v3.3.0 的已验证基线。

Bridge

• 新增独立的“歌词内换行额外间距”，范围为 -1–8dp、步进 0.5dp。它只调整同一条歌词内部的换行，不影响歌词条目之间的间距；锁屏槽高、两行浏览窗口和设置预览共用同一套计算，总内部行距不会小于 0dp。
• 主歌词可调字号上限从 26sp 提高到 28sp；没有翻译的布局继续自动增加 2sp，实际最高 30sp。翻译和无翻译布局现在使用统一的字体度量换行策略，改善较大字号下的中文、日文等长句排版。
• 设置页新增“重启系统界面”按钮。请求通过模块已有的 signature 权限广播交给 SystemUI，并返回接收确认；如果模块尚未加载到 SystemUI，会提示用户先重启设备。
• 修复类似 “You move on” 的短英文逐字歌词在同时间戳双语组中被误判成翻译的问题，并补充解析回归测试。
• 重新编写原仓库及 LSPosed 仓库的中英文 README，以更清晰的方式说明模块功能、设备要求、播放器适配、Provider 安装和常见问题。
• 保持已验证的 AOD 首次 attach、prime、槽高、官方行缩放与低刷新切换路径不变。

LyricProvider

本次没有修改 Provider 侧适配逻辑。Release 工作流仍会从当前 Andrea-lyz/LyricProvider 的 master 构建并发布 7 个独立 Provider APK；建议 Bridge 与已安装的 Provider 一并更新，避免 Release 版本混用。

验证

• Bridge：testDebugUnitTest、assembleDebug、lintDebug、LSPosed metadata 校验和 git diff --check 通过。
• 新增并更新了短英文主歌词选择、配置序列化、字号上限、换行间距边界、预设识别和槽高计算单元测试。
• AOD 相关实现未改变；本版本不引入新的 AOD 可见性、透明度、尺寸或 readiness 门控。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.3.1.apk
• LyricProvider-QQMusic-v3.3.1.apk
• LyricProvider-163Music-v3.3.1.apk
• LyricProvider-AppleMusic-v3.3.1.apk
• LyricProvider-Poweramp-v3.3.1.apk
• LyricProvider-Spotify-v3.3.1.apk
• LyricProvider-QiShui-v3.3.1.apk
• LyricProvider-KuGou-v3.3.1.apk
• LyricProvider-v3.3.1.zip

Provider 为独立的 LSPosed 模块，不会打包进 Bridge APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐开启“还原内联钩子”，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.3.0 - 强烈建议更新！

v3.3.0 重点改善 ColorOS/SystemUI 版本兼容性，并对全部 LyricProvider 的播放状态、曲目切换和歌词提交链路进行统一收束。
建议 Bridge 与已安装的 Provider 一并更新。

Bridge

• 不再依赖固定混淆字段名控制官方歌词行距和非活动行缩放；新增经指纹验证的兼容布局，并在未知 SystemUI 版本上使用 DexKit 语义解析。无法唯一确认字段时安全保留官方默认值，避免错误写入私有字段。
• 外部歌词在后台预处理阶段即应用当前“歌词开头信息清理”配置，并缓存清理后的逐字模型和提交载荷，避免 SystemUI 接收前后行数变化造成切歌时部分歌词延迟出现。
• 收紧 RecyclerView 所有权、绑定重试、官方绘制抑制和解析 trace 日志。常规运行保持静默；逐帧诊断使用主 Tag VERBOSE，完整解析日志使用 LockscreenLyricsParse=VERBOSE。
• 保持已验证的 AOD 首次 attach、prime、槽高与低刷新时序不变。

LyricProvider

• 为网易云、QQ 音乐、Spotify 和汽水音乐统一播放状态提交策略，降低启动首曲、切歌、暂停恢复以及元数据/歌词异步到达时的旧数据回写与闪烁风险。
• 抽取统一的 Bridge 广播发送、播放状态提交、载荷大小控制和逐字片段兼容策略，并补充单元测试。
• 修复 QQ 音乐部分逐字歌词中的短重复片段无法显示，以及切歌时歌词分批出现的问题；空歌词占位等待窗口调整为 1200ms，明确下载失败时仍立即回退。
• 改进汽水音乐官方歌词获取、数据库缓存、KTV 逐字解析和曲目身份判断，兼容更多实际播放时序。
• 将相同的提交与身份保护推广到网易云、Apple Music、酷狗、Poweramp 和 Spotify；降低常规成功、缓存命中和提交日志噪声，WARN/ERROR 继续保留。

Provider 内部版本：

• QQ Music：1.1.3 / versionCode 8
• NetEase Cloud Music：1.1.3 / versionCode 13
• Apple Music：1.1.2 / versionCode 10
• Spotify：1.1.3 / versionCode 9
• QiShui Music：1.2.3 / versionCode 6
• KuGou Music：1.1.6 / versionCode 11
• Poweramp：1.0.13 / versionCode 10

验证

• Bridge：testDebugUnitTest、assembleDebug、lintDebug、LSPosed metadata 校验和 git diff --check 通过。
• 7 个随附 Provider：单元测试、assembleDebug 与 lintDebug 通过。
• 已实机验证网易云、QQ 音乐、Spotify、汽水音乐、Apple Music、酷狗和 Poweramp 的播放、切歌与锁屏歌词链路。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.3.0.apk
• LyricProvider-QQMusic-v3.3.0.apk
• LyricProvider-163Music-v3.3.0.apk
• LyricProvider-AppleMusic-v3.3.0.apk
• LyricProvider-Poweramp-v3.3.0.apk
• LyricProvider-Spotify-v3.3.0.apk
• LyricProvider-QiShui-v3.3.0.apk
• LyricProvider-KuGou-v3.3.0.apk
• LyricProvider-v3.3.0.zip

Provider 为独立的 LSPosed 模块，不会打包进 Bridge APK。汽水音乐用户仍需在 LSP 管理器中为汽水音乐开启“还原内联钩子”，并按管理器提示处理 libart.so。

Donate

ColorOS Live Lyrics Bridge v3.2.1

v3.2.1 收束锁屏歌词的渲染职责与界面切换时序。亮屏阶段由 ColorOS SystemUI 独占当前行索引、seek 定位、平滑滚动、页面过渡和行缩放；模块只负责逐字、颜色、光晕、模糊、排版与受限槽位几何。该调整修复拖动进度后概率回落官方渲染、从解锁/指纹界面返回歌词页时非实时行延迟出现、居中或右对齐缩放错位，以及切歌模型替换时的歌词位移和生硬跳变，同时保持已验证的 AOD 首次 attach、prime 与低刷新路径不变。

亮屏渲染职责

• 亮屏时完整放行官方 LyricsRecyclerView.setCurrentLyric 链路，不再由模块主动 prime、强制定位、停止滚动或修正 seek；官方当前索引 n 优先作为活动行依据。
• AOD 或非交互屏幕继续保留既有一次性 prime 与定位兜底，不把亮屏改造扩展到已验证的 AOD 时序。
• 非活动行缩放只写入官方缩放参数，由 SystemUI 状态机执行实际缩放与动画；移除 Canvas 第二次缩放，避免活动态、逐字态和页面交叉淡入不同步。
• RecyclerView、页面 alpha、visibility、translation 和 ViewPropertyAnimator 始终归 SystemUI 所有，模块不再通过整体 View alpha 实现切歌过渡。

Seek 与界面切换

• 同一曲目回拉或跳转进度时保留已经就绪的外部逐字模型，不再把播放位置跳变误当成需要清空自绘渲染器的曲目重启。
• 瞬时找不到可见 RecyclerView 时增加受限过渡宽限；已存在歌词模型和界面切换信号时不会立即退出歌词模式。
• 每个 RecyclerView 独立维护活动目标、绑定 epoch 和自定义帧状态；重复歌词使用 adapter position 消歧，唯一歌词不会因 RecyclerView pre-layout 的瞬时位置错位被拒绝。
• RecyclerView attach、重新可见和模型提交会执行最多 6 帧/120ms 的纯像素 render pass。只有当前表面的可映射绑定行都已生成同一模型的自定义帧后才提前结束 handoff，避免某一帧回落官方字体或只显示实时行。
• 当缓存行都属于已隐藏表面时，会从当前已附着 RecyclerView 重新发现候选 TextView；恢复过程只更新绘制引用和 invalidate，不触碰索引、滚动或槽位坐标。

对齐、缩放与切歌过渡

• 左对齐、居中和右对齐均按实际内容区域计算官方缩放 pivot；首次布局前使用 measured size，尺寸变化后重新校正，修复居中视觉漂移和右对齐放大方向错误。
• 新歌词模型发布后，亮屏绘制会等待内容决定的槽位高度完成一次几何提交，避免先用上一首歌的行高绘制新歌词后再次位移。
• 几何提交完成后仅对模块自绘歌词像素执行一次轻量淡入，不修改 RecyclerView alpha；“关闭动效”和 AOD 路径不执行该淡入。
• 字号、字重、对齐和模型替换只清理必要的绘制、换行、光晕与绑定缓存，不接管官方滚动事务。

诊断与测试

• 增加亮屏/AOD 渲染所有权快照，可核对 owner、官方索引、可见范围、子项数量和目标中心；亮屏应显示 owner=systemui。
• 新增同曲 seek 保留、瞬时 surface miss、官方索引优先、亮屏/AOD 定位职责、缩放钳制、几何提交屏障、动效关闭和首次布局 pivot 回归测试。
• 实机已覆盖进度拖动、解锁/指纹界面往返、居中/右对齐、75%/90% 非活动缩放、连续切歌和 AOD 往返；未再观察到官方渲染回落、非实时行延迟、视觉对齐错乱或歌词行抖动。
• testDebugUnitTest、assembleDebug、lintDebug、LSPosed metadata 校验和 git diff --check 均通过；Lint 无错误，仅保留既有的版本兼容、依赖、资源反射和一次性 DexKitBridge 提示。

LyricProvider

• LyricProvider 协议和代码保持不变，已安装 v3.1.0/v3.2.0 Provider 的用户无需更新；Release 继续附带全部 Provider APK 与合集，便于首次安装或补装。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.2.1.apk
• LyricProvider-QQMusic-v3.2.1.apk
• LyricProvider-163Music-v3.2.1.apk
• LyricProvider-AppleMusic-v3.2.1.apk
• LyricProvider-Poweramp-v3.2.1.apk
• LyricProvider-Spotify-v3.2.1.apk
• LyricProvider-QiShui-v3.2.1.apk
• LyricProvider-KuGou-v3.2.1.apk
• LyricProvider-v3.2.1.zip

Donate

ColorOS Live Lyrics Bridge v3.2.0

v3.2.0 在 v3.1.0 自定义能力的基础上完成设置链路、解析稳定性与渲染性能收束。本版本修复设置链路可能覆盖外观配置、极近时间戳的歌词开头信息可能干扰逐字行匹配，以及自绘歌词每帧触发 SystemUI 全量测量与布局的问题；不改变既有 RecyclerView prime、滚动、槽位动画或 AOD 低刷新时序。

设置链路热修

• 播放器翻译设置只更新全局翻译默认值、播放器默认值和清除记忆请求，不再携带并回写可能过期的完整外观快照，避免居中、字号、行距、透明度和光晕等设置被意外恢复。
• 修复设置页 Spinner 初始化回调可能被误判为用户操作的问题，避免进入页面或重新绑定预设时意外应用“默认”预设。
• 修复设置页首次绑定发生在滑块监听器安装之前时，数值文字仍停留在控件下限的问题；保存后重新进入页面，透明度、模糊、缩放、光晕、字号、翻译比例和行距的文字会与滑块及实际配置一致。
• 页面因系统重建时会保存并恢复尚未提交的配置草稿，减少旋转、窗口重建等场景下的编辑内容丢失。
• 设置广播增加单调递增 revision、来源标识和受保护的 ResultReceiver 回执；设置页会区分“已保存”“SystemUI 已应用”“SystemUI 拒绝”和“未收到确认”。
• Logcat 增加 settings-send、settings-receive、settings-applied、settings-ack 和 settings-rejected 事件，并记录 revision、来源和最终对齐值，便于诊断偶发的设置未生效或对齐回退。
• 修正悬浮预览相对标题栏边界的坐标换算，优先使用实际 ActionBar 容器底边，避免预览框贴到屏幕顶端或遮挡标题栏。
• 设置页滑块改用不注册系统手势排除区的轻量控件，避免长页面滚动时每帧为多个原生滑块反复计算手势排除区与避让区。
• 设置页窗口稳定请求最高 120 Hz，并关闭独立的触摸升频投票；Android 15 及以上启用帧率省电平衡提示，使 LTPO 面板仍可在内容静止时向下自适应，避免滚动期间在 60/120 Hz 间反复切换造成 Buffer Stuffing。
• 合并悬浮预览的位置更新到下一帧执行，复用坐标缓存，并跳过没有变化的位移和阴影高度写入；滚动期间将整块预览临时缓存为硬件层，停止 160ms 后释放，降低主线程与 RenderThread 的重复绘制，同时不长期占用额外显存。

歌词解析与显示修复

• 修复极近时间戳的开头信息被 Accompanist 误合并为双语歌词的问题。例如相邻的“作词”“作曲”和第一句双语歌词会重新保持各自时间轴行，避免后续 RecyclerView 索引整体错位。
• 解决关闭所有可选歌词开头清理规则后，部分歌词可能出现逐字进度中途消失、相邻同文歌词同时高亮，以及制作信息异常放大的问题。
• 修复仅拆分能够确认吸收了非歌词信息的解析行；其余歌词继续保留上游逐字区间和翻译匹配结果，避免对正常的轻微错位双语歌词造成影响。
• 增加受频率限制的官方绘制回退诊断，记录模型缺失、行匹配失败和绘制异常，同时继续将 Hook 范围限制在 LyricsRecyclerView 内。

SystemUI 渲染性能热修

• 将官方歌词 TextView 的字体内边距和最小高度准备改为幂等操作：属性已经满足要求时不再重复调用 setter。
• 修复自绘路径每帧调用 TextView.setMinHeight(0) 并触发 requestLayout()，导致整个锁屏通知面板几乎每帧重新 measure/layout 的问题。
• 保留逐字进度、光晕、模糊和滚动的原有刷新节奏；不通过降帧隐藏 CPU 开销，也不修改翻译展开/收起的真实槽位动画。
• 不移动或延迟 LyricsRecyclerView 首次 attach、prime、setCurrentLyric、可见行高度同步及 AOD 低刷新路径。

刷新率与媒体封面

• 将“最大动态刷新率”更名为“歌词刷新上限”，并明确该设置只限制歌词内容重绘，不会强制 ColorOS 将锁屏物理刷新率升至 90/120 Hz；系统降至 60 Hz 时歌词也会随之降至 60 帧。
• 固定 60/90/120 Hz 改为按显示帧时间做截止时间节拍。修复 90 Hz 在 120 Hz 屏幕上因毫秒取整而实际退化为逐 VSync 刷新的问题，同时不会在物理屏幕已经降频时虚构额外帧。
• 修复 Salt Player 冷启动首曲歌词结果回写与异步封面加载竞争的问题：歌词元数据只进行一次延迟发布，并在发布前重新读取当前 MediaSession 元数据和核对曲目身份，不再用较早保存的元数据快照覆盖刚更新的封面。
• 歌词元数据发布日志增加位图尺寸、generation、对象标识和 URI 摘要，后续若仍出现播放器自身上报旧封面的情况，可以区分播放器源数据与 SystemUI 缓存问题；不会复制、清空或修改封面像素。

修复测试结果

同一设备、模块开启并使用 Salt Player 锁屏歌词的 60 秒 Perfetto 前后对比结果如下：

• 官方锁屏歌词参考样本的 SystemUI 主线程为 14.56%、RenderThread 为 24.45%、measure/layout 各 99 次/分钟；优化后主线程开销已接近官方参考路径。官方样本为维持亮屏包含周期唤醒命令，因此只作为参考，不作为严格的整机耗电等价对照。
• 修复前后均保持约 60 帧/秒的歌词绘制采样，性能下降并非通过关闭逐字刷新或降低亮屏歌词帧率取得。
• 修复后 Perfetto 有效时长为 59.991 秒，未发现跟踪数据丢失或非信息级 trace stats 错误。
• testDebugUnitTest、assembleDebug、lintDebug 和 git diff --check 均通过；Lint 无错误，仅保留既有的兼容性、依赖版本、资源反射和一次性 DexKitBridge 解析提示。
• 新增配置 round-trip、播放器翻译不得覆盖外观、设置 revision 单调性、悬浮预览坐标和极近时间戳开头信息解析回归测试。
• 新增 60/90/120 Hz 截止时间节拍单测；设置页 120 Hz 连续滚动 CPU 通常约 30%、峰值约 40%，与系统设置页同类滚动负载接近，停止滚动后正确回落到接近 0%，未发现持续后台占用。
• 冷启动首曲封面发布增加当前曲目身份复核与诊断信息；播放器强制停止后的首曲概率场景仍建议后续持续观察。

LyricProvider

• LyricProvider 协议和代码保持不变，已安装 v3.1.0 Provider 的用户无需更新；本次问题均在 Bridge 设置、解析和 SystemUI 绘制侧修复。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.2.0.apk
• LyricProvider-QQMusic-v3.2.0.apk
• LyricProvider-163Music-v3.2.0.apk
• LyricProvider-AppleMusic-v3.2.0.apk
• LyricProvider-Poweramp-v3.2.0.apk
• LyricProvider-Spotify-v3.2.0.apk
• LyricProvider-QiShui-v3.2.0.apk
• LyricProvider-KuGou-v3.2.0.apk
• LyricProvider-v3.2.0.zip

Donate

ColorOS Live Lyrics Bridge v3.1.0

v3.1.0 完成歌词设置、渲染和内容清理的系统化升级。本版本开放安全的外观与排版自定义，同时把配置、预览、广播、缓存和 SystemUI 绘制收束到同一套版本化模型，并保持已验证的 AOD 首次挂载与低刷新路径。

歌词外观与预览

• 新增“默认、柔和、醒目、极简”四种外观预设；手动修改预设所管理的字段后自动显示为“自定义”。
• 开放非活动歌词透明度、模糊、非活动缩放、光晕强度与半径、主色/光晕色、动效等级、长歌词纵向浏览和长翻译横向滚动。
• 开放主歌词字号、翻译字号比例、字重、左对齐/居中/右对齐和 -5–20dp 歌词行间距；所有预设的默认行距为 0dp。
• 最大动态刷新率可跟随屏幕或限制为设备支持的 60/90/120 Hz，仅限制歌词内容重绘，不强制改变屏幕刷新率；AOD 继续使用低刷新路径。
• 设置页预览显示当前行及后续两行的主歌词与翻译，复用锁屏槽高、排版、行距、缩放和对齐策略；滚动后会平滑吸附在标题栏下方，便于边调边看。
• “恢复默认外观”只重置外观字段，不修改屏幕保活、刷新率、播放器翻译默认值或歌词内容清理策略。

稳定自适应布局

• 歌词物理槽位按换行、翻译和排版配置稳定计算，保留最小高度、字体上下边界与底部安全空间，修复 g 等下伸字符的轻微裁剪。
• 主歌词仍最多同时显示两行；超过两行时保留完整换行结果，并在固定两行视窗内按歌词进度平滑展示后续内容，避免复杂歌词忽大忽小。
• 翻译展开/收起重新压缩 RecyclerView 行高，并以统一动画进度同步所有可见行和当前行锚点，减少突跳和掉帧；AOD 只应用一次终态高度。
• 修正居中与右对齐时的缩放原点、视觉中心和长文本浏览方向；设置项使用“左对齐/居中/右对齐”可读名称。
• 同步 AOD/亮屏切换时的光晕与逐字效果，并统一 AOD 当前主歌词和翻译行亮度。

播放器翻译与歌词开头清理

• “播放器翻译设置”迁移到“兼容与屏幕”中的独立页面，可按播放器设置默认翻译并单独清除记忆；Salt Player 与 ConePlayer 始终显示，Provider 播放器会根据对应 APK 是否安装自动灰置。
• 新增“歌词开头信息清理”二级页面，以开关提供常见版权声明、制作/乐器信息和“歌名 - 歌手”开头规则；影响解析正确性的保护规则固定保留。
• 可一次性读取当前歌曲前 80 个时间轴行，直接选择第一句正式歌词；逐曲修正绑定原始 trackKey 与行指纹，不依赖易变化的行号。
• 可从未识别行中选择安全的前缀或整行格式供其他歌曲复用，无需编写正则或 DSL；规则受开头 30 秒、32 个候选、32 条规则和 4 KiB 快照等边界限制。
• 移除原计划中的展示元数据 DSL；清理只影响模块生成的歌词显示，不修改 MediaSession、Provider 原始数据、曲目身份或歌词时间轴。

配置、日志与解析

• 引入不可变、版本化歌词 UI 配置及统一校验、迁移和 SharedPreferences 仓库；设置采用“保存并应用”，保存前只更新预览。
• 设置广播从外部歌词 Receiver 中拆分，并使用 signature 权限保护；未知未来 schema 会被拒绝，缺失字段保持当前配置。
• Accompanist Lyrics Core 从 0.4.5 升级至 0.4.7，补充 YRC 逐字、LRC、TTML、翻译和逐字区间回归覆盖。
• Logcat 统一为 [进程][模块][事件] message | key=value，保留独立解析 Tag、长消息分块、控制字符转义和 LSPosed 必要错误镜像。
• Java 源码和构建显式使用 UTF-8；可见 Unicode 转义改为可读文字，不可见字符使用具名 code-point 常量。

设置与稳定性修复

• 修复设置二级页顶部被系统栏遮挡、输入框被输入法遮挡、自动填充干扰、选项文字未对齐和滚动预览闪退。
• “歌词显示时保持屏幕”更名为“歌词显示时保持屏幕点亮”，留空的自定义秒数继续表示默认常亮行为。
• 恢复 LSPosed 管理器中的模块图标占位，并保持应用图标、备份规则和 WindowInsets 配置完整。
• 保持 compileSdk/targetSdk 35；Android 36 版本提示作为独立兼容性工作，不使用全局 Lint 基线隐藏。

LyricProvider

• QQ 音乐、网易云音乐、Spotify、汽水音乐和 Poweramp Provider 不再提前删除开头制作信息，只过滤空行并排序，将显示级清理统一交给 Bridge/SystemUI。
• Poweramp 的普通歌词与行内括号歌词路径均保留带时间轴的开头信息。
• 酷狗 Provider 加强车载歌词展示元数据与乱码制作信息识别，避免展示文本被误当成稳定曲目身份。
• 更新受影响 Provider 内部版本，旧版仍可提供歌词，但需要更新后才能完整使用可配置的开头信息清理。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.1.0.apk
• LyricProvider-QQMusic-v3.1.0.apk
• LyricProvider-163Music-v3.1.0.apk
• LyricProvider-AppleMusic-v3.1.0.apk
• LyricProvider-Poweramp-v3.1.0.apk
• LyricProvider-Spotify-v3.1.0.apk
• LyricProvider-QiShui-v3.1.0.apk
• LyricProvider-KuGou-v3.1.0.apk
• LyricProvider-v3.1.0.zip

Donate

ColorOS Live Lyrics Bridge v3.0.4

v3.0.4 完善了关闭“普通逐行伪逐字”后的长歌词显示：普通逐行歌词换行超过两行时，不再固定截断在前两行，而是在保持两行视窗和既有 RecyclerView 几何不变的前提下，随整句播放进度平滑展示后续内容。

Bridge 改进

• 普通逐行歌词关闭伪逐字后，三行正文使用固定两行裁剪视窗，从第 1、2 行平滑移动至第 2、3 行。
• 被动滚动完全由当前歌词的行时间轴驱动，不额外模拟字级时间，也不绘制伪逐字高亮。
• 滚动采用 21.5%～78.5% 的有效进度区间和五次平滑插值，起步、停止更柔和，中段移动更自然。
• 暂停时滚动位置冻结，恢复后继续；拖动播放进度时直接落到对应位置，避免独立动画时钟造成漂移。
• 仅在符合条件的当前长歌词需要移动时保持显示帧率刷新；普通短句和静止状态继续走较低刷新频率。
• 重复或回收中的非当前歌词 holder 不会覆盖当前行的刷新判断。

稳定性边界

• 不改变 LyricsRecyclerView 的滚动位置、item 定位、prime 或 setCurrentLyric 时机。
• 不修改普通 SystemUI TextView；裁剪和自绘仍只作用于歌词 RecyclerView 内部。
• AOD 继续沿用已验证的低帧率与首次 attach 时序，不启用本次连续被动滚动。

LyricProvider

• LyricProvider 代码与内部版本保持不变，已安装的 Provider 无需更新；Release 仍附带各播放器 Provider APK 和合集，便于首次安装或补装。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.4.apk
• LyricProvider-QQMusic-v3.0.4.apk
• LyricProvider-163Music-v3.0.4.apk
• LyricProvider-AppleMusic-v3.0.4.apk
• LyricProvider-Poweramp-v3.0.4.apk
• LyricProvider-Spotify-v3.0.4.apk
• LyricProvider-QiShui-v3.0.4.apk
• LyricProvider-KuGou-v3.0.4.apk
• LyricProvider-v3.0.4.zip

Donate

ColorOS Live Lyrics Bridge v3.0.3

v3.0.3 是针对部分 ColorOS 16 / SystemUI 版本启动崩溃的兼容性修复版本，重点解决启用模块后冷启动卡在锁屏界面、SystemUI 主线程 ANR 并进入 LSPosed 安全模式的问题。

Bridge 修复

• 移除全局 ClassLoader.loadClass(String, boolean) Hook，避免在 SystemUI 主线程拦截所有类加载并引发高负载或 ANR。
• 改为仅 Hook OPlus OPlusPluginClassLoader 构造过程，在实际歌词插件 ClassLoader 上安装 LyricsRecyclerView 相关 Hook，并保留首次 View attach 的兜底路径。
• 防止可选的 RecyclerView 通知保护方法缺失时重复安装 setCurrentLyric Hook，降低不同 SystemUI 变体上的重复拦截风险。
• 将歌词 RecyclerView 匹配缓存中的 View 引用改为弱引用，避免静态缓存意外持有 SystemUI View 层级。
• 收紧 LyricsRecyclerView 类型判断，避免误匹配普通 SystemUI View；AOD 首次 attach、透明、位移或 0x0 状态的既有时序保持不变。

兼容性验证

• 在 OnePlus PJZ110、Android 16、SystemUI 16.0.9.401 测试机上完成冷启动与多轮 AOD/亮屏切换测试。
• 测试日志中未出现 SystemUI ANR、崩溃或 LSPosed 安全模式回退；歌词索引和 AOD 切换保持正常。

LyricProvider

• LyricProvider 代码与内部版本保持不变，已安装的 Provider 无需更新；Release 仍附带各播放器 Provider APK 和合集，便于首次安装或补装。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.3.apk
• LyricProvider-QQMusic-v3.0.3.apk
• LyricProvider-163Music-v3.0.3.apk
• LyricProvider-AppleMusic-v3.0.3.apk
• LyricProvider-Poweramp-v3.0.3.apk
• LyricProvider-Spotify-v3.0.3.apk
• LyricProvider-QiShui-v3.0.3.apk
• LyricProvider-KuGou-v3.0.3.apk
• LyricProvider-v3.0.3.zip

Donate

ColorOS Live Lyrics Bridge v3.0.2

v3.0.2 是 v3.0.1 的歌词交接与渲染细节修复版本，重点处理 Apple Music 自动切歌偶发“暂无歌词”，以及普通逐行歌词启用伪逐字时末句进度过快完成的问题。

Bridge 修复

• Apple Music 外部歌词交接改为优先跟随 Bridge MediaSession 的最新曲目元数据，避免队列预加载或旧的播放器回调把 Bridge 重新指向上一首/下一首歌曲。
• Apple Music 歌词到达后增加受限的 SystemUI 元数据刷新重试，并过滤同一交接窗口内会把旧歌词重新推进来的陈旧播放状态，降低自动切歌后短暂显示“暂无歌词”的概率。
• 普通逐行歌词的伪逐字模式不再给最后一句使用固定的 600ms 结束时间；会根据前面歌词节奏和末句文本长度估算显示时长，并限制在合理范围内。真实逐字时间轴和显式结束时间不受影响。
• 保持 v3.0.1 已验证的 AOD、锁屏岛切换、RecyclerView 通知保护和 SystemUI 性能优化行为不变。

LyricProvider 修复

• Apple Music Provider：MediaSession 元数据作为 Bridge 曲目身份的权威来源，避免 PlaybackItem 队列预加载覆盖当前曲目，并确保已构建的歌词发送到正确的 Bridge generation。
• Poweramp Provider：兼容不同 Poweramp 版本中以 Int 或 Long 提供的歌词时长字段。
• 本次随发布的 7 个 Bridge Provider 均递增内部 versionCode 与 versionName，安装过旧 Provider 的用户需要更新对应 APK。

Provider 版本

• QQ Music Provider：1.1.1 / versionCode 6
• NetEase Cloud Music Provider：1.1.1 / versionCode 11
• Apple Music Provider：1.1.1 / versionCode 9
• Spotify Provider：1.1.1 / versionCode 7，当前仍仅支持原文歌词，不支持翻译
• QiShui Music Provider：1.2.1 / versionCode 4
• KuGou Music Provider：1.1.4 / versionCode 9
• Poweramp Provider：1.0.11 / versionCode 8

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.2.apk
• LyricProvider-QQMusic-v3.0.2.apk
• LyricProvider-163Music-v3.0.2.apk
• LyricProvider-AppleMusic-v3.0.2.apk
• LyricProvider-Poweramp-v3.0.2.apk
• LyricProvider-Spotify-v3.0.2.apk
• LyricProvider-QiShui-v3.0.2.apk
• LyricProvider-KuGou-v3.0.2.apk
• LyricProvider-v3.0.2.zip

Donate

ColorOS Live Lyrics Bridge v3.0.1

v3.0.1 是基于 v3.0.0 的性能与渲染稳定性维护版本，重点降低未使用锁屏歌词时对 SystemUI 的后台开销，并继续收紧只应作用于歌词界面的保护逻辑。

SystemUI 性能优化

• 歌词区域隐藏后立即停止逐帧刷新、可见性恢复与延迟回调；不会因已隐藏的歌词界面继续保留刷新循环。
• Provider 广播在主线程只做轻量校验和快照，歌词解析转入有界后台执行器，降低切歌和媒体状态变化时的主线程压力。
• 歌词局部 View Hook 在无歌词模型、非歌词视图或无活动歌词界面时更早返回，并避免普通路径的临时对象分配与重复祖先查找。
• 移除全局日志 Hook，收紧 OPlus 白名单绕过范围；RecyclerView 通知保护仅作用于官方歌词 Adapter，不再触及普通 SystemUI 列表。

渲染与稳定性

• 修复锁屏岛界面切换时偶发回落到官方大字歌词、短暂闪烁后才恢复模块渲染的问题；过渡期间使用有时限的歌词局部恢复机制，不保留后台刷新。
• Apple Music 在同一播放会话切歌时，允许已确认的最新 generation 歌词绕过陈旧的 SystemUI 曲目标题完成晋升，减少歌词已到达但仍显示“暂无歌词”的情况。
• 保持 v3.0.0 已验证的亮屏到 AOD 歌词首帧与布局时序，不引入新的 AOD 可见性、透明度或尺寸门控。

日志与安装

• 发布版默认只保留必要警告和错误；详细歌词诊断仍需显式开启对应 debug tag。
• Bridge 内部版本更新为 3.0.1 / versionCode 115。LyricProvider 内部版本未变化，已安装的 Provider 无需重装；Release 仍附带全部 Provider APK 与合集，便于首次安装或补装。

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.1.apk
• LyricProvider-QQMusic-v3.0.1.apk
• LyricProvider-163Music-v3.0.1.apk
• LyricProvider-AppleMusic-v3.0.1.apk
• LyricProvider-Poweramp-v3.0.1.apk
• LyricProvider-Spotify-v3.0.1.apk
• LyricProvider-QiShui-v3.0.1.apk
• LyricProvider-KuGou-v3.0.1.apk
• LyricProvider-v3.0.1.zip

Donate

ColorOS Live Lyrics Bridge v3.0.0

这是一次面向锁屏歌词完整链路的大版本更新。相较 v2.7.2，本版重构了 Bridge 与各 LyricProvider 的切歌、歌词到达和播放状态交接，修复多类“暂无歌词”、旧歌词残留、逐字进度错位和 AOD 切换抖动问题，为偶发 SystemUI 崩溃增加定向保护，并进一步降低 SystemUI 绘制热路径与调试日志的开销。

重大更新

• 统一 QQ 音乐、网易云音乐、Apple Music、Poweramp、Spotify、汽水音乐和酷狗音乐 Provider 的 Bridge 事件模型：使用曲目 generation 区分 trackChanged 与 lyricReady，对需要外部状态的 Provider 继续区分 playbackState，丢弃异步返回的旧曲歌词，并对重复 payload 和高频播放状态广播去重。
• 重做外部歌词切歌交接：在新曲歌词尚未到达、播放器 metadata 短暂抖动或 SystemUI RecyclerView 正在换行绑定时，保持曲目身份和渲染状态一致，减少“暂无歌词”、上一首歌词闪回、边界外首句和淡化未完成等问题。
• 稳定亮屏到 AOD 的歌词绘制：沿用 SystemUI 官方首帧 prime 和布局时序，降低 AOD 低帧率模式下的连续刷新与复杂进度效果，修复靠近绘制区域下边界的歌词异常抖动。
• 新增严格限定在 LyricsRecyclerView 的 RecyclerView Adapter 通知保护，仅拦截布局计算期间的对应 IllegalStateException，降低切歌和状态变化时 SystemUI 偶发崩溃风险。

播放器修复

• ConePlayer：兼容“媒体通知（车载蓝牙）歌词”复用媒体元数据的情况，避免临时歌词行被误判为切歌后令锁屏显示“暂无歌词”，同时保留原有车载歌词功能。
• Spotify：改善首次歌词到达等待、快速切歌、播放进度接续和无歌词曲目处理；当前仍仅支持原文歌词，暂不支持翻译。
• QQ 音乐：修复切歌后旧歌词偶发重复、首句越界，以及快速切歌后歌词淡化或渲染状态未完整恢复的问题。
• 网易云音乐：补齐曲目 generation、播放状态和旧异步结果过滤，降低快速切歌时的错绑风险。
• Apple Music：修复暂停时歌词区域闪现、部分歌曲长时间“暂无歌词”、显示文本与逐字数据不一致及逐字进度错位；增加匹配 PlaybackItem 的请求重试，并兼容交叉渐入渐出期间的曲目交接。
• Poweramp：补齐显式 trackChanged、lyricReady 事件并复用一次生成的歌词 payload；播放状态保持由原生 MediaSession 单路提供；规范化方括号行内逐字时间戳，兼容 durMs 以 Int 或 Long 提供的不同 Poweramp 版本，并在官方索引短暂落后时让放大行回跟实际进度，避免拖动或恢复播放后歌词越界、滚动行与高亮行错位。
• 汽水音乐：优化歌词对象、缓存和播放状态的接管顺序，修复部分有歌词歌曲仍显示“暂无歌词”，并让切歌交接更自然。
• 酷狗音乐/概念版：过滤缺少有效曲目身份的早期播放状态，保留稳定 generation 与歌词 payload，降低启动和切歌竞态。

歌词解析

• 修复部分增强 LRC 的非递增逐字时间戳被降级后误挂到上一句翻译的问题，避免主歌词重复显示或翻译错位。
• 修复英文短句 You you 与中文翻译 你 你 同时间戳时被误判为拼音、使翻译行成为主歌词的问题。

性能与日志

• 减少 SystemUI TextView.onDraw 热路径中的重复父级查找、可见区域计算、时间读取和临时对象分配；相同歌词行的最近绘制缓存改为原位刷新。
• 普通逐行歌词在不需要逐帧进度效果时自动降低刷新频率；AOD 模式继续使用更保守的刷新节奏。
• Official lyric row scale 仅记录目标状态变化，不再在动画的每一帧重复输出；详细诊断仍可通过对应 debug tag 显式开启。
• QQ、网易云、Apple Music、Poweramp、Spotify、汽水和酷狗 Provider 的 Bridge 成功/跳过日志统一受 debug tag 控制，发布版默认只保留必要警告和错误；Poweramp 的内部反射探针仅在显式开启 debug tag 后安装。

Provider 版本

• QQ Music Provider：1.1.0 / versionCode 5
• NetEase Cloud Music Provider：1.1.0 / versionCode 10
• Apple Music Provider：1.1.0 / versionCode 8
• Spotify Provider：1.1.0 / versionCode 6
• QiShui Music Provider：1.2.0 / versionCode 3
• KuGou Music Provider：1.1.3 / versionCode 8
• Poweramp Provider：1.0.10 / versionCode 7

Release 资产

• ColorOS-Live-Lyrics-Bridge-v3.0.0.apk
• LyricProvider-QQMusic-v3.0.0.apk
• LyricProvider-163Music-v3.0.0.apk
• LyricProvider-AppleMusic-v3.0.0.apk
• LyricProvider-Poweramp-v3.0.0.apk
• LyricProvider-Spotify-v3.0.0.apk
• LyricProvider-QiShui-v3.0.0.apk
• LyricProvider-KuGou-v3.0.0.apk
• LyricProvider-v3.0.0.zip