State Behaviors

Animatorウィンドウで特定のステートを選択すると、State Behaviorsを追加できるようになります。これらはステートに対するコンポーネントのようなもので、さまざまな処理を行います。実際にいくつか追加して、何ができるか試してみてください！

すべてのState Behaviorsは、そのステートへの遷移の最初のフレームで実行されます。

State Behaviorsは、ステートマシンがそのState Behaviorsを含むステートにどれだけ長く留まっていたとしても、実行されるはずのものです。

Animator Layer Controller

Animator Layer Controlを使用すると、任意のPlayable Layer内の特定のAnimator Layerのウェイトを、指定した時間をかけてブレンドできます。

ブレンド時間の途中でステートから出た場合、対象のレイヤーは即座に目標のウェイトに設定されます。

レイヤーのウェイトは、他のステートがこのステートビヘイビアを再度実行してリセットするまで維持されます。

Animator Locomotion Control

Animator Locomotion Controlは、アニメーターの特定のステートにおいて移動（Locomotion）を無効化する機能です。このLocomotion状態は、他のステートが再度このState Behaviorを実行し、設定を変更するまで維持されます。

デスクトップモードでは、並進移動が無効になり、回転（視点）移動は垂直軸のみに制限されます。VRモードでは、コントローラーによる並進移動と回転移動が無効になり、半身IKが制限されます（フルボディIKには影響しません）。いずれのモードでも、プレイヤーのカプセルは固定されます。

Animator Temporary Pose Space

Animator Temporary Pose Spaceコントロールを使用すると、アバターを着用している人の視点を、そのAnimatorステートの特定の時点における頭の位置に移動させることができます。

視点は、他のステートがこのState Behaviorを再度実行してリセットまたはクリアするまで、設定されたままとなります。

この動作は、Delay Timeが経過した時に実行されます。

Animator Temporary Pose Spaceは、座ったり地面に横たわったりするなど、姿勢の変化によって視点の高さを更新する必要がある場合にのみ使用してください。これをアバターの「スケール変更」に使用することはできません。そのように使用すると、重大な不具合を引き起こします。

Animator Tracking Control

Animator Tracking Controlを使用すると、アバターの体のさまざまな部位におけるIKやシミュレートされた動きの有効・無効を切り替えることができます。オプションを「No Change」に設定すると、その部位の現在の値は変更されません。「Tracking」に設定すると、IKまたはシミュレートされた動きに従うようになります。「Animation」に設定すると、アバターのAnimatorから与えられた値を強制的に適用するようになります。

すべてのIKトラッキングポイントを「Animation」に設定する場合、アニメーションはNetworked IKを介して変換されるのではなく、リモート環境でもアニメーションとして直接再生されます。各トラッキングタイプにおける「IKトラッキングポイント」は以下の通りです。

• Desktop: Head, Left Hand, Right Hand
• 3pt Tracking: Head, Left Hand, Right Hand
• 6pt / FBT Tracking: Head, Left Hand, Right Hand, Hip, Left Foot, Right Foot

Tracking の設定は、他のステートでこの State Behavior が再度実行され、リセットされるまで保持されます。

Avatar Parameter Driver

Avatar Parameter Driverは、様々な方法でAnimator Parameterを操作できます。1つのAvatar Parameterで複数の操作を実行でき、それらは上から順に処理されます。これらの操作は、このビヘイビアが設定されているステートに移行した際に1回だけ実行されます。

Local Onlyを有効にすると、isLocalを検知する代わりに、そのドライバーをローカル環境でのみ動作させます。

「Add」をクリックすると、ドライバーに新しい操作が追加されます。最初のタイプ（デフォルトで選択されています）は「Set」です。

同期されたパラメータ（VRCExpressionParametersオブジェクトで定義されたもの）を変更する場合、その値は最大範囲にクランプされます。Int型は[0, 255]、Float型は[-1, 1]となります。

ただし、Animation Controllerでのみ定義されているパラメータ（いわゆる「ローカルパラメータ」）は、引き続きパラメータドライバーで変更可能です。それらの値はクランプされません。

また、VRChatで定義されたAnimator Parameterを操作することはできません。

Set、Add、Random、Copyはfloat型およびint型で機能します。Set、Random、Copyはbool型で機能します。

Set

Setは、Destinationで指定されたパラメータに値を単純に代入します。

Add

Addは、Destinationで指定されたパラメータにValueを加算します。

コンポーネントにも記載されている通り、Addを使用すると、アバターのリモートインスタンスで実行した際に同じ結果にならない可能性があります。Addを使用する場合は、同期されたDestinationパラメータを使用し、ドライバーをローカルのみで実行してください。

Random

Randomは、DestinationパラメータにMin ValueからMax Valueまでの間のランダムな数値を設定します。

コンポーネントにも記載されている通り、Randomを使用すると、アバターのリモートインスタンスで実行した際に同じ結果にならない可能性があります。Randomを使用する場合は、同期されたDestinationパラメータを使用し、ドライバーをローカルのみで実行してください。

Booleanパラメータを使用する場合は、Chance変数を使用してパラメータがtrueに設定される確率を指定できます。

Intパラメータを使用する場合は、Prevent Repeats設定を使用して、同じ値が連続して選択されるのを防ぐことができます。

Copy

Copyは、Source Parameterの値をDestination Parameterに設定します。これは、あるfloatを別のfloatと一致させる、あるfloatを別の範囲にリマップする、あるいは全く異なる型同士で変換を行うといった用途に使用できます。

型の変換

bool から変換する場合、Falseは0、Trueは1として扱われます。

bool に変換する場合、0はFalseとなり、それ以外のすべての値はTrueとなります。 int に変換する場合、常に最も近い整数へ切り捨てられます。 float に変換する場合、値がそのままコピーされます。これは、他のプレイヤーと同期可能な範囲を超えた値であっても同様です。

Custom Ranges

Convert Range チェックボックスを使用すると、カスタム変換範囲を設定できる追加のUIを有効にできます。これは、値をリマップしたり、ある型から別の型へどのように変換されるかを正確に制御したりするために使用できます。

Playable Layer Control

Playable Layer Controlを使用すると、Playable Layer全体のウェイトを指定した値まで、指定した期間でブレンドできます。Animator Layer Controlと非常に似ていますが、こちらはPlayable Layer全体を制御します。

Action Playableレイヤーでは、このステートビヘイビアが頻繁に使用されます。Actionレイヤーのウェイトはデフォルトで0であり、アニメーション完了後は常に0に戻す必要があるためです。

ブレンド期間中にステートから抜けた場合、Playable Layerは直ちに目標のウェイトに設定されます。

Animator Play Audio

「Animator Play Audio」ビヘイビアは、アニメーションステートへ遷移した際にAudioSourceを変更します。オーディオクリップやピッチ、ループ設定を変更したり、AudioSourceを再生したりすることが可能です。

AudioSourceへの相対パス（例：Armature/Hips/Spine/）を「Source Path」プロパティに入力する必要があります。このプロパティは、オーディオソースコンポーネントを選択することで自動的に入力できます。オーディオソースがアバターのルートにある場合、「Source Path」は空欄にしてください。

「Playback order」プロパティは、すべてのプレイヤーでオーディオクリップが同じ順序で再生されることを保証するものではありません。 たとえば、「Random」設定では、プレイヤーごとに異なるクリップが選択される可能性があります。すべてのプレイヤーに同じクリップを聞かせたい場合は、複数のアニメーションステートを使用するか、「Playback Order」を「Parameter」に変更し、同期されたアニメーターパラメーターと組み合わせて使用してください。

「Animator Play Audio」はサブステートマシン内のステートに追加できます。ただし、サブステートマシン自体に追加することは推奨されません。ステートビヘイビアがサブステートマシン内のすべてのステート遷移で適用されるため、他のステートビヘイビアと意図しない干渉を引き起こす可能性があります。

各オーディオ設定には追加のプロパティがあります。デフォルトでは「Apply If Stopped」に設定されています。これは、Audio Sourceが前のクリップの再生を終了しておらず、「Stop Audio Source On Enter」が無効になっている場合に、設定が適用されるのを防ぎます。上記の説明を参照してください。