アクター状態の切り替え
機能説明
指定したアクターの状態を切り替えます。デフォルトでは、現在の状態をフェードアウトし、新しい状態を適用してからフェードインし、トランジションの完了後にストーリーを続行します。
構文
text
actor change <キャラクター名> <新しい状態>パラメーター
| パラメーター | 必須 | 例 | 説明 |
|---|---|---|---|
| キャラクター | はい | kona | 状態を切り替えるアクター名 |
| 新しい状態 | はい | happy | 切り替え先の新しい状態 |
例
text
actor change kona happy状態切り替えトランジション
actor change のデフォルトの処理順序は次のとおりです。
- 現在のアクターをフェードアウトします。
- キャラクターシーンに新しい状態を適用します。
- 新しい状態のアクターをフェードインします。
- トランジションの完了後、次のストーリーコマンドを実行します。
KND_ActingInterface ノードのインスペクターでトランジションを設定できます。
| プロパティ | デフォルト | 説明 |
|---|---|---|
enable_actor_state_fade | true | アクターの状態切り替えでフェードを有効にします |
actor_state_fade_duration | 0.3 | トランジション全体の秒数です。フェードアウトとフェードインで半分ずつ使用します |
enable_actor_state_fade を無効にするか、actor_state_fade_duration を 0 にすると、状態は即座に切り替わります。
トランジションは安定したキャラクターマウントをフェードし、キャラクターシーンを複製しません。そのため、画像、動画、Spine、Live2D、独自のキャラクターシーンで同じ切り替え処理を利用できます。対象のアクターが存在しない場合や、シーンが状態を適用できない場合でも、コマンドを完了してストーリーを続行するため、待機したままにはなりません。