FGA 悬浮按钮不显示：SYSTEM_ALERT_WINDOW 权限与横屏限制排查
症状
FGA 服务已启动，但打开 FGO 后：
- 悬浮按钮不出现
- 或者 FGA 通知在，但按钮没在游戏上显示
- 或者按钮只偶尔出现
按优先级排查
检查 1：悬浮窗权限是否已开启
最基础的权限，没开就不可能显示：
- Android 设置 → 应用和通知 → 特殊应用权限 → 显示在其他应用之上
- 找到 FGA → 确保开关已打开
- 如果之前关了 → 打开 → 回到 FGA 主界面 → 重新启动服务
检查 2：当前是否是横屏
FGA 悬浮按钮只在横屏显示！
- FGO 只能横屏玩，所以 FGA 按钮也只在横屏出现
- 如果 FGO 被强制竖屏（极少数机型），按钮不会出现
- Surface Duo 折叠屏设备在竖屏也能显示（特殊适配）
验证：把手机横过来，确保 FGO 画面是横屏的。
检查 3：FGA 服务是否真的启动了
- 下拉通知栏，看有没有 FGA 的 常驻通知
- 如果有 → 服务在运行
- 如果没有 → FGA 主界面 → 点"启动服务"
检查 4：无障碍服务是否开启
有些情况下无障碍服务被关了会导致悬浮按钮也不显示：
- Android 设置 → 无障碍 / 辅助功能
- 找到 FGA 的无障碍服务 → 确保已开启
- 如果没开 → 开启 → 回到 FGA → 重启服务
检查 5：游戏是否全屏沉浸式
有些游戏的沉浸式全屏模式会"吃掉"其他应用的悬浮窗：
- FGO 默认不会完全全屏沉浸式，一般没问题
- 如果你的设备启用了"强制全屏沉浸式"→ 关闭
- 在 FGA 悬浮窗权限里检查是否有额外限制
检查 6：厂商 ROM 的额外限制
| 厂商 | 额外设置 |
|---|---|
| 小米（MIUI） | 设置 → 应用管理 → FGA → 权限管理 → 显示悬浮窗 → 允许；还要开"后台弹出界面" |
| 华为（EMUI） | 设置 → 应用管理 → FGA → 悬浮窗 → 允许；手机管家 → 悬浮窗管理 |
| OPPO / vivo | 设置 → 应用管理 → FGA → 显示悬浮窗 → 允许 |
| 三星（One UI） | 设置 → 应用 → FGA → 显示在其他应用之上 → 允许；设置 → 安全和隐私 → 显示在顶部的应用 → FGA 开启 |
检查 7：悬浮按钮位置可能在屏幕外
你可能之前把悬浮按钮拖到了屏幕外：
- 停止 FGA 服务
- 重新启动服务
- 按钮会回到默认位置（左上角）
如果以上都正常但按钮还是不显示
重启 FGA 服务
有时候服务状态混乱：
- FGA 主界面 → 点"停止服务"
- 等通知栏的 FGA 通知消失
- 点"启动服务"
- 回到 FGO 横屏查看
重启手机
极端情况下，无障碍服务和 MediaProjection 都需要重启才能正常工作。
更新 FGA 到最新版
老版本可能有已知的悬浮按钮 bug。
检查游戏服务器设置
如果你选了错误的服务器，FGA 可能识别不到 FGO 在前台 → 悬浮按钮不出现。
确认 FGA 设置里的游戏服务器和你玩的 FGO 一致。
悬浮按钮出现了但点没反应
原因 1：无障碍服务卡了
点按钮需要无障碍服务模拟点击。如果无障碍服务卡顿：
- Android 设置 → 无障碍 → 把 FGA 服务关掉
- 再重新打开
- 回到 FGA → 重启服务
原因 2：服务没完全启动
FGA 服务刚启动时，悬浮按钮可能需要几秒才能响应。等 5~10 秒再点。
原因 3：MediaProjection 权限没授权
如果服务启动时没授权 MediaProjection：
- FGA 主界面 → 停止服务
- 重新启动服务 → 弹出 MediaProjection 对话框 → 点"立即开始"
- 悬浮按钮应该恢复正常响应
常见误区
| 误区 | 实际 |
|---|---|
| "我重启了 FGA 应用就够了" | 要重启的是 FGA 服务（主界面的"启动服务"按钮），不是重启 FGA 应用 |
| "横屏 FGO 里按钮不出现是 FGA bug" | 99% 是权限没开对，按上面的检查清单一步步来 |
| "按钮出现了但脚本选项不对" | 服务器设置错了 → 改服务器 → 重启服务 |
快速验证 checklist
✅ 悬浮窗权限已开启？
✅ 当前是横屏？
✅ FGA 服务已启动（通知栏有常驻通知）？
✅ 无障碍服务已开启？
✅ 游戏服务器设置正确？
✅ 没有强制全屏沉浸式？
✅ 厂商 ROM 的"后台弹出界面"已允许？