Repository navigation
v4.5.1
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，不进入播放器进程。
| Provider | 版本 | Provider | 版本 |
|---|---|---|---|
| Salt | 1.1.2 (8) | Cone | 1.1.2 (4) |
| KuWo | 1.2.2 (5) | LX | 1.2.1 (4) |
| Poweramp | 1.2.1 (4) | Metrolist | 1.2.1 (4) |
| 酷狗 | 1.2.4 (7) | QQ 音乐 | 1.2.1 (4) |
| 网易云 | 1.2.1 (4) | Apple Music | 1.2.1 (4) |
| Spotify | 1.1.2 (4) | 汽水音乐 | 1.1.2 (4) |
| 通用播放器 | 1.1.2 (4) | Readify | 1.0.2 (3) |
| 动态封面（独立应用） | 1.0.6 (10) |
- 需要新功能时，从 v4.5.1 Release 安装 动态封面 Provider 1.0.6 覆盖 1.0.5；设置、绑定、网易云
登录与已下载的视频都会保留。 - 歌词 Provider 与 v4.5.0 相同，已安装的无需重装；Bridge 4.5.1 只有版本号变化，可按需覆盖安装。
- Bridge 作用域保持
system与com.android.systemui。 - 同一播放器仍只开一个 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.
| Provider | Version | Provider | Version |
|---|---|---|---|
| Salt | 1.1.2 (8) | Cone | 1.1.2 (4) |
| KuWo | 1.2.2 (5) | LX | 1.2.1 (4) |
| Poweramp | 1.2.1 (4) | Metrolist | 1.2.1 (4) |
| KuGou | 1.2.4 (7) | QQ Music | 1.2.1 (4) |
| NetEase | 1.2.1 (4) | Apple Music | 1.2.1 (4) |
| Spotify | 1.1.2 (4) | QiShui | 1.1.2 (4) |
| Universal Player | 1.1.2 (4) | Readify | 1.0.2 (3) |
| Dynamic Artwork (standalone app) | 1.0.6 (10) |
- 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. - 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. - Keep the Bridge scope at
systemandcom.android.systemui. - Still enable only one Provider per player: either its dedicated Provider or the Universal Player
Provider, as both writelyricInfoand overwrite each other.
Validation and known limits
- Local gates: 825 Provider tests (
testV5Matrixand 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
