SuperAPI AI 工具集

platform-mobile

编程与开发

查看项目

更新于 10-16 22:43

技能介绍

用途

platform-mobile 是面向 Godot 引擎、用于移动平台(Android/iOS)游戏开发的专家蓝图类技能。它聚焦移动端开发区别于桌面端的关键问题:触屏优先的输入方式、刘海屏/异形屏的安全区域适配,以及电池与性能优化。

主要能力与核心要点

触屏输入

移动端不应使用鼠标事件。文档明确指出:在移动端使用 InputEventMouseButton 不可靠,应改用 InputEventScreenTouch 与 InputEventScreenDrag 来处理触摸按下、抬起与拖动。

虚拟摇杆

提供了一个 virtual_joystick.gd 示例,继承 Control,通过 _gui_input 处理触摸按下、抬起与拖动,记录触摸索引(touch_index)以避免多点触控冲突,并通过 joystick_moved 信号输出归一化方向向量。

响应式 UI

在 _ready 中连接 viewport 的 size_changed 信号,在尺寸变化时根据视口宽高比(aspect)切换 UI 的布局方向:宽高比小于 1.5 视为竖长屏,使用垂直布局;否则使用水平布局。

电池优化

通过 _notification 监听应用焦点变化:切到后台(NOTIFICATION_APPLICATION_FOCUS_OUT)时将 Engine.max_fps 降为 30,回到前台(NOTIFICATION_APPLICATION_FOCUS_IN)时恢复为 60。文档强调后台仍以 60 FPS 运行会导致耗电与商店审核拒绝,甚至要求背景时设为 0。

安全区域(刘海屏)

调用 DisplayServer.get_display_safe_area() 获取安全区域,并按 safe_area.position 调整 UI 的 top/left 偏移,避免 UI 被 iPhone 刘海遮挡。

性能设置

在 project.godot 中配置渲染:renderer/rendering_method="mobile",开启 textures/vram_compression/import_etc2_astc=true;显示方面通过 window/handheld/orientation 指定方向(示例为 landscape)。未开启 VRAM 压缩会导致未压缩纹理在移动端引发内存溢出崩溃。

商店元数据

列出应用图标尺寸(Android 512×512,iOS 1024×1024)、多分辨率截图、隐私政策、年龄分级等要求。

实践要点

文档总结:触屏优先(为手指而非鼠标设计)、性能(中端机目标 60 FPS)、电池(后台降低 FPS)、权限(只申请必需的权限)。

使用方式

该技能以代码示例与规则清单形式提供,开发者可将 safe area 处理、虚拟摇杆、响应式 UI、电池优化等脚本片段应用到 Godot 项目的对应节点与脚本中,并按建议修改 project.godot 的渲染与显示配置。

适用场景

适用于使用 Godot 引擎开发 Android 与 iOS 移动游戏的场景,尤其是需要处理触屏操作、异形屏适配、性能与耗电控制的移动端项目。

限制

资料仅给出关键示例与禁止事项清单,未提供完整的项目模板、自动化脚本安装命令、具体的性能基准测试数据或兼容的 Godot 版本信息,这些内容暂未提供。