GGua 日本語リファレンスEnglishGitHub ↗
英語版が正式な参照です。内容に差異がある場合は、英語版を優先してください。
GODOT / UI IMPLEMENTATION

UI実装の仕方

UIをGua用に書き直す必要はありません。標準Controlを組み、ルートControlを自動収集アダプターへ渡します。

配布済みアドオンを入れる

  1. Latest Releaseを開く

    AssetsからGodot用ZIPをダウンロードして展開します。

  2. addons/guaをコピー
    配置後の構成text
    your-game/
    ├─ project.godot
    └─ addons/
       └─ gua/
          ├─ gua.gdextension
          ├─ gua_auto_adapter.gd
          ├─ plugin.cfg
          └─ bin/
  3. Godotでプロジェクトを開く

    GDExtensionが読み込まれたことをGodotの出力で確認します。

GDScriptで導入する

  1. アダプターを明示的にpreloadする

    class_nameの登録順に依存しないため、サンプルと同じ明示的なpreloadを使います。

    main.gdgdscript
    extends Control
    
    const GuaAutoAdapterScript := preload(
      "res://addons/gua/gua_auto_adapter.gd"
    )
    
    var ui := GuaAutoAdapterScript.new()
    
    func _ready() -> void:
      ui.attach(self)
      ui.update("title")
      ui.start_inspector_bridge(8765)
    
    func _process(_delta: float) -> void:
      ui.update("title")
  2. 識別子を必要な箇所だけ固定する

    既定IDはNodePathから得られます。シーン構造を変えても維持したいIDはメタデータで指定します。

    安定IDと機密入力gdscript
    name_input.set_meta("gua_id", "login-user")
    password_input.set_meta("gua_id", "login-password")
    password_input.set_meta("gua_sensitive", true)

収集される主なControl

入力

LineEdit、TextEdit、CheckBox、OptionButton、ItemList

状態

フォーカス、選択、値、スクロール、範囲、表示・有効状態