OpenXR の概要Getting started with OpenXR

HoloLens 2 で OpenXR を使用するか、デスクトップで Windows Mixed Reality イマーシブ ヘッドセットを使用して開発できます。You can develop using OpenXR on a HoloLens 2 or Windows Mixed Reality immersive headset on the desktop. ヘッドセットへのアクセス権がない場合は、代わりに HoloLens 2 エミュレーターまたは Windows Mixed Reality シミュレーターを使用できます。If you don't have access to a headset, you can use the HoloLens 2 Emulator or the Windows Mixed Reality Simulator instead.

OpenXR for HoloLens 2 の概要Getting started with OpenXR for HoloLens 2

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

  1. HoloLens 2 をセットアップするか、「 hololens 2 エミュレーターの最新バージョンをインストールするには」の手順に従います。Set up a HoloLens 2 or follow the instructions to install a recent version of the HoloLens 2 emulator. デバイスが最近 OS を更新した場合、または最近のエミュレーターイメージを使用している場合は、既に OpenXR 1.0 を準備しておく必要があります。If your device has updated its OS recently or if you're using a recent emulator image, you should already have OpenXR 1.0 ready to go.
  2. すべての 拡張機能 を備えた最新の OpenXR ランタイムがあることを確認するには、デバイスまたはエミュレーター内から ストア アプリを起動し、右上のメニューを開き、[ ダウンロードと更新 ] をクリックし、[ 更新プログラムの取得 ] をクリックします。To make sure you've got the latest OpenXR runtime with all extensions present, launch the Store app from within the device or emulator, open the menu in the upper-right, click Downloads and updates and click Get updates . これにより、HoloLens の OpenXR ランタイムが最新の状態に保たれます。This ensures that the OpenXR runtime on your HoloLens is up to date. エミュレーターを使用している場合は、エミュレーターイメージを起動するたびにエミュレーターイメージがリセットされるため、最善の方法は、 HoloLens 2 エミュレーターイメージの最新バージョンがあることを確認することだけです。Note that if you're using the emulator, the emulator image will reset each time you start it, and so your best bet is to just make sure that you have the latest version of the HoloLens 2 emulator image.

OpenXR for Windows Mixed Reality ヘッドセットの概要Getting started with OpenXR for Windows Mixed Reality headsets

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

  1. 少なくとも Windows 10 2019 更新プログラム (1903) を実行していることを確認してください。これは、Windows Mixed Reality エンドユーザーが OpenXR アプリケーションを実行するための最小要件です。Be sure you are running at least the Windows 10 May 2019 Update (1903), which is the minimum requirement for Windows Mixed Reality end users to run OpenXR applications. 以前のバージョンの Windows 10 を使用している場合は、 windows 10 Update Assistantを使用してアップグレードできます。If you're on an earlier version of Windows 10, you can upgrade by using the Windows 10 Update Assistant.
  2. Windows Mixed reality ヘッドセットを設定するか、指示に従って Windows Mixed reality シミュレーターを有効にします。Set up a Windows Mixed Reality headset or follow the instructions to enable the Windows Mixed Reality simulator.

これで完了です。That's it! Windows mixed Reality OpenXR ランタイムがインストールされ、すべての Windows Mixed Reality ユーザーに対して自動的にアクティブになります。The Windows Mixed Reality OpenXR runtime is installed and made active automatically for all Windows Mixed Reality users. Microsoft Store は、ランタイムを最新の状態に保ちます。The Microsoft Store then keeps the runtime up to date.

Windows Mixed Reality OpenXR Runtime を再びアクティブにする必要がある場合は、[スタート] メニューから Mixed Reality ポータルを起動し、ウィンドウの上部にあるバナーで [修正] をクリックします。If you ever need to make the Windows Mixed Reality OpenXR Runtime active again, launch Mixed Reality Portal from the Start menu, and click "Fix it" in the banner at the top of the window. このボタンがない場合、OpenXR ランタイムは既にアクティブになっています。If that button is missing, the OpenXR runtime is already active.

Windows Mixed Reality の OpenXR 開発者ツールの取得Getting the OpenXR Developer Tools for Windows Mixed Reality

Windows Mixed Reality OpenXR ランタイムを試すには、 Windows Mixed reality アプリ用の OpenXR 開発者ツールをインストールします。To try out the Windows Mixed Reality OpenXR Runtime, you can install the OpenXR Developer Tools for Windows Mixed Reality app. このアプリは、OpenXR のさまざまな機能を、アクティブなランタイムと現在のヘッドセットに関する重要な情報を提供するシステムステータスページと共に実行するデモシーンを提供します。This app provides a demo scene that exercises various features of OpenXR, along with a System Status page that provides key information about the active runtime and the current headset.

HoloLens 2 のエミュレーターを使用する場合、Windows 混在環境で OpenXR 開発者ツールをインストールする最も簡単な方法は、 Windows デバイスポータルを使用する方法です。これを行うには、"OpenXR" ページに移動し、[開発者機能] の下にある [インストール] ボタンをクリックします。If using the HoloLens 2 emulator, the easiest way to install the OpenXR Developer Tools for Windows Mixed Reality is using Windows Device Portal, by navigating to the "OpenXR" page and then clicking the "Install" button under "Developer Features". (これは、物理 HoloLens 2 デバイスでも同様に機能します)。(this works on a physical HoloLens 2 device as well)

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

サンプル OpenXR アプリのビルドBuilding a sample OpenXR app

OpenXR の開発に必要なツールをまだインストールしていない場合は 、必ずインストール してください。Be sure to install the tools you'll need for OpenXR development if you haven't already.

BasicXrApp プロジェクトでは、2 つの Visual Studio プロジェクト ファイルにより OpenXR の簡単な例が示されています。1 つは Win32 デスクトップ アプリ、もう 1 つは UWP HoloLens 2 アプリ向けです。The BasicXrApp project demonstrates a simple OpenXR sample with two Visual Studio project files, one for both a Win32 desktop app and one for a UWP HoloLens 2 app. ソリューションには HoloLens UWP プロジェクトが含まれているため、Visual Studio にインストールされた ユニバーサル Windows プラットフォームの開発ワークロード を完全に開く必要があります。Because the solution contains a HoloLens UWP project, you'll need the Universal Windows Platform development workload installed in Visual Studio to fully open it.

Win32 と UWP のプロジェクトファイルは、パッケージ化と配置の違いによって分離されていますが、各プロジェクト内のアプリコードはほぼ同じであることに注意してください。Note that while the Win32 and UWP project files are separate due to differences in packaging and deployment, the app code inside each project is almost exactly the same!

OpenXR Win32 デスクトップを構築した後。EXE を使用して、OpenXR をサポートする任意の desktop VR プラットフォームの VR ヘッドセットと共に使用できます。これは、Windows Mixed Reality ヘッドセットであるか、他のヘッドセットであるかどうかによって異なります。After building an OpenXR Win32 desktop .EXE, you can use it with a VR headset on any desktop VR platform that supports OpenXR, whether it's a Windows Mixed Reality headset or any other headset.

OpenXR UWP アプリケーションパッケージをビルドした後、 そのパッケージ を hololens 2 デバイスまたは Hololens 2 エミュレーターにデプロイできます。After building an OpenXR UWP app package, you can deploy that package to either a HoloLens 2 device or the HoloLens 2 Emulator.

OpenXR API の学習Learning the OpenXR API

OpenXR API のツアーについては、この60分のビデオをご覧ください。このビデオでは、Visual Studio の BasicXrApp サンプルのコードについて説明しています。For a tour of the OpenXR API, check out this 60-minute video that walks through the code of the BasicXrApp sample in Visual Studio. このビデオでは、OpenXR API の各主要コンポーネントを独自のエンジンで使用する方法について説明し、OpenXR 上に構築されたいくつかのアプリケーションについて説明します。The video shows how each of the major components of the OpenXR API can be used in your own engine, and also demonstrates some of the applications built on OpenXR today:

OpenXR loader をプロジェクトに統合するIntegrate the OpenXR loader into a project

既存のプロジェクトで OpenXR の使用を開始するには、OpenXR ローダーを追加します。To get started with OpenXR in an existing project, you'll include the OpenXR loader. ローダーは、デバイス上のアクティブな OpenXR ランタイムを検出し、実装するコア関数および拡張関数へのアクセスを提供します。The loader discovers the active OpenXR runtime on the device and provides access to the core functions and extension functions that it implements.

公式の OpenXR NuGet パッケージを Visual Studio プロジェクトから参照するか、Khronos GitHub リポジトリから公式の OpenXR loader ソースを含めることができます。You can either reference the official OpenXR NuGet package from your Visual Studio project or include the official OpenXR loader source from the Khronos GitHub repo. どちらの方法を使用しても、OpenXR 1.0 のコア機能に加えて、公開された拡張機能にアクセスでき KHR EXT MSFT ます。Either approach will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

MSFT_preview拡張機能も試してみる場合は、Mixed Reality github リポジトリからpreview OpenXR ヘッダーをコピーすることができます。If you're interested to experiment with MSFT_preview extensions as well, you can copy in preview OpenXR headers from the Mixed Reality GitHub repo.

公式 OpenXR NuGet パッケージの参照Reference official OpenXR NuGet package

OpenXR NuGet パッケージは、事前に構築された OpenXR ローダーを参照する最も簡単な方法です。Visual Studio C++ ソリューションの DLL。The OpenXR.Loader NuGet package is the easiest way to reference a prebuilt OpenXR loader .DLL in your Visual Studio C++ solution. これにより、OpenXR 1.0 のコア機能に加えて、公開された拡張機能にアクセスできるようになり KHR EXT MSFT ます。This will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

OpenXR NuGet パッケージ参照を Visual Studio C++ ソリューションに追加するには、次のようにします。To add an OpenXR.Loader NuGet package reference to your Visual Studio C++ solution:

  1. ソリューションエクスプローラー で、OpenXR を使用するプロジェクトを右クリックし、[ NuGet パッケージの管理... ] を選択します。In Solution Explorer , right-click the project that will use OpenXR and select Manage NuGet Packages... .
  2. [ 参照 ] タブに切り替えて、 OpenXR を検索します。Switch to the Browse tab and search for OpenXR.Loader .
  3. OpenXR パッケージを選択し、右側の詳細ウィンドウで [インストール] をクリックします。Select the OpenXR.Loader package and click Install in the details pane to the right.
  4. [OK] をクリックして、プロジェクトへの変更を受け入れます。Click OK to accept the changes to your project.
  5. #include <openxr/openxr.h>OPENXR API の使用を開始するには、ソースファイルにを追加します。Add #include <openxr/openxr.h> to a source file to start using the OpenXR API.

動作中の OpenXR API の例については、 BasicXrApp サンプルアプリを参照してください。To see an example of the OpenXR API in action, check out the BasicXrApp sample app.

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

たとえば、追加のローダーを避けるために、ローダーを自分でビルドする場合。DLL を使用して、公式の Khronos OpenXR loader ソースをプロジェクトに取り込むことができます。If you want to build the loader yourself, for example to avoid the extra loader .DLL, you can pull the official Khronos OpenXR loader sources into your project. これにより、OpenXR 1.0 のコア機能に加えて、公開された拡張機能にアクセスできるようになり KHR EXT MSFT ます。This will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

ここで作業を開始するには、 GitHub の Khronos OpenXR リポジトリに記載されている手順に従ってください。To get started here, follow the instructions in the Khronos OpenXR-SDK repo on GitHub. プロジェクトは CMake でビルドするように設定されています-MSBuild を使用している場合は、コードを独自のプロジェクトにコピーする必要があります。The project is set up to build with CMake - if you are using MSBuild, you will need to copy the code into your own project.

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

MSFT_preview拡張機能のロードマップに記載されている拡張機能は、フィードバックを収集するためにプレビューされている試験的なベンダーの拡張機能です。The MSFT_preview extensions listed in the extension roadmap are experimental vendor extensions being previewed to gather feedback. これらの拡張機能は開発者向けデバイスのみを対象としており、実際の拡張機能が出荷されると削除されます。These extensions are for developer devices only and will be removed when the real extension ships.

使用可能な拡張機能を試すには MSFT_preview 、次の手順に従ってプロジェクトを更新します。If you're interested to try out the available MSFT_preview extensions, go through the following steps to update your project:

  1. 上記のいずれかの方法に従って、OpenXR loader をプロジェクトに統合します。Follow either of the approaches above to integrate an OpenXR loader into your project.
  2. プロジェクトの標準の OpenXR ヘッダーを、 GitHub の Mixed Reality OpenXR リポジトリのプレビューヘッダーに置き換えます。Replace the standard OpenXR headers in your project with the preview headers from the Mixed Reality OpenXR repo on GitHub.

次に、ターゲット HoloLens 2 またはデスクトップ PC でプレビュー拡張機能のサポートを有効にします。To then activate preview extension support on your target HoloLens 2 or desktop PC:

  1. すべての 拡張機能 を備えた最新の OpenXR ランタイムがあることを確認するには、対象のデバイスまたはエミュレーター内から ストア アプリを起動し、右上のメニューを開き、[ ダウンロードと更新 ] をクリックして、[ 更新プログラムの取得 ] をクリックします。To make sure you've got the latest OpenXR runtime with all extensions present, launch the Store app from within the target device or emulator, open the menu in the upper-right, click Downloads and updates and click Get updates .
  2. Windows Mixed Reality アプリの OpenXR 開発者ツールをMicrosoft Store からターゲットデバイスにインストールして実行します。Install the OpenXR Developer Tools for Windows Mixed Reality app from the Microsoft Store onto the target device and run it.
  3. [ Developer Settings ] タブに移動し、[ latest preview OpenXR runtime ] を有効にします。Navigate to the Developer Settings tab and enable Use latest preview OpenXR runtime . これにより、プレビューの拡張機能がアクティブ化されたデバイスでプレビューランタイムが有効になります。This enables the preview runtime on your device, which has preview extensions activated. Windows Mixed Reality アプリ開発者向け設定タブの OpenXR 開発者ツールOpenXR Developer Tools for Windows Mixed Reality app Developer Settings tab
  4. Windows Mixed Reality の OpenXR 開発者ツールの [ システムの状態 ] タブに表示される ランタイムバージョン が、使用する予定のプレビュー拡張機能の必要なバージョンと一致することを確認します。Confirm that the Runtime version shown on the System Status tab of the OpenXR Developer Tools for Windows Mixed Reality now matches the required version of the preview extensions you plan to try. その場合は、 拡張機能の一覧に 拡張機能が表示されます。If so, you should see the extension in the Extensions list. 安定した拡張機能を使用できるようになると、そのプレビュー拡張機能が削除されることに注意してください。Note that once a stable extension is available, its preview extension will be removed.
    Windows Mixed Reality アプリの [システム状態] タブの OpenXR 開発者ツールOpenXR Developer Tools for Windows Mixed Reality app System Status tab

これらのプレビュー拡張機能のドキュメント、およびそれらの使用方法のサンプルについては、「 Mixed Reality OpenXR リポジトリ 」を参照してください。See the Mixed Reality OpenXR repo for documentation of these preview extensions and samples of how to use them.

トラブルシューティングTroubleshooting

OpenXR の開発に関する問題が発生した場合は、 トラブルシューティングのヒントを確認してください。If you have trouble getting up and running with OpenXR development, check out our troubleshooting tips.