【Godot 4】これだけは覚えておきたい！await で使える便利なコルーチンまとめ

Godot 4でスクリプトを書いていると、「1フレームだけ待ちたい」「少しだけ演出を遅らせたい」「特定のシグナルを待ち受けたい」という場面によく遭遇します。

Godot 4では await キーワードを使うことで、コードの流れを止めることなく、スマートに待機処理を実装できます。よく使う代表的なパターンを見ていきましょう！

1. 定番！「1フレーム待つ」処理

一番よく使うのがこれです。物理演算やノードの初期化順序の関係で、「インスタンス生成の次のフレームで位置を確定させたい」ときなどに重宝します。

# 1フレーム処理を待つ 

await get_tree().process_frame

2. 物理演算フレーム（_physics_process）のタイミングで待つ

物理挙動（CharacterBody2D や RigidBody3D など）をスクリプトから制御する際、物理演算の更新タイミングに合わせたい場合に使います。

# 次の物理フレームまで待つ 

await get_tree().physics_frame

3. 指定した時間だけ待つ（タイマー処理）

演出のウェイトや、連続入力を防ぐクールダウンなどに必須の処理です。

Engine.get_main_loop() や get_tree().create_timer() を利用します。

# 1.5秒待つ 

await get_tree().create_timer(1.5).timeout

4. シグナル（イベント）の発行を待つ
Godotの真骨頂であるシグナルを await で直接待ち受けることができます。
何かの完了を待つ処理が、上から下に流れるようなきれいなコードで書けます。


# アニメーションの再生が終わるのを待つ
$AnimationPlayer.play("explosion")
await $AnimationPlayer.animation_finished

print("爆発アニメーション終了！")



5. Tween（トゥイーン）の完了を待つ
UIのフェードイン・フェードアウトや、
オブジェクトのスムーズな移動の完了を待つパターンです。
Tween自体に await を繋げられます。
var tween = create_tween()
tween.tween_property($Sprite2D, "scale", Vector2(2, 2), 0.5)
# トゥイーンが完了するまで待つ
await tween.finished

print("拡大演出が終わりました")





※とりあえず、自分用のメモです。
間違っている場合があります。