⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

Godot移动端开发专家指南：触摸输入、安全区域、电池优化与性能调优

godot-platform-mobile by thedivergentai/gd-agentic-skills

66 周安装量

68 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/thedivergentai/gd-agentic-skills --skill godot-platform-mobile

移动应用游戏性能优化

🇨🇳中文介绍

平台：移动端

触摸优先的输入、安全区域处理和电池优化定义了移动端开发。

绝对禁止事项（移动端专家准则）

输入与显示

绝对不要使用鼠标事件处理触摸交互 — 在移动端依赖 InputEventMouseButton 不可靠。始终使用 InputEventScreenTouch 和 InputEventScreenDrag 以获得高保真的多点触控支持。
绝对不要忽略显示安全区域（刘海屏/挖孔屏） — 放置在摄像头刘海区域后的 UI 将无法使用。查询 DisplayServer.get_display_safe_area() 并相应调整关键 UI 的偏移量。
绝对不要假设固定方向 — 锁定横屏游戏而不处理 size_changed 信号，会导致在可折叠设备或平板电脑方向切换时布局错乱。

电池与性能

绝对不要在应用进入后台时维持高帧率 — 在后台保持应用 60 FPS 会耗尽电池。使用 NOTIFICATION_APPLICATION_PAUSED 将降至 1。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

权限与操作系统集成

绝对不要假设 Android 权限会自动授予 — 您必须显式调用 OS.request_permission() 并使用 OS.get_granted_permissions() 进行验证。
绝对不要在未经许可的情况下调用手持设备振动 — 在 Android 上，除非在导出预设中启用了 VIBRATE 权限，否则振动调用将被忽略。
绝对不要因 I/O 操作阻塞主线程 — 在移动端保存大文件可能触发 ANR（应用程序无响应）错误。请使用后台线程。

强制要求：在实现相应模式之前，请阅读对应的脚本。

用于捏合缩放和双指旋转的专家级多点触控逻辑。

使用 DisplayServer 插值进行动态安全区域（刘海屏）处理。

通过 NOTIFICATION_APPLICATION_PAUSED 进行电池和热量管理。

适用于 Android/iOS 应用内购买的统一样板代码。

用于移动端触觉反馈的高级振动模式。

专家级的 Android 权限请求和验证逻辑。

使用加速度计和重力传感器融合实现稳定的运动控制。

针对横屏/竖屏切换的自适应 UI 交换。

VRAM 监控和纹理压缩强制执行规则。

用于社交功能的操作系统级原生分享界面集成。

# Replace mouse/keyboard with touch
func _input(event: InputEvent) -> void:
    if event is InputEventScreenTouch:
        if event.pressed:
            on_touch_start(event.position)
        else:
            on_touch_end(event.position)
    
    elif event is InputEventScreenDrag:
        on_touch_drag(event.position, event.relative)

# virtual_joystick.gd
extends Control

signal joystick_moved(direction: Vector2)

var is_pressed := false
var center: Vector2
var touch_index := -1

func _gui_input(event: InputEvent) -> void:
    if event is InputEventScreenTouch:
        if event.pressed:
            is_pressed = true
            center = event.position
            touch_index = event.index
        elif event.index == touch_index:
            is_pressed = false
            joystick_moved.emit(Vector2.ZERO)
    
    elif event is InputEventScreenDrag and event.index == touch_index:
        var direction := (event.position - center).normalized()
        joystick_moved.emit(direction)

# Adapt to screen size
func _ready() -> void:
    get_viewport().size_changed.connect(_on_viewport_resized)
    _on_viewport_resized()

func _on_viewport_resized() -> void:
    var viewport_size := get_viewport().get_visible_rect().size
    var aspect := viewport_size.x / viewport_size.y
    
    if aspect < 1.5:  # Tall screen
        $UI.layout_mode = VBoxContainer.LAYOUT_MODE_VERTICAL
    else:  # Wide screen
        $UI.layout_mode = HBoxContainer.LAYOUT_MODE_HORIZONTAL

# Lower frame rate when inactive
func _notification(what: int) -> void:
    match what:
        NOTIFICATION_APPLICATION_FOCUS_OUT:
            Engine.max_fps = 30
        NOTIFICATION_APPLICATION_FOCUS_IN:
            Engine.max_fps = 60

安全区域（刘海屏）

func apply_safe_area() -> void:
    var safe_area := DisplayServer.get_display_safe_area()
    
    # Adjust UI margins
    $UI.offset_top = safe_area.position.y
    $UI.offset_left = safe_area.position.x

# project.godot mobile settings
[rendering]
renderer/rendering_method="mobile"
textures/vram_compression/import_etc2_astc=true

[display]
window/handheld/orientation="landscape"

应用商店元数据

图标：512x512 (Android), 1024x1024 (iOS)
截图：多种分辨率
需要隐私政策
年龄分级

触摸优先 - 为手指而非鼠标设计
性能 - 以中端设备达到 60 FPS 为目标
电池 - 在后台时降低 FPS
权限 - 仅请求您需要的权限

相关：godot-export-builds, godot-ui-containers

主技能：godot-master

🇺🇸English

Platform: Mobile

Touch-first input, safe area handling, and battery optimization define mobile development.

NEVER Do (Expert Mobile Rules)

Input & Display

NEVER use mouse events for touch interaction — Relying on InputEventMouseButton on mobile is unreliable. Always use InputEventScreenTouch and InputEventScreenDrag for high-fidelity multi-touch support.
NEVER ignore display safe areas (notches/cutouts) — UI placed behind a camera notch is unusable. Query DisplayServer.get_display_safe_area() and offset critical UI accordingly.
NEVER assume fixed orientation — Locking a landscape game without handling the size_changed signal leads to broken layouts on foldable devices or tablet orientation shifts.

Battery & Performance

NEVER maintain high framerate when backgrounded — Keeping an app at 60 FPS in the background drains battery. Use NOTIFICATION_APPLICATION_PAUSED to drop Engine.max_fps to 1.
NEVER use the Forward+ renderer for mobile — Most mobile GPUs are not optimized for Forward+. Use the dedicated Mobile or Compatibility renderers for optimal fill-rate.
NEVER leave 'ETC2/ASTC' texture compression disabled — Uncompressed desktop textures will crash mobile devices due to VRAM exhaustion.

Permissions & OS Integration

NEVER assume Android permissions are automatically granted — You MUST explicitly call OS.request_permission() and verify with OS.get_granted_permissions().
NEVER call handheld vibration without permission — On Android, vibration calls are ignored unless the VIBRATE permission is enabled in the export preset.
NEVER block the main thread for I/O — Large file saves on mobile can trigger ANR (Application Not Responding) errors. Use background threads.

Available Scripts

MANDATORY : Read the appropriate script before implementing the corresponding pattern.

mobile_gesture_recognizer.gd

Expert multi-touch logic for pinch-to-zoom and two-finger rotation.

adaptive_safe_area_inset.gd

Dynamic safe-area (notch) handling using DisplayServer insets.

thermal_throttle_monitor.gd

Battery and heat management via NOTIFICATION_APPLICATION_PAUSED.

mobile_iap_flow_boilerplate.gd

Unified boilerplate for Android/iOS In-App Purchases (IAP).

haptic_pattern_generator.gd

Advanced vibration patterns for mobile haptic feedback.

android_runtime_permissions.gd

Expert Android permission requesting and verification logic.

mobile_sensor_fusion.gd

Stable motion controls using Accelerometer and Gravity fusion.

orientation_layout_adaptor.gd

Adaptive UI swapping for Landscape/Portrait transitions.

mobile_vram_optimizer.gd

VRAM monitoring and texture compression enforcement rules.

native_share_invoker.gd

OS-level native share sheet integration for social features.

# Replace mouse/keyboard with touch
func _input(event: InputEvent) -> void:
    if event is InputEventScreenTouch:
        if event.pressed:
            on_touch_start(event.position)
        else:
            on_touch_end(event.position)
    
    elif event is InputEventScreenDrag:
        on_touch_drag(event.position, event.relative)

Virtual Joystick

# virtual_joystick.gd
extends Control

signal joystick_moved(direction: Vector2)

var is_pressed := false
var center: Vector2
var touch_index := -1

func _gui_input(event: InputEvent) -> void:
    if event is InputEventScreenTouch:
        if event.pressed:
            is_pressed = true
            center = event.position
            touch_index = event.index
        elif event.index == touch_index:
            is_pressed = false
            joystick_moved.emit(Vector2.ZERO)
    
    elif event is InputEventScreenDrag and event.index == touch_index:
        var direction := (event.position - center).normalized()
        joystick_moved.emit(direction)

Responsive UI

# Adapt to screen size
func _ready() -> void:
    get_viewport().size_changed.connect(_on_viewport_resized)
    _on_viewport_resized()

func _on_viewport_resized() -> void:
    var viewport_size := get_viewport().get_visible_rect().size
    var aspect := viewport_size.x / viewport_size.y
    
    if aspect < 1.5:  # Tall screen
        $UI.layout_mode = VBoxContainer.LAYOUT_MODE_VERTICAL
    else:  # Wide screen
        $UI.layout_mode = HBoxContainer.LAYOUT_MODE_HORIZONTAL

Battery Optimization

# Lower frame rate when inactive
func _notification(what: int) -> void:
    match what:
        NOTIFICATION_APPLICATION_FOCUS_OUT:
            Engine.max_fps = 30
        NOTIFICATION_APPLICATION_FOCUS_IN:
            Engine.max_fps = 60

Safe Areas (Notches)

func apply_safe_area() -> void:
    var safe_area := DisplayServer.get_display_safe_area()
    
    # Adjust UI margins
    $UI.offset_top = safe_area.position.y
    $UI.offset_left = safe_area.position.x

Performance Settings

# project.godot mobile settings
[rendering]
renderer/rendering_method="mobile"
textures/vram_compression/import_etc2_astc=true

[display]
window/handheld/orientation="landscape"

App Store Metadata

Icons: 512x512 (Android), 1024x1024 (iOS)
Screenshots: Multiple resolutions
Privacy policy required
Age rating

Best Practices

Touch-First - Design for fingers, not mouse
Performance - Target 60 FPS on mid-range
Battery - Reduce FPS when backgrounded
Permissions - Request only what you need

Reference

Related: godot-export-builds, godot-ui-containers

Master Skill: godot-master

Weekly Installs

Repository

thedivergentai/…c-skills

GitHub Stars

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode63

gemini-cli62

codex62

kimi-cli61

github-copilot61

amp61

TanStack Query v5 完全指南：React 数据管理、乐观更新、离线支持

2,500 周安装