Repository navigation
音笺 MusicMeta v1.50
音笺 MusicMeta v1.50 正式版
- 长歌词自动换成两行: 系统悬浮窗与应用内备用播放器同步明确启用自动换行,单句歌词过长时可上下两行显示,不改成同时显示两句歌词。
- 给两行文字留足高度: 歌词卡片高度由 70dp 调整为 104dp,歌词文字区从约 48dp 增至约 82dp,可为当前字号范围内的两行文字留出空间,并保留底部进度线区域。
- 封面对齐保持不变: 仅向下增加歌词卡片高度,顶部锚点与封面对齐逻辑、当前宽度、底色、薄荷绿文字和进度线样式不变。
- 版本号: 1.50,versionCode = 54。
v1.49 正式版
- 歌词栏再次加宽 1.15 倍: 在 v1.48 的宽度基础上再扩大 15%,系统悬浮窗与应用内备用播放器同步调整;封面位置和歌词栏顶部对齐逻辑不变,屏幕边缘仍会按可用空间自适应收窄。
- 内部歌词显示区域同步加宽: 内部文字区域随歌词栏整体同步扩展,保留两行布局、当前底色、文字颜色与进度线样式。
- 版本号: 1.49,versionCode = 53。
v1.48 正式版
- 歌词栏宽度放大 1.15 倍: 系统悬浮窗与应用内备用播放器同步调整歌词栏目标宽度,保留封面作为锚点、左右自动布局及屏幕边缘空间约束;屏幕空间不足时仍会自适应收窄。歌词区域顶部位置和封面对齐逻辑不变。
- 歌词内容区同步加宽: 减小外层与文字区的水平内边距,让实际承载歌词的区域也更宽;字号、两行布局、进度线位置和薄荷绿文字颜色保持不变。
- 歌词底色略微加深: 黑色半透明底由 28% 调整至 33%,仅影响歌词文字区域,外层卡片仍保持透明。
- 版本号: 1.48,versionCode = 52。
音笺 MusicMeta v1.47 正式版
- 歌词更清楚,原有颜色不变: 系统悬浮窗和应用内备用播放器只在歌词文字区域加约 28% 不透明度的黑色半透明底,并为文字添加轻微阴影;继续使用原有
#9FF0C9歌词颜色。 - 默认字号上调一档: 默认歌词字号从 15.04sp 调整为 17.28sp;旧默认字号升级时迁移到新默认,自定义字号尽可能保留。
- 歌词栏容纳两行: 展开歌词栏由 64dp 调整为 70dp,文字区域约 48dp,按默认行高可完整容纳两行,同时保留独立的已播放进度线区域。
- 透明感保持: 外层歌词卡片依旧透明且无阴影,未播放进度轨道继续不绘制;封面、侧键和已播放进度线颜色不变。
- 版本号: 1.47,versionCode = 51。
v1.46 正式版
- 无权限备用播放器拖动一致: 展开状态以封面为锚点,按封面在屏幕上的位置动态将歌词栏放到左侧或右侧;左右拖动范围、边缘留白及歌词栏可用宽度复用系统悬浮窗计算逻辑。
- 歌词栏完全透明: 移除面板底色、歌词内层底色和阴影;进度条未播放部分不再绘制,只保留歌词文字与已播放进度线。
- 修复上一首 / 下一首队列归属: 导航根据当前歌曲所属的已同步公开 / 红心歌单选择相邻曲目,即使用户切换了主界面标签,也不再把原歌单导航误回退成直接搜歌的音源候选队列。新增回归测试覆盖当前 UI 位于直接搜歌时仍识别原歌单。
- 版本号: 1.46,versionCode = 50。
v1.45 正式版
- 封面与歌词手势: 单击仍为播放 / 暂停,双击仍为展开 / 收起歌词栏;长按封面或歌词正文满 5 秒后彻底关闭音笺,停止播放并从最近任务移除应用。
- 彻底清理播放器后台: 释放当前 MediaPlayer、清空当前曲目和播放队列、停止悬浮播放器服务与媒体播放前台服务,并移除系统媒体通知 / 会话。此操作只清理音笺自身,不会关闭其他应用;Android 对进程的最终回收仍由系统管理。
- 画圈改为定位: 拖动封面或歌词卡片时连续画圈,会打开音笺并尝试定位到当前播放曲目;应用内备用播放器使用相同映射。
- 版本号: 1.45,versionCode = 49。
v1.44 正式版
- 时间轴歌词优先: 当前句从有效时间轴行中选择;明确标注的作曲、编曲、翻译者等资料行(不论是否带时间戳)不会抢占悬浮歌词。只影响显示,不改写原始歌词;无法识别的内容仍保留。
- 本地内嵌歌词回退更稳妥: 只有重复时间戳等结构足以确认原文 / 译文配对时才拆分;不能可靠识别时保留原始文本,不强行删除或重新分组。无时间戳译文无法借助原文同步时,先显示译文第一行。
- 更新悬浮窗手势: 单击封面播放 / 暂停;双击展开 / 收起歌词;长按打开音笺并尝试定位当前歌曲;拖动时画圈关闭悬浮层,但不停止播放。系统浮窗和应用内备用播放器同步更新。
- 更新 Local Music / Playlist 教程: 帮助按钮说明本地扫描与排序、公开/红心歌单、音源候选、悬浮窗手势、歌词切换及收起后的触摸穿透。
- 清理过时代码: 移除没有实际调用的旧版组合悬浮播放器 Compose 实现,减少与当前独立窗口架构不一致的旧逻辑。
- 回归测试: 覆盖无时间轴资料行不会覆盖时间轴歌词、无法同步时回退第一行,以及无法配对的本地双语歌词保留原样。
- 版本号: 1.44,versionCode = 48。
v1.43 历史版本
- 修复右侧封面时侧键闪烁: 侧键使用固定尺寸/位置的独立窗口,歌词卡片单独成窗;展开和收起只对歌词卡片做动画,不再在收起时同时改变侧键窗口的宽度和横坐标。
- 触摸行为保持: 收起动画结束后移除歌词卡片窗口,后方应用仍可滑动;侧键保持独立点击,封面保持可拖动。
- 左右布局一致: 歌词卡片在封面与侧键之外按 4dp 间距独立定位;展开/收起不改变侧键锚点。
- 回归测试: 覆盖左右布局的固定侧键坐标及歌词卡片窗口坐标。
- 版本号: 1.43,
versionCode = 47.
v1.42 历史版本
- 收起后不再拦截后方触摸: 收起动画结束后,系统歌词悬浮窗缩到侧键所在的 28×64dp 区域;透明歌词区域不再覆盖其他应用,因此后方画面可继续滑动。
- 保留侧键与动画: 上下侧键收起时仍可点击;展开时窗口先扩展,收起时等动画结束再缩小,左右布局都贴着封面。
- 布局回归测试: 覆盖收起窗口宽高及左右镜像时的控制区坐标。
- 原有功能保持: 封面圆角与无底色箭头、歌词栏独立圆角、15.04sp 默认字号、本地歌曲定位、收起后只有封面可拖动。
- 版本号: 1.42,
versionCode = 46。
v1.41 历史版本
- 收起歌词栏不再拖动: 移除系统悬浮窗和 App 内备用播放器中,收起后歌词栏透明区域上的拖动手势;收起时只有封面可以拖动,切歌侧键仍可点击。
- 外观保持: 封面恢复原始四角圆角;两个独立上下侧键仅显示居中的箭头,不铺深绿色底;歌词栏保留完整圆角与侧键区域分隔。
- 布局回归测试: 保留组合窗口宽度、镜像定位、窄屏和屏幕边缘约束测试。
- 原有功能保持: 默认歌词字号 15.04sp、本地歌曲定位与滚动、展开歌词栏拖动、无悬浮窗权限时的 App 内备用播放器。
- 版本号: 1.41,
versionCode = 45。
v1.40 历史版本
- 还原封面外观: 封面恢复四角 18dp 圆角,不因侧键位置改变封面形状。
- 侧键改为简洁图标: 上一首、下一首保留独立点击区域,各自 31dp 高、中间 2dp 分界;仅绘制箭头,不再铺深绿色按钮底,箭头位于各自触控区域中央。
- 歌词栏保持独立: 歌词卡片保留完整圆角;与透明侧键触控区之间保留 4dp 间隔,左右布局镜像一致。
- 布局回归测试: 新增组合窗口宽度、镜像定位、窄屏和屏幕边缘约束测试。
- 原有行为保留: 默认歌词字号 15.04sp、本地歌曲定位与滚动、折叠歌词区域拖动、无悬浮窗权限时的 App 内备用播放器。
- 版本号: 1.40,
versionCode = 44。
v1.39 历史版本
- 两个独立按键: 上一首、下一首分别绘制独立按钮,各自有背景和圆角,中间留 2dp 间隔,不再显示为一整条控制栏。
- 封面边缘对齐: 按键组贴合封面一侧,上键顶边、下键底边分别与封面上下边缘齐平;歌词栏独立并保留间距。
v1.38 历史版本
- 按键归属修正: 上下两个独立按钮分别与封面边缘贴合,按钮之间留 2dp 间隔;封面与按钮相接的一边为平边,歌词栏保留独立圆角并与按钮组留 4dp 间距。
- 上下边缘对齐: 上按钮顶边、下按钮底边分别与封面上下边缘齐平;两个按钮各 31dp 高,中间 2dp 间隔,总高 64dp,随左右布局切换。
- 版本号: 1.38,
versionCode = 42。
1.37 历史版本
- 侧键与封面连体: 控制区与封面之间不留缝,两个空心箭头分别占据上、下 32dp,顶边与封面顶边齐平、底边与封面底边齐平;歌词栏贴在侧键另一侧,不额外留空隙。
- 默认歌词字号: 设为 15.04sp;升级时仅将旧默认 17.28sp 自动迁移到 15.04sp,其他用户自定义字号不变。
- 本地转圈定位: 滚动位置按界面实际展示的排序列表计算,修复歌曲高亮但列表未滚动到目标行的问题。
- 收起区域可拖动: 保留隐藏歌词面板的透明触控热区,可拖动整组悬浮播放器;有权限与无权限的播放器共用同一视觉布局。
- 回归测试: 覆盖字号迁移、自定义字号保留和按排序列表定位本地歌曲。
- 版本号: 1.37,
versionCode = 41。
v1.36 历史改进
- 常驻侧键: 改为更醒目的空心上/下箭头,28dp 触控区、1dp 间隔;侧键栏缩至 28dp,并将封面与侧栏的间距缩小到 2dp。侧键仍位于封面与歌词栏之间,左右布局保持一致。
- 歌词与进度条位置: 歌词栏整体下移 4dp,进度条在栏内再下移 2dp;侧键与歌词栏保持垂直对齐。
- 回归测试: 更新组合布局宽度测试,补充侧键间距验证。
- 版本号: 1.36,
versionCode = 40。
v1.35 历史改进
- 歌词栏宽度与组合布局: 改为按封面、切歌控制区和歌词栏的整体宽度计算默认位置,歌词栏尽可能使用可用空间;旧版默认居中的保存位置会迁移一次,手动摆放在其他位置的坐标保持不变。
- 侧边切歌键: 去除圆形背景与边框,改为上下排列的纯三角;控制区放在封面和歌词栏之间,随歌词栏左右方向同步切换,不遮挡歌词。
- 回归测试: 新增全组合居中、宽度和屏幕边界测试。
- 版本号: 1.35,
versionCode = 39。
v1.34 历史改进
- 歌词翻译同步: 对无时间戳译文,依据原文当前时间轴行将译文行按比例映射,即使两者行数不同也不会一直停在第一句;原文中的“作曲”“编曲”等内容仍作为正常歌词保留。
- 本地排序按钮: 将扫描按钮右侧的文字排序按钮改为 Material 3 图标按钮,循环顺序仍为“由新到旧 → 由旧到新 → A–Z”。
- 悬浮窗侧边切歌: 增加常驻的上一首/下一首竖排三角图标,始终与歌词栏位于同一侧并预留独立宽度;歌词栏收起时切歌按钮仍可用,展开后歌词内容占满歌词栏,不再在歌词栏内部重复显示切歌键。
- 进度条: 触控区域加高至 18dp、轨道宽度约为歌词栏的 94%,视觉轨道下移;支持按住拖动连续定位,不只响应点击,同时避免拖动进度时移动悬浮窗。
- 版本号: 1.34,
versionCode = 38。
自动化构建成功不替代真实 Android 设备验收。请以 GitHub Actions 的实际构建结果和 Release 附件为准。
v1.33 历史改进
- 主界面、应用内迷你歌词和悬浮歌词统一使用歌词时间轴解析;有时间戳的译文按自己的时间轴定位。
- 本地分页增加文件修改时间排序与缓存迁移,循环“新→旧”“旧→新”“A–Z”。
- 原始歌词内容保留,不按“作曲”“编曲”等关键词过滤。
- 版本号:1.33,
versionCode = 37。
v1.32 历史修复
- 系统媒体卡片恢复显示正常歌曲标题和艺人,不再把当前歌词作为标题。
- 版本号:1.32,
versionCode = 36。
v1.31 历史修复
- 悬浮窗封面、歌词栏布局、展开 / 收起、左右侧定位与手势恢复到 v1.29 已发布实现。
- 系统媒体卡片仍使用 MediaSession / MediaStyle,并保留全局悬浮窗开关;此历史版本将当前歌词作为媒体标题。
v1.30 历史改进
- 悬浮歌词跑马灯: 当前歌词使用 Compose
basicMarquee以 24dp/s 缓慢横向滚动,起始延迟 700ms、循环间隔 900ms,不再用省略号截断;长歌词保留在文本内容中。 - 半透明层次: 展开栏底层约 72% 不透明,配细绿色描边与柔和阴影;歌词内层使用更亮的半透明绿灰底,与外层形成清晰层次,前后切歌按钮带独立的低对比底色,进度轨道和进度线仍清楚区分。
- 展开悬浮窗整体对齐: 歌词面板宽度比例由 1.2 增至 1.35,高度固定为 88dp,与 64dp 封面加下方 2dp 间隔和 22dp 三合一控制行的整体范围一致;面板上沿对齐封面顶部,下沿对齐播放模式 / 时间 / 播放暂停控制行的底部。首次显示时按整个组合宽度计算初始位置,窄屏尽量利用可用宽度;旧版默认居中的保存位置会迁移到新布局,明显手动拖动的位置保持不变。歌词行与进度条增加 4dp 间隔,进度条触控高度增至 16dp,可见轨道仍保持纤细样式。
- 系统媒体卡片切换悬浮窗: 原关闭按钮变为 Lucide 开关图标,图形在 24dp 图标画布中缩至约一半。切换直接读写
floating_overlay_enabled全局偏好,图标随状态更新,关闭时试听继续。 - 系统标题限制说明: 始终向 Android
MediaSession提供完整当前歌词及显示标题。Android / OEM 决定系统媒体卡片中文字是否滚动或显示省略号,应用无法对系统自有的锁屏与下拉栏 TextView 强制设置 Compose 跑马灯,因此不采用高频替换标题来模拟滚动。 - 代码 / 文档清理: 移除 v1.29 的临时会话级悬浮窗隐藏状态,避免它与用户全局设置冲突;补充媒体标题和开关标签测试,更新 README 和图标许可声明。
- 版本号: 1.30,
versionCode = 34。
v1.29 历史改进
- 只保留系统媒体通知: 悬浮窗服务不再发布第二条“正在播放试听 / 悬浮播放器已开启”常驻通知;通知栏与锁屏只显示系统媒体播放卡片。
- 当前歌词作为媒体标题:
MediaSessionCompat显示标题优先取当前活动歌词,并遵循全局“优先显示翻译歌词”设置;无歌词时回退到歌曲名,歌曲名与艺人信息保留在其他描述字段。 - 媒体卡片关闭悬浮窗: 将静音按钮改为“关闭悬浮窗”。只关闭悬浮窗口,不暂停或销毁当前试听,播放进度和系统媒体控制继续工作。
- 统一全局设置: 翻译歌词优先级仍读取现有设置;用户关闭悬浮窗后,本次会话不会因进度同步或播放状态变化自动重新出现。通过设置关闭再开启悬浮窗可以恢复显示。
- 旧代码与文档清理: 移除未再使用的静音状态与命令、媒体服务闲置的控制 helper、悬浮服务重复通知和过时 README 声明;增加媒体标题回归测试。
- 版本号: 1.29,
versionCode = 33。
系统媒体卡片使用 AndroidX MediaSessionCompat 与 MediaStyle,锁屏布局仍由 Android 版本及设备厂商决定。自动化构建成功不等于完成所有设备上的实机验证。
v1.28 历史改进
- 锁屏和下拉通知栏媒体卡片: 新增 Android MediaSession + MediaStyle 媒体通知,显示歌曲名、艺人、封面、当前歌词和上一首 / 播放暂停 / 下一首控制;可用系统媒体键及兼容的蓝牙耳机、车机媒体按钮操作同一试听播放器。
- 统一控制状态: 通知栏、锁屏和悬浮窗都控制同一播放器队列、播放状态、进度和静音状态。保留现有悬浮窗按钮布局;静音切换只放在系统媒体通知控制里,不往悬浮歌词窗增加按钮。
- GD Studio HTTP 5xx 回退: 网易云来源搜索遇到临时服务端错误时,自动尝试 flac.music.hi.cn 的同平台搜索;不会把 JOOX / Bilibili 等不支持的来源静默改成别的平台。
- 失效候选自动跳过: 在当前搜索结果队列内,某个候选的下载地址失效或返回 HTTP 503 时,自动尝试后续候选;若队列没有其他版本,仍会显示可恢复的错误。
- 通知权限: Android 13 及以上首次播放时申请通知权限;未授予时,部分手机可能不在下拉栏显示播放卡片,可在系统设置里开启音笺通知。
- 版本号: 1.28,versionCode 32。
媒体卡片使用 AndroidX MediaSessionCompat 与 MediaStyle;参考 AndroidX Media3 的官方 DemoPlaybackService 与后台播放指南。系统会按设备厂商和 Android 版本决定锁屏卡片的具体排版,应用不对系统锁屏 UI 做任意自定义布局。
GD Studio API 的使用须注明来源“GD音乐台 (music.gdstudio.xyz)”并遵守 CC BY-NC 4.0 非商业使用限制。请遵守服务条款及适用版权规则。
自动化验收包括 :app:testDebugUnitTest、:app:assembleRelease、APK 对齐、签名与包名检查。CI 成功不代表已完成真实设备端到端测试;尤其锁屏展示、不同蓝牙设备的媒体键兼容性与第三方音源行为仍需在实际设备上验证。
签名提醒: 若仓库没有配置由维护者保管的持久化 Release 签名密钥,CI 会使用临时签名;不同版本可能无法覆盖安装。安装前请备份数据,不要将签名密钥提交到源码仓库。