このページでは、Godot のシーン上に SpriteStudio のアニメーションを配置して再生するまでの基本的な手順を解説します。
Note
本ページは .ssab ファイルがすでに Godot プロジェクトにインポート済みであること を前提としています。まだ .ssab が無い場合は、先に アセットのインポートとエディタ連携（エディタからの取り込み）または CLI コンバートと自動化（CLI からの取り込み）を参照してください。
Godot エディタの強力な機能を活かし、最短の手順でアニメーションをセットアップできます。
- ファイルシステムドックから、インポート済みの
.ssabファイル を探します。 - そのファイルを 2D ワークスペース (シーンビュー) へドラッグ＆ドロップします。
これだけで自動的に SpriteStudioPlayer2D ノードがシーンに追加され、リソースの割り当ても完了します。
Tip
既存のノード階層の特定の場所に配置したい場合は、手動でノードを追加してリソースを割り当てることも可能です。
- シーンドックの「＋」ボタンなどから、
SpriteStudioPlayer2Dノードをシーンツリーに追加します。 - 追加したノードを選択し、インスペクタを開きます。
- インスペクタの
SSAB Resourceプロパティへ、ファイルシステムドックから.ssabファイルをドラッグ＆ドロップしてアタッチします。
ノードを選択すると、Godot のインスペクタから各種設定を行えます。
-
Animationの選択 インスペクタのAnimationプロパティのドロップダウンを開くと、.ssabに含まれるアニメーションのリストが表示されます。再生したいアニメーション名を選択してください。 -
エディタ上でのプレビュー ノードを選択すると SpriteStudio ボトムパネルが表示されます。先頭から再生 / 現在位置から再生 / 停止のトランスポートとフレームスクラバを使って、ゲームを実行せずにエディタ上でアニメーションを再生できます。ショートカットは AnimationPlayer エディタと同じく D 現在位置から再生 / Shift+D 先頭から / S 停止（パネルが表示中に有効）。
FrameやSpeed、Loopなどのパラメータを変更するとリアルタイムにプレビューへ反映されるため、素早い調整が可能です。
Tip
| プロパティ | 型 | 説明 |
|---|---|---|
SSAB Resource |
Resource | 再生対象の SSABResource (.ssab ファイル) |
Animation |
String | 選択中のアニメーション名 |
Autoplay |
bool | ゲーム開始時に自動再生するかどうか |
Offset |
Vector2 | 描画位置のオフセット。Transformを動かさずに見た目だけをずらす際に便利 |
Flip H / Flip V |
bool | アニメーションの水平 / 垂直反転 |
Frame |
float | 現在のフレーム位置 |
Speed Scale |
float | 再生速度倍率 (既定: 1.0) |
Frame Rate |
int | FPS |
Loop Count |
int | ループ回数 (-1 で無限ループ) |
Animation Section Start |
int | 部分再生の開始フレーム |
Animation Section End |
int | 部分再生の終了フレーム |
Playback Direction |
int | 再生方向 |
Playback Style |
int | 再生スタイル (片道/往復 等) |
Frame Skip Enabled |
bool | 描画間隔がフレーム間隔を超えた際にフレームを飛ばすか |
Sub Frame Enabled |
bool | サブフレーム補間を有効化するか |
Animation Process Mode |
int | _physics_process (Physics) か _process (Idle) かの同期設定 |