Repository navigation
Releases
澜音 v2.6.19 · 旧 WebView 兼容与歌单功能
澜音 v2.6.19 · 旧 WebView 兼容与第一批歌单功能
修复与改进
- 修复 Android 12 / WebView Chrome 99 日志中的
AbortSignal.throwIfAborted is not a function,避免榜单和音源 HTTP 请求在发出前失败。 - 主页面与插件沙箱共用按需兼容脚本,补齐缺失的
AbortSignal.throwIfAborted、Object.hasOwn、Array.at;保留原生实现、取消原因与沙箱网络限制,不修改音源授权。 - 日志页新增 WebView 内核和兼容补齐诊断,播放器补充旧 WebView 高度回退。
- 包含此前本地 v2.6.18 的歌词预览窗口改进,保留圆形唱片、旋转、点击封面进入歌词等交互。
第一批新增功能
- 歌单搜索:搜索结果新增“歌单”栏,歌单与歌曲/歌词的关键词、来源、结果和滚动分别保留。可搜索本地歌单;远程歌单搜索取决于音源是否实际提供
playlists.search,查看详情另需playlists.get。 - 澜音每日精选(本地):从完整本地收藏、歌单与最近播放中去重轮换,每个本地自然日固定最多 30 首,支持单曲、播放全部和收藏。没有记录时显示空状态。
- 本地文件导入:“导入歌单 → 本地文件”支持 LX
.lxmcgzip JSON、已识别的.json和旧导出结构,提供预览、选择、新建/合并/替换、报告和撤销。未匹配音源的歌曲保留为待匹配,不冒充可播放;存储失败不覆盖原库。
范围说明
- 本地每日精选不是 QQ 等平台的个性化日推,也没有平台账号或播放时长算法。
- 聆澜等 LX 音源的音频权限不代表具备歌单关键词搜索、登录或个人歌单接口;不支持时会显示说明。
- 自定义图片/视频背景、音乐平台登录与个人歌单迁移、WebDAV 等同步、AES
.cpl/.cmpl、自动待匹配重绑定及完整 IndexedDB 迁移尚未完成。
安装与验证
- APK:
CeruMusic-Mobile-v2.6.19.apk - 包名:
com.ceru.music.mobile,版本:2.6.19,versionCode:24037。 - 大小:7,126,722 字节。
- APK SHA256:
374cafdd7cc910d198a46345b18b016b266a4d7f2e46f88ab385bc7891916fab - 与旧版签名一致,可覆盖安装保留数据;minSDK 23、targetSDK 34 未改变。请不要先卸载。
- Web / Android 构建、APK 签名与 64 个 Web 资源逐一校验通过;兼容、歌单搜索、文件导入、本地每日精选、存储与原播放器/导航回归检查通过,正式构建 66 项冒烟检查通过。
- 尚未进行 Android 真机验证。 删除原生 API 的浏览器模拟不等于实际 Chrome 99,受控 PCM WAV 测试不等于真实平台音源或手机后台播放验证。
- 若仍无法加载,请导出 v2.6.19 新启动之后的日志,保留 WebView 和“启动兼容”信息,并隐藏音源密钥。
另附与被测版本一致的源码 ZIP,SHA256:137640c1b8bae175ef45ac849aff15d2c9f71fad6d3b2a09f62251fdd2cb7032。
澜音 v2.6.17 · QQ 布局与每日更新提示
澜音 v2.6.17
本次包含自 v2.6.14 以来的 QQ 音乐式布局、播放器交互及更新提示改进。
界面与播放
- 首页、搜索、歌单、我的及歌单详情统一布局,底部改为“音乐 / 歌单 / 我的”。
- 播放器采用圆形唱片与封面模糊背景;大唱片、底部迷你封面均在播放时旋转,暂停时停转,并尊重系统减少动态设置。
- 点击大封面进入完整歌词,支持键盘操作;封面左右滑动切歌不会误触打开歌词。
- 仅有封面的主播放页居中歌名、歌手及歌词预览,完整歌词页保持原来的左对齐。
- 修正歌曲/歌词标签下划线偏移、长屏留白和手机搜索框绿色焦点框;桌面键盘保留清晰的焦点提示。
- 保留原有音源、播放、歌词、收藏、歌单、多选、下载及设置能力。
自动更新
- 开启自动检查时,启动或回到前台发现新版,会自动打开更新页。
- 按设备本地日期,每天最多自动提示一次;同日重开、重复前台事件或更新版本号均不会重复弹页。
- 手动检查不受每日提示次数限制;保留原有检查缓存、忽略版本和自动检查开关。
- 并发检查复用同一请求;检查失败或尚未实际展示不消耗当天次数,后台完成导航后在回到前台时正确补记。
- 不会自动下载或安装 APK,仍需用户在更新页主动操作。
稳定性
- 修复快速切换使用同一音频 URL 的歌曲时,旧播放请求可能误停新歌曲的问题;显式暂停与取消仍正常生效。
安装与验证
- APK:
CeruMusic-Mobile-v2.6.17.apk - 版本:
2.6.17,Android versionCode:24035 - 包名和签名与上一版一致,可直接覆盖更新,无需先卸载。
- 大小:7,095,637 字节。
- SHA256:
1a2e035bf39bad91275cc1333e63b8dfa294ee7451b76ac9f399181e225a0b29 - 本次 362 项浏览器、受控音频、生命周期和生产构建检查通过;Web/Android 构建、APK 签名及包内资源校验通过。
- 尚未进行 Android 真机安装、原生后台/锁屏功能和真实远程音源的完整验证。浏览器中的触摸、安全区、时钟和前后台测试为模拟环境。
澜音 v2.6.14
澜音 v2.6.14
本机音乐
设置 → 我的 → 本机音乐,可以直接看到手机媒体库里的歌。
- 用 MediaStore 扫描:mp3 / flac / m4a / aac / ogg / wav 等系统能识别的音频都会列出来,
只读元数据(歌名、歌手、专辑、时长、大小),不改动、不复制你的文件。 - 播放走本机小服务直出
content://流,支持拖动进度、后台播放、锁屏控制,
和在线歌曲共用同一套播放器。 - 可以在本机音乐页里搜索、播放全部、单独点某一首。
权限
- Android 13 及以上:只申请「音乐和音频」(READ_MEDIA_AUDIO),不会碰照片和视频。
- Android 12 及以下:申请读取存储(READ_EXTERNAL_STORAGE)。
- 拒绝授权时页面会说明原因,并给出重新授权入口。
关于流量
本机歌曲不经过网络,播放缓存对它们自动跳过;在线歌曲仍然按「播放缓存」开关
边播边存,两者互不影响。
校验
vue-tsc --noEmit、vite build、gradle assembleRelease通过;audit.mjs23/23 pass。- APK 内已确认包含
LocalMediaPlugin与两条读取权限。 - APK:
CeruMusic-Mobile-v2.6.14.apk,versionCode 24032。
澜音 v2.6.13
澜音 v2.6.13
上一版为什么没用
2.6.12 的「岛歌词兼容」只是把歌词写进了媒体标题。小米超级岛读的不是媒体标题,
所以开关打开后岛上依旧空着——这条路本身不成立,我换掉了。
这一版换成真正的两条通道
-
系统实时更新(Android 16 起,无需任何权限)
歌词被单独发成一张常驻通知:setShortCriticalText(当前歌词行)+ 进度条 +
CATEGORY_STATUS。Android 16 及以上的系统会把这类通知提升成岛卡片,
岛上的主文案就是这句歌词。HyperOS 3 上这条路径不需要白名单。 -
HyperOS 焦点通知(有白名单时优先)
同一张卡片再挂mFocusNotification+miui.focus.param(param_v2:大岛左侧
封面/前半句、右侧后半句,小岛进度环)+miui.focus.pics封面。
识别到小米系机型才附带,没有白名单时系统会忽略这段,不会多出第二张卡。
媒体卡片保持原样(歌名、封面、上一首/播放/下一首),歌词走独立的
「岛歌词」通道,两者互不覆盖。
怎么试
设置 → 播放 → 打开「岛歌词兼容」→ 播一首有歌词的歌。
- 岛上应出现当前歌词行,随时间逐行变化(每行变化都会刷新,不必等整段)。
- 通知栏里会多一条「岛歌词」常驻通知,这是这套方案的载体,属正常现象;
关掉开关它就消失。 - 日志里会出现
island | line→<当前歌词行>,每换一行一条。看到这行说明
已经发到系统了,剩下的就看机型认不认这张卡。
如果还是空
把日志里这三类行发我:
island | compat on/line→…:我们这边发出的内容;lyricon | setSong …:给 HyperLyric/Lyricon 的那条链路;LYRIC 下发系统歌词:N 行:取词是否成功。
三者都在、岛上仍空,就说明这台机器的岛只接受「焦点通知白名单」这一条路,
需要 Xiaomi 侧放行包名,或者走 HyperLyric + Lyricon Central 的渲染方案。
校验
vue-tsc --noEmit、vite build、gradle assembleRelease通过。- APK:
CeruMusic-Mobile-v2.6.13.apk,versionCode 24031。
澜音 v2.6.12
澜音 v2.6.12
先看日志的结论
你这份 2.6.11 日志里,歌词每一环都成功了:
LYRIC 插件没给歌词 ← 音源插件只回了空数组
LYRIC 歌词已加载:36 行 ← 云端兜底拿到了
LYRIC 下发系统歌词:36 行 / 470 字 · 共享开 ← 已发给系统
LYRIC 系统已接收歌词负载
lyrics song=E0398A… lines=36 words=470
lyricon provider ready
lyricon setSong lines=36 words=470 id=E0398A…
position pos=5823 playing=true lines=36
也就是说,问题不在取词、不在下发、原生也收到了。小米超级岛本身不吃 Lyricon 的歌词,
它需要一个「歌词消费者」把歌词渲染到岛上:HyperLyric(6.0 起还要 Lyricon Central),
或者用 HyperLyric 的独立应用模式去读媒体信息里的标题。
这一版做了什么
- 新增「岛歌词兼容」开关(设置 → 播放):打开后把当前歌词行写进媒体标题,
歌名移到专辑位。HyperLyric 的独立应用模式、部分车机蓝牙歌词、以及少数直接读
媒体标题的岛,都能看到逐行滚动的歌词,不依赖任何 LSPosed 模块。
开关随进度同步下发,播放中途切换也立即生效。 - 曲目标识统一:歌词负载、进度、seek 现在用同一个
歌曲 key,
原生发现标识变化时会重置进度并记一行lyrics | id drift,避免换歌后歌词错位。 - 新增诊断:
lyricon setSong … mediaId=…、island | compat on/off。
怎么用
设置 → 播放 → 打开「岛歌词兼容」→ 播一首歌。
- 通知/媒体卡片上的标题会变成当前歌词行(这是这套兼容方案的工作方式,歌名在副标题)。
- 关掉开关就恢复成正常标题。
如果你已经装了 HyperLyric:把澜音加进它的白名单,并确认 Lyricon Central 与
LyricProvider 都在 LSPosed 里启用(Lyricon 通常需要重启 SystemUI 和澜音一次)。
校验
vue-tsc --noEmit、vite build、gradle assembleRelease通过;audit.mjs23/23。- APK:
CeruMusic-Mobile-v2.6.12.apk,versionCode 24030。
澜音 v2.6.11
澜音 v2.6.11
日志拉满
- 默认开启详细日志:
console.log / info / debug都会写进运行日志,不再只有错误。 - 容量:条目上限 1000 → 3000,总字数上限 1.2MB → 2.5MB(仍在 localStorage 安全范围内)。
- 新增日志类别:
PLAYER开始播放:曲目、音源、插件、ref 类型与 id、起始位置、时长。LYRIC下发系统歌词:行数、逐字数、共享开关状态、负载大小。LYRIC系统已接收歌词负载 / 下发失败的原文错误。SETTINGS每次改设置:改了哪些键,以及当前--sans、--serif、body实际字体。LYRIC这首歌没有可用音源插件时的提示。
原生不再吞异常
歌词发布到系统(Lyricon 岛 / 锁屏)时,之前失败是完全静默的。现在这些位置都会写进原生诊断
(日志页会一起显示):
lyricon | provider ready/provider unavailable: …lyricon | skip publish: no providerlyricon | publish failed: …lyrics | parse failed: …lyrics | cleared: enabled=… lines=…
配合 JS 侧的 LYRIC 行,可以一眼看出是「没拿到歌词」「拿到了但没发出去」还是「发出去了但系统没发布」。
字体:系统默认真的回到系统
「系统默认」的字体栈原来以 Inter 开头,Inter 在手机上不存在,浏览器的回退顺序里又混着
随包内置的字体名,某些机型上会停在上一档的观感。现在:
- 系统默认 =
system-ui, -apple-system, Roboto, Noto Sans SC, PingFang SC, HarmonyOS Sans SC, Microsoft YaHei, sans-serif,
不含任何内置字体,标题的衬线也退回 Georgia / 宋体族。 - 其余四档(文楷、得意黑、宋体衬线、等宽)不变。
校验
vue-tsc --noEmit、vite build、gradle assembleRelease通过。- 日志验证:切换字体后日志里能看到
SETTINGS 设置已更新:fontFamily=wenkai与三段实际字体栈。 - APK:
CeruMusic-Mobile-v2.6.11.apk,versionCode 24029。
澜音 v2.6.10
澜音 v2.6.10
导入歌单没有歌词 / 不上岛
歌词共享本身不看歌单来源,它只看「这首歌有没有拿到带时间轴的歌词」。
导入歌单里的曲目,ref 可能是从云端记录重建出来的(只有 id 和音源),
插件拿不到内部的额外字段时就返回空歌词,于是岛和锁屏自然没有内容。
这一版补了三层兜底:
- 插件取词为空或报错时,用「歌名 + 歌手」在同一个音源里再搜一次,
用搜索结果里完整的ref重取歌词;只认歌名一致的候选,不会贴错歌词。 - 云端歌词允许按歌名匹配:导入数据里歌手常写成「未知歌手 / 群星 / Unknown」,
以前会因为歌手对不上被判负,现在只按歌名算分。 - 日志里加了 LYRIC 诊断行:清楚写着是「插件没给歌词」「插件取词失败」,
还是「云端也没找到」,并带上音源与 ref id。
自查方法
播放一首那种歌单里的歌 → 设置 → 日志,找 LYRIC 开头的行:
source=plugin(按歌名重搜):兜底成功,岛上有歌词了。插件没给歌词,改试云端歌词后面跟着歌词已加载:云端兜底成功。这句也没找到同步歌词:这个音源与云端都没有这首歌的同步歌词,只能换音源。
其它导入方式
- 插件导入(浏览页里的歌单链接导入):
ref是插件原生返回的,一直没问题。 - 桌面端/云端导入:
ref是重建的,就是这次修的场景。 - 各平台(酷狗 / QQ / 网易云 / 汽水)机制相同,出问题的条件也一样,所以修复对所有平台生效。
校验
vue-tsc --noEmit、vite build、gradle assembleRelease通过;audit.mjs23/23 pass。- APK:
CeruMusic-Mobile-v2.6.10.apk,versionCode 24028。
澜音 v2.6.9
澜音 v2.6.9
返回键按层级走
- 发现:连按两次才退出应用(中间会有一次「再按一次退出应用」的提示)。
- 我的:返回一次到歌单,再返回一次到发现。
- 歌单:返回一次到发现。
- 搜索:返回一次到发现。
- 其余页面(歌单详情、设置、播放页等)保持原来的行为,返回上一页。
字体多两种
现在一共 5 种:系统默认、文楷(内置)、得意黑(内置)、宋体衬线(内置)、等宽。
切换后整个界面和歌词一起换,缺字时自动回落到系统字体。
得意黑适合标题,宋体衬线像唱片内页,等宽适合看歌词。
播放缓存
- 默认开启,边播边把音频写到手机本地(最多 512MB,超出按最久未用淘汰)。
- 同一首歌再播直接读本地,不再走流量,也不怕网络抖动。
- 设置 → 播放 → 可以看当前占用、随时清理。
- 只监听本机回环地址,并带一次性 token,局域网里的其它设备访问不到。
- 网页环境没有这个能力,会自动退回原来的直连方式,不影响调试。
校验
- 类型检查、Web 构建、Gradle release 构建均通过。
- APK:
CeruMusic-Mobile-v2.6.9.apk,versionCode 24027。
v2.6.8 · 字体全局生效 + 内置文楷
v2.6.8
两件事:字体设置现在真的会换掉整个 App 的字,而且换了之后一定看得出变化。
修:切了字体没反应
上一版只把字体用在了歌词上,界面本身还是系统字体;而且三个选项里有的是手机根本不带的字体名(楷体、圆黑),系统找不到就悄悄退回到原来的黑体——看起来就像「设置无效」。
这一版改了两件事:
- 作用范围:改成界面 + 歌词一起换。选一次,标题、正文、按钮、设置项、播放页、全屏歌词全部跟着变。
- 兜底换掉:不再依赖手机自带字体。App 里内置了一份文楷(霞鹜文楷,SIL OFL 授权),只保留 GB2312 一级常用字和拉丁标点,子集 887KB,任何机型选它都一定变样。
- 其余选项全部落到 CSS 通用族(
serif/monospace/sans-serif),不再出现「字体不存在 → 无变化」。
字体选项
设置 → 外观 → 字体:
| 选项 | 观感 |
|---|---|
| 系统默认 | 跟随手机 UI 字体,最稳妥 |
| 文楷 · 内置 | 随包的楷体,笔画带手写味,慢歌和长文最明显 |
| 宋体 · 全衬线 | 标题正文都变衬线,像唱片内页 |
| 等宽 | 字距均匀,像歌词本敲出来的 |
旧版本存过的「楷体 / 圆黑」会平滑迁移到「文楷 · 内置」,不用重新选。
版本
- versionCode 24026 / versionName 2.6.8
- APK 体积增加约 0.9MB(内置字体子集),安装包 5.86MB
- 建议在真机上依次切换四种字体,确认界面与歌词同时变化;再打开一首带歌词的歌看全屏歌词是否跟着换字体。
v2.6.7
v2.6.7
三件事:锁屏歌词换歌后不再串位置、全屏歌词页进入沉浸模式、歌词字体可以换。
修:换歌后锁屏 / 岛上的歌词位置错乱
上一版把「播放进度」交给系统服务托管,服务里有一条守卫:进度不允许倒退(防止 WebView 在后台被限流时把歌词拉回开头)。
问题是换歌也被这条守卫拦住了——新歌刚开始是 0,比上一首末尾小得多,于是被当成「过期进度」丢掉,岛和锁屏继续停在上一首的位置。
- 原生
MediaPlaybackService现在记录当前曲目标识(songKey),换歌后的第一帧进度直接采纳并重置时间轴,不再走「禁止倒退」判断。 - WebView 侧的进度、seek 请求都带上同一个标识,原生据此识别换歌。
- 换歌瞬间不再出现「clamp stale progress 341 -> 522」这类自增,歌词从第一句正常开始。
新:全屏歌词页沉浸
进入歌词页 1.6 秒后,顶部按钮、底部进度与播放控件、系统状态栏一起退场,只留歌词。
- 轻触屏幕、上下滑动歌词,控件立刻回来;停手 3.2 秒后再次退场。
- 控件收起时点歌词只负责唤出控件,不会误触跳转;控件在时点歌词仍然是跳转到那一句。
- Android 返回键优先收起歌词层,再按一次才退出播放页。
新:歌词字体
设置 → 歌词 → 歌词字体:
- 系统默认:跟随手机 UI 字体,最稳妥
- 宋体 · 衬线:唱片内页的观感
- 楷体:偏手写,适合慢歌
- 圆黑:圆润的现代黑体
只作用于歌词文字(全屏歌词、播放页歌词预览),界面其余部分保持系统字体。每个选项都带字体兜底,设备缺字时会自动退化,不会出现方框。
版本
- versionCode 24025 / versionName 2.6.7
- 建议在真机上重点看两处:连续切歌时锁屏歌词是否从第一句开始;歌词页放一会儿控件是否自动消失、点一下是否回来。