管乐

需要的权限

如果你已经在设备上启用了 Shizuku 并允许 Tutti 使用，那么以下权限会在每次启动时由 Tutti 通过 Shizuku 自动批量授予，不需要手动一个一个点开系统设置。完成时会弹一条可滑动关闭的通知，列出本次新增的授权项目。可以在"设置 → 启动模式 → 通过 Shizuku 自动授予所需权限"里关掉。

• 必需 悬浮窗权限：在其他 App 上方显示播放控制，并在切歌时直接拉起音乐 App，绕开"是否打开外部应用"弹窗。
• 必需 通知权限：用于显示前台服务通知（Android 13 及以上），系统据此判断后台服务是否合法运行。
• 推荐 通知使用权：读取系统媒体会话状态，监听进度与歌曲结束事件，实现自动切到下一首。不授权则无法自动切歌。
• 推荐 无障碍服务（QQ 音乐）：QQ 音乐的深度链接只会跳到首页或迷你卡片，不能直接打开播放页；这个服务在 QQ 音乐前台时模拟点击迷你播放器，把页面切到完整播放/歌词页。网易云、酷狗、B 站的深度链接已经能直达播放页，所以不需要它。
• 推荐 系统设置写入：网易云的横屏播放页（PlayerLandscapeActivity）是一个独立的 Activity，只在 PlayerActivity 检测到方向变化时才会启动；所以前台模式下播放网易云且设备已经处于横屏时，需要先把系统旋转锁成竖屏，等 PlayerActivity 启动后再恢复原设置，凑出一次"竖→横"转变（约 7–10 秒）。其他平台的播放页通过标准的方向变更回调在同一个 Activity 里切换横竖屏布局，不需要这个绕路。
• 推荐 使用情况访问：浮球双击返回上一个 App 时需要查询最近任务列表。
• 可选 无障碍服务（后台启动）：后台模式下，HyperOS 的手势导航偶尔会把音乐 App 的 freeform 窗口"吸"回主屏；这个服务侦测窗口位置变化，被拉回后立即再次推到屏幕外。注意：它不能消除切歌瞬间 freeform 窗口创建到 resize 之间的短暂闪现——那是 Android 先按默认尺寸创建任务、然后才能 resize 的固有时序，目前没有完美解决办法。
• 可选 Shizuku：启用后台启动模式需要它来调用 am start --windowingMode 5。不安装则只能使用前台模式（切歌时官方 App 会跳到前台）。

已知限制

• 前台模式下切歌时官方 App 会跳到前台；后台模式可以避开这一点，但需要 Shizuku。
• MediaSession 的 playFromMediaId / playFromUri / playFromSearch 在网易云和 QQ 音乐里都不会触发实际播放，只能依赖深度链接启动。
• 前台模式下播放网易云时，如果设备已经处于横屏，需要先把系统旋转方向锁成竖屏再恢复，约 7–10 秒——网易云的横屏播放页是独立的 PlayerLandscapeActivity，只在 PlayerActivity 检测到方向变化时才会启动，所以必须制造一次"竖→横"转变。后台模式下 freeform 窗口规避了这个问题。
• QQ 音乐没有提供能直接打开播放页的深度链接。前台模式下我们用无障碍服务模拟点击迷你播放器条进入完整播放页，从启动到切入大约 1–8 秒，偶尔会因为页面层级变化而失败、回退到 QQ 音乐首页。后台模式下没有可见的页面切换，这个延迟和失败都看不到。
• 四家平台都没有对外开放过官方文档化的歌单 API——我们用的都是各家 Web/App 自己在调的内部接口。差别在于：网易云、QQ 音乐、B 站的这类接口不要求登录就能拿到公开歌单的数据；只有酷狗会在未登录时统一返回 4xx。所以酷狗歌单通过解析分享页里服务端渲染的歌曲数据来读取，个别字段缺失的歌曲可能无法导入。
• 会员歌曲仍然需要你拥有对应平台的会员，管乐 不会绕过任何鉴权。
• 当前发布的是预览版，可能在边角场景下崩溃，欢迎在 GitHub 上提 Issue。