Model Vista States

Model Vista States は、シーンまたはプレハブに設定可能な状態セットを公開するランタイムコンポーネントです。各状態セットには、わかりやすい Configurable 名、任意のサムネイル、UI 表示設定、現在のオプション番号、次／前への Input Action、任意の自動再生設定、オプションごとのトリガーまたはホールド用 Input Action があります。

使用可能な State コンポーネントは次のとおりです。

コンポーネント	用途
ActivationStates	対象 GameObject の組み合わせをオン／オフします。
MaterialStates	設定済みの対象 Renderer のマテリアルを切り替えます。
TransformStates	対象 Transform にローカル位置と回転のオプションを適用します。
CameraStates	基準 Transform に対して対象カメラを移動し、視野角または投影設定を適用できます。
AnimationStates	レガシー Animation のクリップ、または互換性のある glTF アニメーションプレイヤーをアニメーション番号で再生します。
GroupStates	複数の Model Vista States コンテナの対象オプションをまとめて選択します。
ShaderStates	float、Boolean キーワード、vector、color、HDR color の値をグローバルまたは対象マテリアルに適用します。
LightStates	EV100 強度、カラーフィルター、色温度のオプションを対象ライトに適用します。

エクスポートする GLB にバリアント選択、プレゼンテーション状態、アニメーションコントロール、シェーダー値、ライティング選択を含め、Model Vista やその他の互換ランタイムで使用する場合に、これらのコンポーネントを使用します。

共通のオプション動作

各 Configurable には次の項目を設定できます。

• Configurable Name：ツールとランタイム UI に表示する、わかりやすい状態セット名。
• Thumbnail：Editor またはランタイムブラウザで状態セットに表示する Sprite。
• UI Visibility：UI システムと State Manager の表示フィルターに対する Visible または Hidden。
• Current Option：現在有効な状態の番号。
• Previous / Next Option Actions：再生モードでオプションを前後に切り替える Input Action。
• Apply Current Option On Awake：コンポーネントの Awake 時に選択済みオプションを適用します。
• Autoplay：間隔を設定できる、任意の順番またはランダム再生。

各オプションには次の項目を設定できます。

• Display Name：ツールとランタイム UI に表示する、わかりやすい状態名。
• Thumbnail：Editor またはランタイムの State ブラウザに表示する Sprite。
• Transition Duration：ブレンド対応時に使用する状態変更のブレンド時間。
• Ease Mode：Ease In Out または Linear の補間。
• Trigger Action：そのオプションへ切り替える Input Action。
• Hold Action：押している間だけそのオプションへ一時的にブレンドし、離すと以前のオプションへ戻す Input Action。
• On Selected：オプションが有効になったときに呼び出す UnityEvent。

Transform オプションには Apply Position と Apply Rotation の切り替えがあります。Camera オプションには Apply Position、Apply Rotation、Apply Field Of View、Apply Projection の切り替えがあります。

Group の遷移タイミング

GroupStates には 2 種類のタイミングモードがあります。

• ParentGroupDuration は、選択した Group オプションの遷移時間とイージングを使用して、リンクされたすべての States をまとめて制御します。これはデフォルトです。
• LinkedStateDurations は、リンクされたすべての States を同時に開始しながら、各リンク先オプション独自の遷移時間を維持します。

タイミングモードは GLB+ のエクスポートとインポートで保持されます。このフィールドがない古いファイルでは ParentGroupDuration が使用されます。