Skip to content

v4.1.1

Choose a tag to compare

View all tags
@Andrea-lyz Andrea-lyz released this 06 Sep 19:52
· 60 commits to main since this release
138-4.1.1
b56aa3f

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

WeChat and Alipay donation QR code

Assets 18
Loading