权限与授权

SPlayer for Android 涉及四类授权：通知、悬浮窗、SAF 目录、电池优化白名单。首次启动会引导授予前两项（每台设备仅引导一次）。

通知权限（POST_NOTIFICATIONS）

症状：通知栏音乐控制器不显示。

1. 设置 → 播放设置 → Android 系统设置 → 通知栏音乐控制器 打开开关；
2. Android 13+ 首次开启会弹通知权限框，选择允许；
3. 若曾拒绝：系统设置 → 应用 → SPlayer → 通知 → 允许通知。

开启后应用进入后台仍会继续播放，不会被系统快速回收。

悬浮窗权限（SYSTEM_ALERT_WINDOW）

症状：桌面歌词打不开，提示需要权限。

桌面歌词基于 WindowManager 覆盖窗，必须授予「显示在其他应用上层」：

1. 开启 设置 → 歌词设置 → 桌面歌词 → 开启桌面歌词，首次会自动跳转授权页；

2. 若曾拒绝：系统设置 → 应用 → SPlayer → 权限 → 显示在其他应用上层 → 允许；

3. 也可用 adb 直接授予（调试用）：

   adb shell appops set top.imsyy.splayer.android SYSTEM_ALERT_WINDOW allow

授权后仍不显示时，检查是否开启了「锁定桌面歌词位置」导致悬浮窗移出屏幕，或在桌面歌词设置中点击 恢复默认配置。

SAF 目录授权

本地音乐、本地歌词、音乐下载三类功能各自持有一个 SAF 目录授权，首次使用时弹出系统文档选择器。

重新授权 / 更换目录：

• 本地音乐：设置 → 本地与缓存 → 本地歌曲目录 → 管理目录；
• 本地歌词：设置 → 歌词设置 → 本地歌词覆盖在线歌词；
• 下载：设置 → 本地与缓存 → 下载配置 → 默认下载目录（可用「清除选择」重置）。

不要授权到系统根目录

请选择具体的音乐目录而非整个内部存储，否则全库扫描会非常缓慢。下载目录建议选择独立文件夹，便于「文件智能分类」建立子目录。

授权后扫描不到歌曲：确认目录内确有音频文件；SAF 对部分外置 SD 卡 / 网盘挂载目录支持不佳，可换到内部存储重试。

电池优化白名单

症状：后台播放一段时间后停止，或通知栏进度不再更新。

各厂商 ROM 的后台管理比原生 Android 更激进：

1. 系统设置 → 电池 → 应用耗电管理 → SPlayer → 允许完全后台行为 / 无限制；
2. 在最近任务中锁定 SPlayer 卡片（下拉加锁）；
3. 关闭「智能省电」「睡眠待机优化」等针对本应用的策略。

权限被回收

Android 11+ 会对长期不用的应用自动回收权限。若久未使用后桌面歌词 / 通知失效，按上文重新授予即可，设置数据不会丢失。