Skip to content

音笺 MusicMeta v1.30

Choose a tag to compare

@github-actions github-actions released this 27 Oct 09:00
df6c3f5

音笺 MusicMeta 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 会使用临时签名;不同版本可能无法覆盖安装。安装前请备份数据,不要将签名密钥提交到源码仓库。