OpenXR の概要

HoloLens 2 で OpenXR を使用するか、デスクトップで Windows Mixed Reality イマーシブ ヘッドセットを使用して開発できます。 ヘッドセットへのアクセス権がない場合は、代わりに HoloLens 2 Emulator または Windows Mixed Reality シミュレーターを使用できます。

HoloLens 2 の OpenXR の概要

HoloLens 2 用の OpenXR アプリケーションの開発を開始するには:

  1. HoloLens 2 を設定するか、指示に従って、 HoloLens 2 emulator の最新バージョンをインストールします。 最近のエミュレーターイメージを使用しているか、デバイスで OS が更新されている場合は、OpenXR 1.0 を準備しておく必要があります。
  2. デバイスまたはエミュレーターから ストア アプリを起動して、すべての 拡張機能を備えた最新の OpenXR ランタイムがあることを確認します。
    • 右上のメニューを開き、[ ダウンロードと更新] を選択し、[ 更新プログラムの取得] を選択します。

注意

エミュレーターを使用している場合は、エミュレーターイメージを起動するたびにリセットされるので、最良の方法は、 HoloLens 2 エミュレーターイメージの最新バージョンがあることを確認することだけです。

Windows Mixed Reality ヘッドセット用の OpenXR の概要

イマーシブ Windows Mixed Reality ヘッドセット用の OpenXR アプリケーションの開発を開始するには:

  1. 少なくとも Windows 10 May 2019 Update (1903) を実行していることを確認してください。これは、エンドユーザーが OpenXR アプリケーションを実行するための最小要件である Windows Mixed Reality です。 以前のバージョンの Windows 10 を使用している場合は、 Windows 10 Update Assistantを使用してアップグレードできます。
  2. Windows Mixed Reality ヘッドセットを設定するか、指示に従ってWindows Mixed Reality シミュレーターを有効にします。

これで完了です。 Windows Mixed Reality OpenXR ランタイムがインストールされ、すべての Windows Mixed Reality ユーザーに対して自動的にアクティブになります。 Microsoft Store は、ランタイムを最新の状態に保ちます。

Windows Mixed Reality OpenXR Runtime を再度アクティブ化するには、スタートメニューから Mixed Reality ポータルを起動し、ウィンドウの上部にある [修正] を選択します。 このボタンがない場合、OpenXR ランタイムは既にアクティブになっています。

Windows Mixed Reality の OpenXR 開発者ツールを取得する

Windows Mixed Reality OpenXR ランタイムを試すには、 Windows Mixed Reality アプリの OpenXR 開発者ツールをインストールします。 このアプリは、さまざまな OpenXR 機能のデモを、アクティブなランタイムと現在のヘッドセットに関する重要な情報を含むシステムステータスページと共に提供します。

HoloLens 2 エミュレーターを使用する場合、Windows Mixed Reality 用の OpenXR 開発者ツールをインストールする最も簡単な方法は、 Windows デバイスポータルを使用することです。 "OpenXR" ページに移動し、[開発者機能] の下にある [インストール] ボタンをクリックします。これは、物理 HoloLens 2 デバイスでも機能します。

Windows Mixed Reality アプリの OpenXR 開発者ツール

OpenXR API とサンプルアプリの調査

OpenXR の開発に必要なツールをまだインストールしていない場合は 、必ずインストール してください。

BasicXrAppプロジェクトは、Visual Studio に Win32 および UWP HoloLens 2 プロジェクトファイルを含む単純な OpenXR サンプルを示しています。 ソリューションには HoloLens UWP プロジェクトが含まれているため、ユニバーサル Windows プラットフォームの開発ワークロードを完全に開くには Visual Studio にインストールする必要があります。

Win32 と UWP のプロジェクトファイルは、パッケージ化と配置の違いによって分離されていますが、各プロジェクト内のアプリコードはほぼ同じです。

OpenXR アプリの実行

OpenXR Win32 desktop .EXE を構築した後、OpenXR をサポートするすべてのデスクトップ VR プラットフォーム (ヘッドセットの種類にかかわらず) で、VR ヘッドセットと共に使用できます。

OpenXR UWP アプリパッケージをビルドした後、そのパッケージを HoloLens 2 デバイスまたは HoloLens 2 Emulator に展開できます。

OpenXR API のラーニング

OpenXR API のツアーについては、Visual Studio のBasicXrAppサンプルの60分のビデオをご覧ください。 このビデオでは、OpenXR API の各主要コンポーネントを独自のエンジンで使用する方法について説明し、OpenXR 上に構築されたいくつかのアプリケーションについて説明します。

既存のプロジェクトでの OpenXR の使用

既存のプロジェクトで OpenXR の使用を開始するには、OpenXR ローダーを追加します。 ローダーは、デバイス上のアクティブな OpenXR ランタイムを検出し、実装するコア関数および拡張関数へのアクセスを提供します。

公式のOpenXR NuGet パッケージは、Visual Studio プロジェクトから参照するか、Khronos GitHub リポジトリから公式の OpenXR loader ソースを含めることができます。 どちらの方法を使用しても、OpenXR 1.0 のコア機能に加えて、公開された拡張機能にアクセスでき KHR EXT MSFT ます。

拡張機能も試してみたい場合は MSFT_preview 、Mixed Reality GitHub リポジトリからOpenXR のヘッダーをコピーできます。

オフィシャル OpenXR NuGet パッケージの参照

OpenXR NuGet パッケージは、Visual Studio C++ ソリューションで事前に構築された OpenXR Loader .DLL を参照する最も簡単な方法です。 これにより、OpenXR 1.0 のコア機能に加えて、公開された拡張機能にアクセスできるようになり KHR EXT MSFT ます。

Visual Studio C++ ソリューションに OpenXR NuGet パッケージ参照を追加するには、次のようにします。

  1. ソリューションエクスプローラー で、OpenXR を使用するプロジェクトを右クリックし、[ NuGet パッケージの管理...] を選択します。
  2. [ 参照 ] タブに切り替えて、 OpenXR を検索します。
  3. OpenXR パッケージを選択し、右側の詳細ウィンドウで [インストール] を選択します。
  4. [OK] を選択して、プロジェクトへの変更を受け入れます。
  5. #include <openxr/openxr.h>OPENXR API の使用を開始するには、ソースファイルにを追加します。

動作中の OpenXR API の例については、 BasicXrApp サンプルアプリを参照してください。

公式の OpenXR loader ソースを含める

ローダーを自分でビルドする場合、たとえば、追加のローダー .DLL を回避するには、公式の Khronos OpenXR loader ソースをプロジェクトに取り込むことができます。 これにより、OpenXR 1.0 のコア機能に加えて、公開された拡張機能にアクセスできるようになり KHR EXT MSFT ます。

ここで作業を開始するにはGitHub の Khronos OpenXR リポジトリの指示に従ってください。 プロジェクトは cmake を使用してビルドするように設定されています。 MSBuild を使用している場合は、コードを独自のプロジェクトにコピーする必要があります。

プレビュー拡張機能の使用

MSFT_preview拡張機能のロードマップに記載されている拡張機能は、フィードバックを収集するためにプレビューされている試験的なベンダーの拡張機能です。 これらの拡張機能は開発者向けデバイスのみを対象としており、実際の拡張機能が出荷されると削除されます。

使用可能な拡張機能を試すには MSFT_preview 、次の手順に従ってプロジェクトを更新します。

  1. 上記のいずれかの方法に従って、OpenXR loader をプロジェクトに統合します。
  2. プロジェクトの標準の OpenXR ヘッダーを、 GitHub の Mixed Reality OpenXR リポジトリのプレビューヘッダーに置き換えます。

次に、対象の HoloLens 2 またはデスクトップ PC でプレビュー版の拡張機能のサポートを有効にします。

  1. すべての 拡張機能 を備えた最新の OpenXR ランタイムがあることを確認するには、対象のデバイスまたはエミュレーター内から ストア アプリを起動し、右上のメニューを開いて [ ダウンロードと更新 ] を選択し、[ 更新プログラムの取得] を選択します。
  2. Microsoft Store からターゲットデバイスにWindows Mixed Reality アプリの OpenXR 開発者ツールをインストールして実行します。
  3. [ Developer 設定] タブに移動し、[ latest preview OpenXR runtime] を有効にします。 これにより、プレビューの拡張機能がアクティブ化されたデバイスでプレビューランタイムが有効になります。 Windows Mixed Reality アプリ開発者設定タブの OpenXR 開発者ツール
  4. OpenXR 開発者ツールの [システムの状態] タブに表示される ランタイムのバージョン を確認します。 Windows Mixed Reality は、試してみる予定のプレビュー拡張機能の必要なバージョンと一致します。 その場合は、 拡張機能の一覧に 拡張機能が表示されます。 安定した拡張機能が利用可能になると、そのプレビュー拡張機能が削除されます。
    Windows Mixed Reality アプリの [システムの状態] タブの OpenXR 開発者ツール

これらのプレビュー拡張機能のドキュメント、およびそれらの使用方法のサンプルについては、「 Mixed Reality OpenXR リポジトリ 」を参照してください。

トラブルシューティング

OpenXR の開発に関する問題が発生した場合は、 トラブルシューティングのヒントを確認してください。