Live Link は、外部ソースから Unreal Engine (UE) にアニメーション データをストリーミングおよび処理するための共通インターフェースを提供します。これは Unreal プラグインで拡張できるように設計されており、エンジンの変更やそのメンテナンスを必要とせずに、サード パーティによる新機能の開発を実現します。
LiveLinkXR は、XR デバイスで使用できるように、この機能を拡張します。LiveLinkXR プラグインを使用することで、Live Link ツールで使用する Vive Trackers や HMD などの XR ソースを追加できます。
LiveLinkXR は現在 OpenXR のみをサポートしています。現在、SteamVR プラットフォームは OpenXR 経由のヘッドレス レンダリング (レンダリングを呼び出さずに VR を実行する) をサポートしています。Vive Trackers を使用するには、SteamVR を実行し、オープン XR ランタイムとして設定する必要があります。
この記事では、LiveLinkXR プラグインの設定と構成、ツールのさまざまな設定の調整についてと、可能なトラブルシューティングと回避策についての手順をご紹介します。
LiveLinkXR を有効化する
-
[Edit (編集)] タブをクリックして展開し、[Configuration (コンフィギュレーション)] 見出しの下にある [Plugins (プラグイン)] をクリックします。
-
検索ボックスを使用して LiveLinkXR プラグインを見つけ、[Enabled] をクリックします。
-
表示されるボックスで [Yes (はい)] をクリックします。
-
検索ボックスを使用して Vivetracker プラグインを見つけ、[Enabled] をクリックします。
-
[Window] タブを展開して [Live Link] をクリックし、Live Link ツールを起動します。
-
次のコマンドライン パラメータを使用してエンジンを閉じて再起動します。-xrtrackingonly
Eg: D:\Program Files\UE_5.2\Engine\Binaries\Win64\UnrealEditor.exe -xrtrackingonly
このコマンド ライン パラメータを使用しない場合、トラッカー、コントローラー、ヘッドセットは VR プレビュー モードまたは VR エディタ モードのときのみ使用できます。 -
[LiveLinkXR Source] オプションを展開して、関連するさまざまな設定を表示します。
ソース設定
LiveLinkXR Source を設定することで、データ ソースとローカル更新レートを調整できます。
| 設定名 | 目的 |
|---|---|
| トラッカーをトラック | OpenXR にある Vive Trackers をすべて追跡します。 |
| コントローラーをトラック | コントローラーをすべて追跡します。 |
| HMD をトラック | HMD をすべて追跡します。 |
| Local Update Rate in Hz | それぞれのデバイスから追跡データを読み取る更新レート (Hz 単位)。 |
LiveLinkXR ソースを追加する
以下のプロセスでは Tracker を備えた Vive HMD を使用して説明しますが、SteamVR がサポートする VR デバイスであれば Live Link XR を使用できます。
必ず SteamVR を実行しているときに新しい LiveLinkXR ソースを追加してください。SteamVR の設定については「SteamVR トラブルシューティング ページ」をご覧ください。
LiveLinkXR プラグインを有効化してニーズに合わせて設定を調整したら、XR ソースを追加する準備が整います。
-
Live Link ツールを起動して [Source] ウィンドウを展開し、[LiveLinkXR Source] 配下の [Add] をクリックします。
-
構成がすべて正しければ、[Add] をクリックすると Live Link ツールの一覧に追加した項目が表示されます。これらの項目は [Data Source] 設定で選択した データ ソース に対応しています。
複数のトラッカー パックを使用する場合は、SteamVR Vive トラッカー設定ウィンドウから、SteamVR で各パックの役割を設定する必要があります。
VR ソースにブループリントとメッシュを関連付ける
LiveLinkXR プラグインを有効化すると、プロジェクトは LiveLinkXR のブループリントとメッシュを利用できるようになります。予め用意されている便利なアイテムを活用して開始しましょう。このセクションでは、こうしたアイテムを見つけて使用する方法を説明します。
-
コンテンツ ブラウザ に移動して [View Options (表示オプション)] メニューを展開し、[Show Engine Content (エンジンのコンテンツを表示)] と [Show Plugin Content (プラグインのコンテンツを表示)] を選択します。
-
コンテンツ ブラウザ のナビゲーション ウィンドウに表示された新しいアイテムが、すぐに見つかるはずです。
-
コンテンツ ブラウザ にある「LiveLinkXR Content」フォルダから、「Blueprints」フォルダを開きます。
-
目的のシーンに BP_LiveLinkXR_DataHandler をドラッグします。
[Toggle Debug Vis] オプションによって、受信している追跡データを確認できます。これを行う際は Toggle Debug Vis デバッグ ツールを使用します。
1.Live Link のソースを設定して BP_LiveLinkXR_DataHandler をシーンにドラッグし、[World Outliner (アウトライナ)] からハンドラーを選択して [Details (詳細)] パネルに移動します。 1.[Default] カテゴリを展開して [Toggle Debug Vis] ボタンをクリックします。
1.BP_LiveLinkXR_DebugVis デバッグのビジュアリゼーションが、先ほど設定した各 Live Link Source のレベルに表示されます。 1.次に、こうしたアイテムを実世界の動きに合わせて移動するようにします。
-
[World Outliner (アウトライナ)] で [BP_LiveLinkXR_DataHandler] を選択し、[Details (詳細)] パネルに移動します。
-
新しいエントリを追加する際は、[Details (詳細)] から [Default] セクションを展開し、[Subject Name to Attached Actor] の横にある [Add (追加) (+)] ボタンをクリックします。
-
新しい要素の横にあるテキスト ボックスに、[Live Link] ウィンドウの [Subject Name] を入力します。
- 必要に応じて、追跡対象のすべてのソースに対して、この手順を繰り返します。
-
目的の要素の横にある ドロップダウン メニュー を使用して、追跡データ をシーンにある オブジェクト や アクタ にマッピングします。
キャリブレーション
[Toggle Debug Vis] の横にある [Calibrate] ボタンを使用して、ワールドにある任意のアクタに相対的な新しい追跡基点を設定できます。これをクリックすると、LiveLink Subject である Calibration Subject Name のトランスフォームを使用して、Calibration Target Actor のトランスフォームに相対的な新しいワールド基点のトランスフォームを計算します。
-
キャリブレーション機能を利用する際は、最初に [World Outliner (アウトライナ)] から [BP_LiveLinkXR_DataHandler] を選択します。 [Details (詳細)] パネルで、[Calibration Target Actor] の横にあるドロップダウンからレベルにあるアクタを選択します。
-
その対象アクタを選択した後で、表示されるボックスに Calibration Subject Name を入力します。これは追跡対象である LiveLink Subject の名前の 1 つと一致する必要があります。
- 設定を調整してから、[Toggle Debug Vis] の横にある [Calibrate] ボタンをクリックします。
- このデバイスの相対的な追跡基点が、これにより新しいキャリブレーションに相対的であることにご注意ください。
左側は、最初にレベルにドラッグした時点の BP_LiveLinkXR_DataHandler アクタの位置情報です。右側は、レベルにある別のアクタに相対的なキャリブレーションを行った後の位置情報です。
Vive Trackers を HMD なしで使用する
デフォルトで Vive Trackers は HMD なしで使用できません。このセクションでは、UE で Trackers を HMD なしで使用するための、可能な回避策の概要を説明します。
このプロセスは可能な回避策であり、Valve、HTC、Epic はいずれもサポートしていません。そのため、予期せぬ動作中断や、SteamVR の予期せぬ問題を引き起こす可能性があります。SteamVR のトラブルシューティングに関する専門知識を持っている場合にのみ、この回避策を試すことを推奨します。
-
最初に Steam と SteamVR を完全にシャットダウンします。
メイン プログラムを閉じた後、タスク マネージャーで Steam のプロセスがすべて終了したことを確認します。
-
コンピュータ上で次のファイルを探します：
<Steam インストール ディレクトリ> /steamapps/common/SteamVR/drivers/null/resources/settings/default.vrsettings
-
ファイルをコピーし、ファイル拡張子の末尾に「_BACKUP」を追記します。
-
この手順で概説するファイルのバックアップ方法はいくつかあります。以下に示すのは、オリジナルをコピーしてファイル拡張子を変更する方法です。
-
元の
default.vrsettingsファイルをテキスト エディタで開きます。 -
driver_nullオブジェクトのenableプロパティ値をfalseからtrueに変更します。
nDisplay を使用している場合は、
windowWidth、windowHeight、renderWidth、renderHeightを 0 (ゼロ) に設定します。この方法で、画面中央に表示される最小化できない VR コンポーザー ウィンドウを回避できます。 - 保存して閉じます。
-
次のファイルを探します。：
<Steam インストール ディレクトリ>/steamapps/common/SteamVR/resources/settings/default.vrsettings
このファイル名は同様ですが、異なるフォルダに存在します。
-
default.vrsettingsファイルのバックアップを作成します。
steamvr見出し配下のrequireHmd設定をfalseに変更します。steamvr見出し配下のforcedDriver設定を"null"に変更します。steamvr見出し配下のactivateMultipleDrivers設定をtrueに変更します。-
正しい設定に更新すると、このファイルは次のようになります。
"steamvr": { "requireHmd": false, "forcedDriver": "null", "forcedHmd": "", "displayDebug": false, "debugProcessPipe": "", "enableDistortion": true, "displayDebugX": 0, "displayDebugY": 0, "allowDisplayLockedMode": false, "sendSystemButtonToAllApps": false, "loglevel": 3, "ipd": 0.063, "ipdOffset": 0.0, "background": "", "backgroundUseDomeProjection": false, "backgroundCameraHeight": 1.6, "backgroundDomeRadius": 0.0, "environment": "", "hdcp14legacyCompatibility": false, "gridColor": "", "playAreaColor": "", "showStage": false, "activateMultipleDrivers": true, default.vrsettingsファイルを保存して閉じます。- Steam と SteamVR を起動します。
- SteamVR の設定を変更したため、Room Calibration 設定の再実行が必要です。
-
Room Calibration の完了後に SteamVR を起動すると、HMD を必要とせずにデバイスを追跡可能になります。
- HMD を再度使用する準備ができた場合は、SteamVR を閉じて 編集したファイルをバックアップから 復元し、SteamVR を再起動します。
トラブルシューティング
SteamVR の問題
HMD、コントローラー、Tracker が SteamVR に表示されない場合は、UE にも表示されません。VR デバイスの設定で問題が発生した場合は、「Steam VR Troubleshooting」ガイドのサポート情報を確認することを推奨します。
