Repository navigation
Releases: Kifranei/AM-plus-plus-media-plugin
Release list
v1.3.4
v1.3.4 (16) — 适配 Apple Music 7.0.0 beta 1613;修复 1613 上词幕状态栏歌词无法启动;平板横屏播放页不再显示重复的把手;加强失败开放保护(单个 Hook 出错不再影响宿主或整个插件),并新增 media-diag: 诊断日志,便于定位问题。
Adapted to Apple Music 7.0.0 beta 1613; fixed Lyricon status-bar lyrics not starting on 1613; removed the duplicate drag handle on the tablet landscape player; stronger fail-open protection (a failing hook no longer affects the host or the whole plugin) plus media-diag: diagnostic logs for troubleshooting.
v1.3.3
v1.3.3 (15) — 专辑标题带「E」(Explicit)标识时,下载按钮现在放在标识之后,不再遮挡标识;无标识的专辑位置不变,无法定位标识时回退到标题文字之后。适用于 Apple Music 1606/1607/1609/1611。
On albums whose title carries the "E" (Explicit) badge, the download button is now placed after the badge instead of covering it; albums without a badge are unchanged, and placement falls back to right after the title text if the badge cannot be located. Apple Music 1606/1607/1609/1611.
v1.3.2
中文
- 睡眠定时、删除确认、音质弹窗三种玻璃样式的边缘统一为与次要胶囊按钮(如「设置」)相同的细半透明玻璃描边(宿主默认高光),不再叠加额外描边。
- 保持圆角裁剪、实时取样与失败回退。版本仍为 1.3.2 / 14。
English
- Rim of the sleep timer, delete confirmation and audio quality popups (all three styles) now matches the secondary pill button's thin translucent glass rim (host default highlight); no extra border on top.
- Rounded clipping, live sampling and fail-open kept. Still version 1.3.2 / 14.
SHA-256:
71f35c060675bd6fd2334f81aa92456a0582cd67823532cd5fb2b37d9d171ca0
AM 媒体增强插件 v1.3.1 / 13
中文
版本 1.3.1,内部版本号 13。
- 修复 Apple Music 1611 上歌曲卡片、歌词卡片的图片分享/保存失效。 1611 把分享进度页的观察者类由
commerce.activities.l改为commerce.activities.m,而 1611 适配表沿用了 1609 的类名:该符号仍然存在(但是无关的类),hook 没有命中。现已改正。1606 / 1607 / 1609 不受影响。 - 强化 APK 校验脚本: 除符号存在外,还检查分享进度页确实实例化该观察者类、观察者持有或转换进度页与结果封装类型,且结构候选唯一。
- DexKit 辅助的后台结构检查(试点,仅卡片分享): JSON profile 优先;profile 观察者通过反射校验即立即安装全部 hook(含分享按钮)。DexKit 仅在后台核对,确认 profile 观察者并非由进度页实例化且候选唯一时,才按 Apple Music
versionCode+lastUpdateTime缓存并于下次启动生效。DexKit 或原生库不可用只记录card_sharing:日志,不影响按钮。插件包只含 DexKit Java API,libdexkit.so从 AM++ 模块加载。
在 AM++ 插件管理中导入 ZIP,更新后完全停止并重开 Apple Music。需要插件 SDK v1 的 AM++。
本地单元测试、lint 外的 SDK/ZIP 校验通过;1611 APK 接口检查 0 失败。以上为静态核对;尚未真机验证 1611 的卡片分享与 DexKit 路径。
English
Version 1.3.1, internal version code 13.
- Fixes image sharing / saving of song and lyrics cards on Apple Music 1611. 1611 renamed the share-progress observer from
commerce.activities.ltocommerce.activities.m, but the 1611 profile kept the 1609 name. That symbol still exists (as an unrelated class), so the hook never matched. Corrected. 1606 / 1607 / 1609 are not affected. - Stricter APK verifier: besides symbol existence it checks that the progress fragment instantiates the observer, the observer holds/casts the progress and result types, and the structural candidate is unique.
- DexKit-assisted background check (pilot, card sharing only): JSON profile first; if the profile observer passes reflection checks, all hooks (including the share buttons) install immediately. DexKit only verifies in the background; a confirmed unique mismatch is cached by Apple Music
versionCode+lastUpdateTimeand applied on the next launch. DexKit/native problems only logcard_sharing:and never affect the buttons. The ZIP ships the DexKit Java API only;libdexkit.soloads from the AM++ module.
Import the ZIP in AM++ plugin management, then fully stop and reopen Apple Music. Requires AM++ plugin SDK v1.
Local unit tests and SDK/ZIP verification passed; the 1611 APK contract check reported 0 failures. These are static checks; card sharing and the DexKit path have not been verified on a device.
AM 媒体增强插件 v1.2.0 / 11
中文
版本 1.2.0,内部版本号 11。
- 适配 Apple Music 7.0.0-beta / 1609,按新版混淆名重新对齐全部 hook。
- 移除平板播放界面(iPad 风格布局)的全部改动,输出设备名固定显示在图标下方。
- 移除插件在
fragment.l.E1(boolean, Size)上的封面尺寸 hook,消除与其他注册的冲突;保留封面尺寸修复的其余部分。 - 卡片分享适配新版合并后的分享结果回调。
- 新增「艺术家特色字标」下载:按原始尺寸保存透明 PNG 到
Download/AM++,仅在艺术家有字标时显示;静态封面不再误选字标。 - CI 改为从
media-plugin/plugin.json读取版本号。 - 欧加真(OPPO / realme / OnePlus,ColorOS / realme UI / OxygenOS)系统默认 DPI 较大,播放页音量条暂不支持,已自动禁用:即使设置已开启也不加载,开关显示为关闭且不可开启。
- 修复 Apple Music 1609 播放页音量条布局:不再修改原生控件最小高度,在原生控件行之间放入音量条,空间不足时自动隐藏(感谢 @tcrrry,PR #1)。
在 AM++ 插件管理中导入 ZIP,更新后完全停止并重开 Apple Music。仅支持 7.0.0-beta / 1609,需要插件 SDK v1 的 AM++。
本地 242 项单元测试通过(241 项通过、1 项跳过、0 失败);478 项 APK 接口检查与插件 ZIP 校验通过。本版尚未真机验证。
English
Version 1.2.0, internal version code 11.
- Adapted to Apple Music 7.0.0-beta / 1609; all hooks realigned to the new obfuscated names.
- Removed all tablet player screen (iPad-style layout) changes; the output device name now always sits under the icon.
- Removed the plugin's artwork sizing hook on
fragment.l.E1(boolean, Size)to resolve the registration conflict; the rest of the artwork fix is kept. - Card sharing adapted to the merged share-result observer in the new build.
- Added artist wordmark download: saves the full-size transparent PNG to
Download/AM++, shown only when the artist has a wordmark; still artwork no longer picks the wordmark. - CI now reads the plugin version from
media-plugin/plugin.json. - The player volume slider is automatically disabled on OPPO / realme / OnePlus (ColorOS / realme UI / OxygenOS), whose larger default DPI breaks it: it is not loaded even if enabled, and its switch is shown off and locked.
- Fixed the player volume bar layout on Apple Music 1609: native controls' minimum height is no longer changed; the slider fits between the native rows and hides when there is no room (thanks @tcrrry, PR #1).
Import the ZIP in AM++ plugin management, then fully stop and reopen Apple Music. Supports 7.0.0-beta / 1609 only; requires AM++ plugin SDK v1.
242 local unit tests run (241 passed, 1 skipped, 0 failed); 478 APK contract checks and ZIP verification passed. Not yet verified on a device.
AM 媒体增强插件 v1.1.0 / 10
中文
版本 1.1.0,内部版本号 10。
- 保留词幕集成、原生空格和逐词时间。副行跟随 AM 的翻译/注音开关,两项都开启时优先翻译。
- iOS 媒体控制按钮调起系统音频输出,名称和图标跟随当前路由,支持蓝牙耳机、AirPods 和音响。切回手机输出恢复默认投放图标。修正手机切换歌词/队列时三个动作按钮被平板逻辑隐藏的问题。
- 完善 iPad 风格平板布局:缩小歌曲信息和播放控件,双栏歌词可收起,收起后封面与控制列居中;输出在左下、歌词/队列在右下、翻译在右上,随机/循环在播放键两侧。下方区域按播放时完整封面宽度对齐,暂停不会跟着缩窄。轻微拖动、回弹后保持布局,切页画面保留封面及队列按钮的原生圆角。
- 音量条覆盖封面、歌词和队列页,按已完成布局的实际尺寸预留空间,适应平板和不同 DPI。切页前准备同布局的控制区,减少播放键二次上下调整。两端使用 Flamingo 原版音量图标,平板整行含喇叭收在对齐范围内;音质标签更小并增加与进度条的留白。平板当前输出设备名显示在图标右侧。
- 一个「播放页界面启用液态玻璃」开关控制音质弹窗、更多菜单、删除确认和睡眠定时。更多菜单实时模糊播放页,保留原生操作。把手和系统圆角各有独立开关,全屏封面隐藏把手;保留静态封面尺寸和旋转/返回前台后的背景缓存修复。
- 「解除分享白名单限制」同时支持歌曲和歌词卡片,在 AM 原生分享应用横栏提供分享图片和保存卡片,保留原生卡片及渐变背景。
- 「下载封面、歌词和介绍」支持艺术家静态 JPEG、动态 MP4 和传记,专辑动态 MP4 和介绍,以及播放页原始 TTML。特殊 Logo 字标艺人也有下载入口。保存到
Download/AM++,支持取消和失败清理。保留《÷ (Deluxe)》等 Apple HLS 扩展属性兼容及无损 MP4 重封装修复。
在 AM++ 插件管理中导入 ZIP,更新后完全停止并重开 Apple Music。已有设置保留;八项功能开关首次使用均默认关闭。适配 Apple Music 7.0.0-beta / 1606,需要支持插件系统 SDK v1 的 AM++。最低 Android 9;卡片分享/保存需要 Android 10+,液态玻璃需要 Android 13+。
本地执行276项测试:275通过、0失败或错误、1项可选外部MP4样本测试跳过;Lint零错误。503项原始APK接口检查、固定SDK JAR及插件ZIP校验通过,Flamingo图标文件与原始资源一致。本轮没有新的ADB录屏验证,历史真机结果与当前布局回归范围分别记录在 VALIDATION.md 和 LAYOUT_VALIDATION.md。
English
Version 1.1.0, internal version code 10.
- Retained Lyricon integration, native lyric spacing, and word timing. Secondary lyrics follow AM's translation/transliteration toggles, with translation taking priority when both are enabled.
- The iOS media control button opens system audio output. Its name and icon follow the active route, including Bluetooth headphones, AirPods, and speakers. Phone output restores the default media output icon. Fixed tablet logic hiding the three native phone actions while switching lyrics or queue pages.
- Refined the iPad-style tablet layout with smaller metadata and playback controls. Collapse lyrics to center the artwork and control column. Output remains at the bottom left, lyrics/queue at the bottom right, translation at the top right, and shuffle/repeat beside the transport controls. Lower sections align to the full playing artwork width and keep that width when paused. Shallow sheet drags and rebound retain the layout; transition frames preserve native artwork and queue-button corners.
- The volume slider works on artwork, lyrics, and queue pages, reserving space from completed native row measurements across tablet layouts and DPI settings. Preparing matching control rows before pane changes reduces subsequent vertical repositioning. Original Flamingo volume icons are used, and the entire tablet row, including speakers, stays within the aligned width. The quality badge is smaller with more clearance below the seek track. Tablet output names appear beside the icon.
- One Enable Liquid Glass on the player screen switch controls the audio quality dialog, More menu, deletion confirmation, and sleep timer. The More menu uses a live blurred player background and retains native actions. Handle and system corners have separate switches; full-screen artwork hides the handle. Static artwork sizing and background-cache recovery after rotation/foreground return are retained.
- Remove sharing whitelist restrictions supports both song and lyrics cards. Share image and Save card actions appear in AM's native share-app row, preserving native cards and gradient backgrounds.
- Download artwork, lyrics, and descriptions exports artist JPEG artwork, animated MP4 artwork, and biographies; album animated MP4 artwork and descriptions; and original player TTML. Artist pages with logo wordmarks now expose the download entry too. Files go to
Download/AM++, with cancellation and failure cleanup. Apple HLS extensions and lossless MP4 remux fixes, including ÷ (Deluxe), are retained.
Import the ZIP in AM++ plugin management, then fully stop and reopen Apple Music. Existing settings are preserved; all eight switches default to off for new users. Supports Apple Music 7.0.0-beta / 1606 and requires AM++ plugin SDK v1. Minimum Android 9; card sharing/saving requires Android 10+, and Liquid Glass requires Android 13+.
276 local tests executed: 275 passed, no failures/errors, and one optional external MP4 sample test skipped. Lint reported no errors. All 503 original APK contract checks, fixed SDK JAR checks, and ZIP verification passed. Flamingo vector assets match their originals. No new ADB recording was performed for these layout changes; see VALIDATION.md and LAYOUT_VALIDATION.md for the validation scope.
AM 媒体增强插件 v1.0.0
AM 媒体增强插件首个独立发布版,四项功能已测试通过,各自有独立开关:
- 词幕集成:逐词歌词、英文空格、v1/v2、x-bg,翻译/注音副行跟随 AM 显示开关。
- 使用 iOS 媒体控制按钮:替换 Chromecast 图标,调用妙播或系统音频输出面板。
- 解除歌词分享限制:使用 AM 原生渐变卡片,支持系统分享与保存到相册。
- 液态玻璃音质弹窗:白色图标、居中参数、「设置」「好」同排,避免原生弹窗闪现。
需要包含 插件系统 SDK v1 的 AM++,当前适配 Apple Music 7.0.0-beta / 1606。Android 9+;歌词分享/保存需 Android 10+,玻璃弹窗需 Android 13+。纯嵌入模式的玻璃资源访问尚未单独验收。
下载下面的 ZIP,在 AM++ 设置的「插件」中导入、启用并重开 AM,再在插件设置开启所需功能并重开 AM。
独立工程的 22 项单元测试、Lint、330 项 AM 接口检查及 ZIP 校验通过。发布 ZIP 与已验收包逐字节一致,校验和见随附 .sha256 文件。