Live Link データを使用する

Live Link を使用すると、幅広いソースからさまざまな種類のデータをストリーミング することができ、そのデータをレベル内でアクタに直接適用することができます。 Unreal Engine は、ユーザーのレベルのアクタに Live Link データを適用するプロセスを合理化するために次のような機能を提供し、これらのワークフローを改善しています。

• Live Link プリセット は、後で使用できるソース設定を保存します。

• LiveLink コントローラー コンポーネント は、LiveLink コントローラーの使用を有効にします。 LiveLink コントローラーを使用することで、Live Link 情報をアクタに適用するプロセスが簡略化されます。さらに、このデータを収集するためのブループリント ノードもいくつか追加されました。

• LiveLink スケルタル アニメーション コンポーネント は、LiveLink が更新されるたびにサブジェクトとソースの情報を取得する OnLiveLinkUpdated イベント ノードを公開します。また、このノードでは、ブループリントを使用して他の多くの関数を実行することもできます。

Live Link の有効化および接続の設定に関する詳細については、「Live Link プラグイン」 のドキュメントを参照してください。

Live Link プリセット

Unreal Engine は、[Live Link Connection (Live Link 接続)] ウィンドウで作成したさまざまなソースから Live Link データを取得します。 作成されたソースは プリセット として保存することができ、 Apply to Client ノードを使用してブループリントからアクセスできます。

このノードを使用すると、アプリケーションの起動時に Live Link プリセットをロードできます。

Live Link コンポーネント

LiveLink Skeletal Animation コンポーネント

[コンポーネント] パネルからアクタのブループリントに LiveLink スケルタル アニメーション コンポーネントを追加しても、他のコンポーネントの親にはなりません。 このコンポーネントはブループリント内に配置され、On Live Link Updated Event (Live Link 更新時のイベント) へのアクセスを提供します。

On Live Link Updated イベントは、コンポーネントが更新されるたびにトリガーされます (エディタ内を含む)。

On Live Link Updated ノードは、事実上 Tick Event と同じように機能しますが、エディタ内でも実行されます。 例えば、エディタ内でライブ データを使用したい場合に On Live Link Updated ノードを使用できます。

LiveLink Controller コンポーネント

Live Link Controller コンポーネントは、Live Link コントローラーを使用する機能を提供する、キャラクターのブループリント内に配置されているコンポーネントです。 これらのコントローラーは、Live Link サブジェクトからデータを自動的に取得して、Live Link コントローラーを介してアクタの対応するコンポーネントに取得したデータを適用します。

Live Link コントローラーを使用する

Live Link コントローラーは、迅速に Live Link データを取り込み、シーンのアクタに取り込んだデータを適用する手段を提供します。 各コントローラーは Live Link サブジェクトのデータを使用して、選択したアクタに自動的に適用します。 コントローラーには次の 3 種類があり、役割別に定義されています。

• トランスフォーム

• カメラ

• Light (ライト)

各 Live Link コントローラーの詳細は次のとおりです。

トランスフォーム

トランスフォーム コントローラーは、Live Link サブジェクトからトランスフォーム データを素早く取得して、レベルのアクタに適用します。

このコントローラーには次のオプションがあります。

カメラ

カメラ コントローラーは、[Camera Role (カメラの役割)] が設定された Live Link サブジェクトからレベルのカメラ アクタにカメラの設定と動きのデータを直接適用します。

アニメートできるカメラ設定には次のものがあります。

• 視野角 (度単位)

• アスペクト比 (幅/高さ)

• 焦点距離

• F 値によるカメラの開口径

• カメラのフォーカス距離(cm 単位。マニュアルのフォーカスでのみ機能する)

• カメラの投影モード (パースペクティブ、正投影など)

ライト

ライト コントローラーは、[Lignt Role (ライトの役割)] が設定された Live Link サブジェクトからレベル内のライト アクタにライト設定を直接適用します。

アニメートできるライト設定には次のものがあります。

• 色温度 (ケルビン単位)

• 全エネルギー (ルクス単位)

• フィルタカラー

• 内側のコーン角 (スポット ライト用、度単位)

• 外側のコーン角 (スポットライト用、度単位)

• ライトの目に見える影響 (ポイント ライトおよびスポット ライトの場合)。

• 光源形状のソフト半径 (ポイント ライトとスポット ライトの場合)。

• 光源形状の長さ (ポイント ライトおよびスポット ライトの場合)。

アクタにコントローラーを適用する

Live Link コントローラーを適用するには、まずアクタに Live Link コントローラー コンポーネントを追加します。

次の手順で、[Details (詳細)] パネルからコンポーネントを追加します。

1. レベルでアクタを選択します。

2. [Details (詳細)] パネルで、[+ Add Component (+ コンポーネントを追加)] ボタンをクリックして、[Live Link ControllerLive Link コントローラー)] コンポーネントを検索します。

3. 追加したら、そのコンポーネントをコンポーネント リストから選択し、[Subject Representation (サブジェクト表現)] ドロップダウン メニューを開きます。 このアクタのデータ ソースとして使用するサブジェクトをリストから選択します。 選択内容に基づいて [Component to Control (制御対象のコンポーネント)] の設定が自動的に選択されます。 必要に応じて調整することも可能です。

コントローラーの設定が完了すると、選択した Live Link サブジェクトからのデータ受信をアクタが自動的に開始します。

一般的なブループリント ノード

Live Link データには、各種ブループリント ノードを介してアクセスできます。

Get Live Link Subjects

Evaluate Live Link Frame ノードで使用するサブジェクトのリストを取得しなければならない場合があります。 そのような場合には、次を使用できます。Get Live Link Subjects ：

Evaluate Live Link Frame 関数によって有効であると判断されたサブジェクトの配列を返します。

Evaluate Live Link Frame

Evaluate Live Link Frame 関数を呼び出すことで、指定されたサブジェクト名に関連付けられた Live Link データを取得できます。 この関数は、現在のフレームが有効かどうかを示す実行ピンと、Data Result 出力からアクセス可能なスタティック データとフレーム データを提供します。 このデータは、サブジェクトを評価するために選択された Role のタイプによって決まります。

次の例では、データ構造体ピンから直接アクセスされるデータを示しています。

Evaluate Live Link Frame のデータを使用する

Evaluate Live Link Frame により、Evaluate Live Link Frame で提供されるデータの評価に使用可能ないくつかのブループリント関数にアクセスできるようになります。 結果として得られるデータは評価対象の Role に応じて異なります。 評価対象が [Animation Role] の場合は以下を使用できます。

• Get Basic Data

• Get Curves

• メタデータを取得

• Get Root Transform

• Get Transform by Index

• Get Transform by Name

• Number of Transforms

• トランスフォーム名

Get Basic Data

Get Basic Data ノードは、現在のサブジェクト フレームに格納されているサブジェクトの基本構造を返します。

Get Curves

Get Curves 関数を使用すると、すべてのブレンド形状またはアニメートされたカーブを取得できます。また、この関数は各エントリの Name to Value のマップを返します。

Find を使用して名前を入力すると、カーブの値を取得できます (または、ブーリアン値を使用して、見つかったかどうかを判断することもできます)。

メタデータを取得

Get Metadata 関数は、サブジェクト フレームに格納されているサブジェクト メタデータ構造体を返します。これを分解して情報を取得することができます。

String Metadata は、サブジェクトの名前付き文字列に対する Map です。例えば、ストリーミングされているオブジェクトのタイプを名前付き文字列として渡すことができます。 また、メタデータには、Scene Timecode と Scene Framerate も含まれており、これらの構造体を分解して必要な情報を得ることができます。

Get Root Transform

Get Root Transform 関数は、サブジェクト フレームのルート トランスフォームを Live Link トランスフォーム (トランスフォームがない場合はIdentity として返します。

このノードは、標準のトランスフォームではなく Live Link トランスフォームを返します。Live Link トランスフォームでは追加の関数を呼び出すことができます (概要は次の表を参照)。

Get Transform By Index

Get Transform By Index 関数は、指定されたインデックスでサブジェクト フレームに格納されている Live Link トランスフォームを返します (トランスフォーム インデックスが無効な場合は Identity トランスフォームを返します)。

Get Transform by Name

Get Transform by Name 関数は Get Transform by Index とよく似ていますが、トランスフォーム名のデータを取り込みます。

Number of Transforms

Number of Transforms 関数は、サブジェクト フレーム内のトランスフォームの数を返します。

このユース ケースとしては、Get Transform By Index と併用し、各 Live Link トランスフォームをループして取得することが挙げられます (以下の例と同様)。

Get Transform Names

Get Transform Names 関数は、フレーム内のすべてのトランスフォームの名前の配列を返します。

ブループリントで Live Link プリセットを適用する

ブループリントで Live Link を使用する一般的な例として、ランタイム時に Apply to Client ノードを使用して、 Live Link プリセットをスケルタル メッシュに割り当てることが挙げられます。

1. まず、[Live Link] パネルで Live Link プリセットを作成します。 プリセットの詳細については、「Live Link プラグイン」ドキュメントを参照してください。

2. キャラクターのブループリント内で新しい変数を作成し、[Details (詳細)] パネルで[Variable Type (変数の型)]を[Live Link Preset (Live Link プリセット)] に設定することで、プリセットへの参照を作成します。

3. ブループリントをコンパイルして、新しい変数のデフォルト値を、保存した Live Link プリセットに設定します。

4. 変数をブループリントにドラッグして、メニューから [Get (取得)] を選択します。

5. 変数からドラッグして、Apply to Client ノードを検索します。

6. Event Begin Play ノードを Apply to Client に接続します。