Godot 平台生命周期：后台、暂停、窗口失焦和恢复状态

生命周期问题只在真实设备上出现

Godot 项目在编辑器里运行时，生命周期很简单：开始、运行、停止。到了真实平台，情况复杂很多。手机来电话、切后台、锁屏、系统回收；桌面窗口失焦、最小化、显示器切换；Steam Deck 睡眠恢复；网页版本标签页冻结。这些都会影响音频、网络、计时器、渲染资源和存档。

如果项目没有统一生命周期服务，页面和系统会各自处理。结果就是后台回来后音乐没恢复，网络还以为在线，倒计时错了，存档没写，输入卡住。生命周期要作为客户端基础能力设计。

stateDiagram-v2
    [*] --> Foreground
    Foreground --> FocusLost: 窗口失焦/通知遮挡
    FocusLost --> Foreground: 重新获得焦点
    Foreground --> Background: 切后台/锁屏
    Background --> Resuming: 回到前台
    Resuming --> Foreground: 状态恢复完成
    Background --> Terminated: 系统回收/用户关闭

区分失焦和后台

桌面窗口失焦不等于后台。玩家 Alt-Tab 后，游戏可能仍在运行，只是没有输入焦点。移动端切到后台，则可能暂停渲染、限制网络、回收音频。生命周期服务要区分 FocusLost、Background、Resuming、Quit。

失焦时可以暂停输入、降低音量、显示暂停菜单；后台时要保存关键状态、暂停游戏模拟、处理音频焦点、记录离开时间。恢复时再重新检查网络、时间、资源和输入状态。

不要让每个系统直接监听平台事件。统一 LifecycleService 发出结构化事件，其他系统订阅。这样顺序可控，也便于调试。

后台前先保存关键状态

移动端进入后台前，系统给的时间可能很短。客户端应快速保存关键状态：当前 profile、重要设置、未完成事务标记、最近存档点。不要在后台事件里做大规模资源清理或网络请求。

存档要有优先级。单机进度、购买事务、设置变化优先；缓存和日志可以延后。若支持自动云同步，后台前可以标记待同步，但不一定能完成上传。恢复后再继续。

如果游戏在战斗中后台，设计要明确：单机暂停，联网尝试保持会话或进入重连，PVP 可能由服务器继续。客户端不能假设所有玩法都能暂停。

恢复时重新校准世界

从后台回来后，不要直接继续旧状态。需要检查离开时长、服务器时间、网络连接、音频设备、输入焦点、资源状态。长时间离开后，活动倒计时可能结束，登录 token 可能过期，房间可能解散。

恢复流程可以分阶段：先冻结操作，显示恢复中；检查会话；刷新关键模型；恢复音频和输入；解除遮罩。这样玩家不会在半恢复状态点击按钮。

移动端系统可能回收图形资源或音频上下文。Godot 通常会处理底层恢复，但项目资源和服务仍要验证。比如动态下载的 PCK 是否仍挂载，网络 socket 是否仍有效。

音频和输入要特别处理

电话、系统音乐、蓝牙耳机切换都会影响音频。进入后台时暂停或降低音频，回来时按设置恢复。耳机断开后不要突然外放敏感语音。AudioService 应订阅生命周期和设备事件。

输入也可能卡状态。玩家按着虚拟摇杆切后台，回来后触点没释放，角色继续移动。恢复时应清空输入状态，重置触点归属和按键 pressed 状态。手柄断开重连也要刷新当前设备。

桌面端也有生命周期

PC 游戏最小化时是否继续运行？失焦是否暂停？后台是否降低帧率？这些都要有设置或策略。窗口恢复后，分辨率和显示器可能变了，UI 和渲染要重新适配。

Steam Deck 或笔记本睡眠恢复后，时间跨度可能很长。网络和平台 SDK 都要重新校验。不要只把生命周期当移动端问题。

调试生命周期

生命周期问题难复现。测试包可以提供模拟按钮：模拟失焦、后台、恢复、长时间离开、网络断开后恢复。日志记录每次状态切换、离开时长、各系统恢复结果。

真机测试仍不可少。iOS、Android、Windows、macOS、Steam Deck 行为不同。至少要覆盖切后台 5 秒、锁屏 1 分钟、接电话、耳机断开、网络切换、最小化恢复。

小结

Godot 平台生命周期要统一处理失焦、后台、恢复和退出。后台前保存关键状态，恢复时校准网络、时间、音频、输入和资源，桌面端也要考虑最小化和睡眠。生命周期不是平台边角问题，而是客户端稳定性的日常入口。
我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。

我会在生命周期服务里记录恢复报告：离开多久、网络是否重连、token 是否刷新、音频是否恢复、输入是否清空、是否需要刷新页面。恢复问题有了这份报告，定位会直接很多。