Godot 桌面转移动适配
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-adapt-desktop-to-mobile。
技能介绍
问题在哪
桌面 Godot 项目默认假设鼠标悬停、右键、滚轮和固定像素级 HUD。搬到手机后,触控没有 hover、拇指会挡住半屏控件,后台还会因耗电被系统强杀;若仍用 InputEventMouseMotion 和小按钮,玩家在真机上几乎无法正常操作。
技能怎么帮你落地
本技能用 NEVER 清单先拦掉常见踩坑:用 InputEventScreenDrag / InputEventScreenTouch 替代鼠标位移,按钮按 Apple 44pt、Material 48dp 放大,关键信息放在触控区上方以规避指遮挡。
配套脚本分工明确:移动类必看 dynamic_joystick_spawner.gd;滑动手势走 gesture_combo_system.gd;HUD 缩放与锚点用 mobile_ui_adapter.gd;后台暂停用 battery_saver_mode.gd 把 Engine.max_fps 降到 1–5 并停物理;存档用 offline_save_sync.gd 挂在 NOTIFICATIONAPPLICATIONPAUSED(移动端别信 WM_CLOSE)。按类型选型可参考决策表:平台跳跃左摇杆右跳、俯视角双摇杆、回合制直点、解谜 tap/swipe/pinch。
推荐移植顺序:先走 mobile-port-checklist.md 做门禁 → 换触控方案 → ui_safe_area_margins.gd + mobile_ui_adapter → 接省电与离线存 → resolution_scaler.gd 与 mobile_shader_fallback.gd 稳住帧率;深度 IAP/权限再交给 godot-platform-mobile,控制/UI/性能过关前别整包加载平台技能。
边界与注意
mobile_ui_adapter 管整体 HUD 与拇指可达性;on_screen_keyboard_handler.gd 只管 LineEdit/TextEdit 被系统键盘挡住时的上推,二者常要一起用。双摇杆要按 event.index 区分多点;桌面测试构建需同时处理 InputEventMouseButton 与 InputEventScreenTouch。超出决策矩阵的完整配方在 mobile-port-deep.md,首遍控件 remap 不必先读。
使用场景
- 已有 Godot 桌面版平台跳跃,要在左半屏动态生成虚拟摇杆并保留右侧跳跃键
- 俯视角双摇杆射击需要区分两根摇杆的多点 touch index,避免手势冲突
- 回合制或解谜玩法要把 hover 与高亮改成 tap、swipe、pinch,并接入 gesture_combo_system
- 应用切后台时帧率需降到 1–5、暂停物理,同时在 PAUSED 通知里落盘避免被系统强杀丢档
适合人员
- 维护同一 Godot 仓库双端发行的独立开发者,需在不砍桌面键鼠路径的前提下补齐触控
- 负责手游 UI 的 Godot 程序,要把 HUD 放大到 44–48dp 并处理刘海安全区与拇指遮挡
- 性能向移动端工程师,要在真机上用 resolution_scaler 与 shader fallback 稳住帧率后再谈商店导出
- 有桌面存档逻辑的策划兼程序,要把退出存档改成暂停/恢复生命周期上的 offline_save_sync