Version: 5.5
Experimental: this API is experimental and might be changed or removed in the future.

Playable

struct in UnityEngine.Experimental.Director

マニュアルに切り替える

説明

Playable は複雑な動作をさせるために、ツリー構造でお互いに接続することによってカスタマイズが可能な、ランタイムオブジェクトです。

Playable は複雑で柔軟なデータを評価するツリーを作成するために使用できます。それらは (Playable.Connect を介して) お互いに接続することができ、各ツリーの Playable はその子の "weight" や "influence" を設定できます。 Playable のツリーが作成されると、DirectorPlayer コンポーネントと一緒に用いて "played" できます (DirectorPlayer.Play を参照してください) 。

Playable (または Playable ツリー) は DirectorPlayer に関連付けられ、プレーヤーは 1 つずつ Playable を走査します。ツリーで Playable に遭遇するたびに PrepareFrame メソッドを呼び出します。これにより、Playable が「次の評価のために準備」することができます。これが、各 Playable が (新しく入力を追加するか、いくつかを削除することで) 子を変更できる PrepareFrame ステージです。これにより、ランタイム時に Playable は Playable ツリーで新しい子の枝を "生成" できるようになります。つまり、 Playable ツリーは静的な構造体ではなく、経時的に適応し変化できるということです。

AnimationPlayable は Playable のよい使用例です。AnimationPlayable を利用すると、 AnimationPlayableMixer を介して既存の AnimationClip を接続することができます。これは Locomotion ブレンドツリーのように アニメーションの動作をプログラムして作成するために使用できます。 AnimationPlayable ツリーが作成されると、Animator.Play メソッドを介して、それを Animator コンポーネントに渡すことができます。

Static 変数

Null空の入力接続を作成するための Null の Playable

変数

duration存続時間 (秒)
inputCountPlayable の入力数。この数にはどこにも接続していない Slot が含まれています。これは GetInputs().Length と同じですが、それを呼び出すよりもはるかに高速です。
outputCountPlayable の出力回数。現在、出力は 1 回のみサポートされています。
stateこの Playable の現在の PlayState 。これは現在、Playable が再生中か、一時停止中かどうかを示します。
timeこの Playable の現在のローカルタイム

Public 関数

CastToCastTo メソッドを使用して、互換性のある Playable 型の間で転換を行うことができます。
Destroyこの Playable に紐づくリソースをリソースをリリースするためにこのメソッドを呼び出します。
GetInput指定したインデックスに接続されている Playable を返します。
GetInputsPlayable の入力リストを返します。
GetInputWeight指定したインデックスの Playable のウェイトを取得します。
GetOutput指定されている出力のインデックスに接続している Playable を返します。
GetOutputsGet the list of outputs connected on this Playable.
IsValidPlayable が有効の場合は true を返します。Playable が削除されている場合は、無効です。これは、Null Playable とは異なります。
SetInputWeightSets the weight of an input.

Static 関数

Connect2 つの Playable を一緒に接続します。
CreatePlayable のインスタンスを作成します。
DisconnectPlayable からの入力を切断します。
GetTypeOfPlayable の型を取得します。

メッセージ

OnSetPlayStatePlayState が変更されたときに呼び出されるコールバック
OnSetTime現在の時刻が変更されたときにコールバックが呼び出されます。
PrepareFrame次のフレームのために Playable ツリーを準備します。 PrepareFrame はツリーが評価される前に呼び出されます。