UnityのOculus Dash

このガイドでは、Oculus Rift UnityアプリにOculus Dashサポートを追加する方法について説明します。

Rift Core 2.0ではOculusホームに大幅な変更が加えられ、ユニバーサルメニューがOculus Dashに置き換えられました。このページでは、UnityアプリでDashをサポートする方法について説明します。

DashはユニバーサルメニューをVRコンポジターレイヤーとして再実装します。Rift Core 2.0へようこそ⁠のブログ投稿にある、Oculus Dashの紹介動画で、機能について簡単に紹介しています。

ランタイム1.22以降、ユーザーがアプリを一時停止すると、何もない空間にユニバーサルメニューがレンダリングされる代わりに、次のいずれかの状態になります。

Dash UIがアクティブになると、ランタイムは、トラッキングされているコントローラーをシーン内にレンダリングし、メニューを操作できるようにします。

Dashでは、入力フォーカス(つまり、ユーザーがアプリなどにフォーカスしているかどうか)のコンセプトが導入されています。アプリにDashサポートを追加すると、ユーザーのフォーカスが別の場所にあっても、アプリ実行時に適切に処理が行われます。

アプリにフォーカス入力があるかどうかを確認するには、フレームごとにOVRManager.hasInputFocusに対するクエリを実行します。アプリにフォーカスがある場合、hasInputFocusはtrueを返します。ユーザーがDashメニューを開いたときやHMDを削除したときなど、ユーザーのフォーカスが別の場所にある場合、hasInputFocusはfalseを返します。

シングルプレイヤーのアプリや体験では、アプリを一時停止し、オーディオ再生をミュートし、シーン内でトラッキングされているコントローラー/手のレンダリングを停止できます(Dashは別のハンドセットを使用します)。

マルチプレイヤー体験では、入力フォーカスがない場合に別の動作を設定することもできます。アプリにフォーカス入力がない間は、手を非表示にして入力を無視し、オーディオの再生と背景のマッチングを継続するように設定できます。

OVRManager.hasInputFocusの詳細は、アプリのライフサイクル処理をご覧ください。

アプリでDashを適切にサポートするには、Oculus OVRPluginバージョン1.19以降を使用する必要があります(詳しくはスタートガイドのUnity Editorのインストールに記載されている、サポート対象のUnityバージョンを参照)。ビルトインDashサポートを含むバージョンのUnityエディターを使用することをおすすめします。これらのバージョンでは、Dashをサポートするようアプリを簡単に設定できます。深度情報が自動的に提供されるため、シーン コンテンツとの深度の競合なく、シーン上にDash UIを描画できます。

Dashサポートは次のUnityバージョンで提供されています。

以下を選択して、UnityエディターにDashサポートを追加してください。

Share Depth Buffer: 深度情報は、シーン内でレンダリングされたDash UIとシーン内のオブジェクトで、深度の競合を回避するのに役立ち、コンポジターレイヤーの深度テストを可能にします。

Dash Support: このボックスをチェックすると、アプリがDashと互換性があることをOculusランタイムに通知するように設定されます。アプリをDashでテストし、正常に機能することを確認するまで、ストアへの提出を目的としたビルドではこのボックスをチェックしないでください。

Dashサポートが提供されているすべてのカスタムUnityビルドに加え、Unity 2017.3b11以降と2017.3f1-2版では、Dashサポートがデフォルトで有効になっています。ほかのすべてのバージョンではデフォルトで無効になっており、2017.3f3以降ではデフォルトで無効になる予定です。

これらのチェックボックス設定に加えて、起動パラメーター-oculus-focus-awareをtrueに設定したアプリの起動によっても、Dashサポートを有効にすることができます。

アプリで入力フォーカスが失われた場合の典型的な処理の例については、Unityスターターサンプル⁠内の入力フォーカスのサンプルをご覧ください。