启动 FGA 服务：从主界面到 FGO 悬浮按钮的完整流程
前置条件
在启动 FGA 服务之前，请确认以下事项都已完成：
| 检查项 | 状态 |
|---|---|
| FGA 已安装 | ✅ |
| 语言已选择 | ✅ |
| 存储目录已配置 | ✅ |
| 电池优化已关闭 | ✅ |
| 无障碍服务已开启 | ✅ |
| 悬浮窗权限已开启 | ✅ |
| MediaProjection 权限已就绪（Android 13 及以前可能需要重授权） | ✅ |
如果有任何一项未完成，先回到对应的引导页面补完。
启动服务的步骤
第一步：打开 FGA 应用
点击桌面 FGA 图标，进入主界面。主界面会显示：
- 当前是否有 FGO 战斗配置（Battle Configs）
- 权限状态检查结果（无障碍、悬浮窗、电池优化、截屏方式）
- "启动服务"按钮
第二步：点击"启动服务"
点击主界面的"启动服务"按钮后，会发生以下事件：
- FGA 检查所有必需权限是否就绪
- 如果使用 MediaProjection，弹出系统的"开始截取屏幕"对话框
- 点击"立即开始"授权
- FGA 创建前台服务，系统通知栏会显示 FGA 正在运行的通知
- 虚拟显示器和 ImageReader 被创建完成，截屏能力就绪
- 无障碍服务被激活，模拟点击能力就绪
- 悬浮按钮出现在屏幕上（横屏时）
第三步：打开 FGO，进入游戏
打开 FGO 客户端，进入游戏主界面。此时你应该能在屏幕的某个位置看到 FGA 的悬浮按钮（默认左上角）。
第四步：第一次测试
- 在 FGO 里进入一个自由关卡（不是主线剧情）
- 点击 FGA 的悬浮按钮
- FGA 会自动检测当前画面状态，弹出可用的脚本类型
- 应该能看到"战斗"选项——说明 FGA 的图像识别正常工作了！
- 先不要点"战斗"，这次只是验证服务是否正常
如果悬浮按钮点击后没有弹出脚本选择菜单，检查：
- FGO 是否是横屏（FGA 悬浮按钮只在横屏显示）
- 无障碍服务是否正常工作（见 05-accessibility-service.md）
- MediaProjection 是否授权成功
服务运行状态
通知栏提示
FGA 启动后会在系统通知栏显示一个常驻通知，包含：
- 当前运行的脚本类型（战斗/抽奖/友情池等）
- 已运行次数 / 剩余次数
- 当前战斗掉落统计（如果有）
- 一个"停止服务"的快捷按钮
这个通知很重要——它不仅告诉你 FGA 在运行，还可以防止 Android 杀掉前台服务。不要划掉这个通知。
悬浮按钮的功能
悬浮按钮在不同状态下显示不同的界面：
| 状态 | 点击悬浮按钮后的界面 |
|---|---|
| 服务刚启动，未运行脚本 | 显示游戏画面检测到的可用脚本（战斗/抽奖/友情池/礼物箱等） |
| 战斗运行中 | 显示战斗统计（次数、掉落、时间）、暂停/继续/停止按钮 |
| 其他脚本运行中 | 显示对应脚本的统计和控制按钮 |
暂停 vs 停止 vs 结束
FGA 有三个控制动作：
| 动作 | 效果 |
|---|---|
| 暂停（Pause） | 脚本在当前步骤停下，不再执行后续操作。继续后从停下的地方接着跑 |
| 停止（Stop） | 脚本立即停止，退出 FGO 到菜单。本次运行的统计数据会保留 |
| 完成本次运行后停止 | 在悬浮按钮里的战斗配置可以设置——跑完当前这一轮战斗后自动停下，适合挂机多轮 |
常见启动失败原因
启动服务后立刻停止
90% 是电池优化没关干净，回到 电池优化 重新配置。
没有弹出 MediaProjection 对话框
可能是 token 还在缓存。试试在 FGA 设置里切换截屏方式，或者重启手机。
悬浮按钮不出现
- 确认当前是横屏方向
- 确认悬浮窗权限已开启
- 确认无障碍服务已开启
FGA 能检测画面但点击没反应
说明无障碍服务的"模拟点击"功能没工作，可能被系统禁用了。回到无障碍设置重新开启 FGA 的无障碍服务。
服务常驻 vs 用完即停
FGA 服务可以保持启动状态，随时在 FGO 里用悬浮按钮启动脚本。也可以用完后手动停止服务节省电量（但下次启动又要走一遍权限确认）。
推荐的使用模式：
- 准备刷材料前启动服务
- 刷完停止服务
- 中间挂机时保持服务运行
下一步
服务启动成功后，接下来就要开始配置具体的自动化脚本了。推荐从最常用的战斗自动化开始：
- 战斗概览：了解 FGA 战斗自动化的完整工作流程