OpenXR の概要Getting started with OpenXR

デスクトップ上の HoloLens 2 または Windows Mixed Reality の OpenXR を使用して開発することができます。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. Windows Mixed reality をセットアップすると、Mixed Reality ポータルによって、Windows Mixed Reality OpenXR ランタイムが自動的にインストールされます。As you set up Windows Mixed Reality, Mixed Reality Portal will automatically install the Windows Mixed Reality OpenXR Runtime. その後、Microsoft Store によってランタイムが最新の状態に保たれます。The Microsoft Store will then keep the runtime up to date.
  3. [スタート] メニューから Mixed Reality ポータルを起動し、[...] をクリックして、Windows Mixed Reality OpenXR ランタイムをアクティブにします。メニューをクリックし、[Set up OpenXR] を選択します。Make the Windows Mixed Reality OpenXR Runtime active by launching Mixed Reality Portal from the Start menu, clicking the ... menu in the lower-left and selecting "Set up OpenXR".
    Mixed Reality ポータルでの OpenXR の設定Setting up OpenXR in the Mixed Reality Portal

Windows Mixed Reality OpenXR Runtime を再びアクティブにする必要がある場合は、手順 3. を繰り返します。If you ever need to make the Windows Mixed Reality OpenXR Runtime active again, repeat step 3.

注意

Windows mixed Reality OpenXR ランタイムはまもなく、すべての Windows Mixed Reality エンドユーザーに自動的にアクティブ化されます。The Windows Mixed Reality OpenXR Runtime will soon be made active automatically for all Windows Mixed Reality end users.

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

Windows Mixed Reality OpenXR Runtime を試すには、 Mixed Reality OpenXR 開発者ツールアプリをインストールします。To try out the Windows Mixed Reality OpenXR Runtime, you can install the Mixed Reality OpenXR Developer Tools 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.

エミュレーターを使用する場合、Mixed Reality OpenXR 開発者ツールをインストールする最も簡単な方法は、 Windows デバイスポータルを使用することです。これを行うには、"OpenXR" ページに移動し、[開発者機能] の下にある [インストール] ボタンをクリックします。If using the emulator, the easiest way to install the Mixed Reality OpenXR Developer Tools 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)

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 のプロジェクトファイルは、パッケージ化と配置の違いによって分離されていますが、各プロジェクト内のアプリコード100は同じであることに注意してください。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 100% 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 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 to 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 デバイスポータルを有効にする:Enable Windows Device Portal on the target device:
    • ターゲットデバイスが HoloLens 2 デバイスの場合は、ターゲットデバイスで次の手順を実行します。If your target device is a HoloLens 2 device, follow these instructions on the target device. HoloLens 2 エミュレーターの既知の問題により、次の手順の UI がエミュレーターに表示されなくなるため、これには物理ヘッドセットが必要であることに注意してください。Note that this requires a physical headset, as a known issue in the HoloLens 2 emulator will prevent the UI in the next step from appearing in the emulator.
    • ターゲットデバイスが、イマーシブヘッドセット周辺機器が接続されているデスクトップ PC の場合は、ターゲットのデスクトップ PC で次の手順に従います。If your target device is a desktop PC with an immersive headset peripheral attached, follow these instructions on the target desktop PC.
  3. 左ペインの [ OpenXR ] タブに移動し、[ latest preview OpenXR runtime の使用] を有効にします。Navigate to the OpenXR tab in the left pane and enable Use latest preview OpenXR runtime. これにより、プレビューの拡張機能がアクティブ化されたデバイスでプレビューランタイムが有効になります。This enables the preview runtime on your device, which has preview extensions activated.
  4. Windows Mixed Reality 開発者ツール OpenXRの [システムステータス] タブに表示されているランタイムバージョンが、試してみる予定のプレビュー拡張機能の必要なバージョンと一致することを確認します。Confirm that the Runtime version shown on the System Status tab of the Windows Mixed Reality OpenXR Developer Tools 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.
    Mixed Reality OpenXR 開発者ツール app System Status タブMixed Reality OpenXR Developer Tools 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.