ツールのインストールInstall the tools

Microsoft HoloLens および Windows Mixed Reality イマーシブ (VR) ヘッドセット用のアプリケーションを構築するために必要なツールを取得します。Get the tools you need to build applications for Microsoft HoloLens and Windows Mixed Reality immersive (VR) headsets. Windows Mixed Reality 開発用の別個の SDK はありません。Windows 10 SDK と一緒に Visual Studio をご使用ください。There is no separate SDK for Windows Mixed Reality development; you'll use Visual Studio with the Windows 10 SDK.

Mixed Reality デバイスをお持ちでない場合はどのようにしたらよいでしょうか。Don't have a mixed reality device? HoloLens なしで Mixed Reality アプリの機能をテストするために、HoloLens エミュレーターをインストールすることができます。You can install the HoloLens emulator to test some functionality of mixed reality apps without a HoloLens. Windows Mixed Reality シミュレーターを使用して、イマーシブ ヘッドセット用の Mixed Reality アプリをテストすることもできます。You can also use the Windows Mixed Reality simulator to test your mixed reality apps for immersive headsets. Unity を使用している場合は、Mixed Reality Toolkit (MRTK) の入力シミュレーションを使用して、ハンドトラッキングや視線追跡入力などのさまざまな種類の入力操作をテストできます。If you're using Unity, you can use Mixed Reality Toolkit (MRTK)'s input simulation to test various types of input interactions such as hand-tracking and eye-tracking input.

Mixed Reality アプリの作成を開始する最も簡単な方法として、Unity ゲーム エンジンをインストールすることをお勧めします。We recommend installing the Unity game engine as the easiest way to get started creating mixed reality apps. ただし、カスタム エンジンを使用する場合は、DirectX に対してビルドすることもできます。However, you can also build against DirectX if you'd like to use a custom engine.

ヒント

このページをブックマークに登録して定期的にチェックし、Mixed Reality 開発に推奨される各ツールの最新バージョンを常に最新の状態に保ってください。Bookmark this page and check it regularly to keep up-to-date on the most recent version of each tool recommended for mixed reality development.


インストールのチェックリストInstallation checklist

ツールTool メモNotes
Windows ロゴWindows logo

Windows 10 (手動インストールのリンク)Windows 10 (Manual install link)

お使いの PC のオペレーティング システムが、Mixed Reality アプリケーションの構築対象プラットフォームと一致するように、Windows 10 の最新バージョンをインストールしてください。Install the most recent version of Windows 10 so your PC's operating system matches the platform for which you're building mixed reality applications.
Windows 10 のインストールInstalling Windows 10
[設定] の [Windows Update] を利用するか、インストール メディアを作成して (左の列のリンクを使用して)、Windows 10 の最新バージョンをインストールできます。You can install the most recent version of Windows 10 via Windows Update in Settings or by creating installation media, using the link in the left column.

Windows 10 の各リリースで使用可能な最新の Mixed Reality 機能については、最新のリリース ノートを参照してください。See current release notes for information about the newest mixed reality features available with each release of Windows 10. [設定] > [更新とセキュリティ] > [開発者向け] から、PC で開発者モードを有効にしますEnable developer mode on your PC at Settings > Update & Security > For developers.

エンタープライズ管理および会社管理の PC の場合の注意事項Note for enterprise and corporate-managed PCs
お使いの PC が組織の IT 部門によって管理されている場合、更新するために管理者への連絡が必要な場合があります。If your PC is managed by an your organization's IT department, you might need to contact them in order to update.

Windows の 'N' バージョン'N' versions of Windows
Windows Mixed Reality イマーシブ (VR) ヘッドセットは、Windows の 'N' バージョンではサポートされていません。Windows Mixed Reality immersive (VR) headsets are not supported on 'N' versions of Windows.
Visual Studio のロゴ画像Visual Studio logo image

Visual Studio 2019 (16.2 以降) (インストールのリンク)Visual Studio 2019 (16.2 or higher) (Install link)

完全な機能を備えた Windows などの統合開発環境 (IDE) です。Fully-featured integrated development environment (IDE) for Windows and more. コードの記述、デバッグ、テスト、配置には、Visual Studio を使用します。You'll use Visual Studio to write code, debug, test, and deploy.
Visual Studio 2019 のインストールInstalling Visual Studio 2019
次のワークロードをインストールします。Be sure you install the following workloads:

● C++ によるデスクトップ開発● Desktop development with C++
● ユニバーサル Windows プラットフォーム (UWP) の開発● Universal Windows Platform (UWP) development

HoloLens 向けの開発を行う場合は、UWP ワークロード内に次のオプションのコンポーネントがあることを確認してください。Within the UWP workload, be sure to check the following optional component if you'll be developing for HoloLens:

● USB デバイスの接続● USB Device Connectivity

Unity に関する注意事項Note about Unity
特定の目的のために意図的により新しいバージョンの (LTS 以外の) Unity をインストールしようとしているのでなければ、Visual Studio のインストールの一部として Unity ワークロードをインストールする "のではなく"、下記のように Unity 2019 LTS ストリームをインストールすることをお勧めします。Unless you're intentionally trying to install a newer (non-LTS) version of Unity for a specific purpose, we recommend not installing the Unity workload as part of Visual Studio installation, and instead install the Unity 2019 LTS stream as noted below.

既知の問題Known issues
Visual Studio 2019 バージョン 16.0 での Mixed Reality アプリのデバッグに関して既知の問題がいくつかあります。There are some known issues with debugging mixed reality apps in Visual Studio 2019 version 16.0. 必ず、Visual Studio 2019 バージョン 16.2 以降に更新してください。Please ensure that you update to Visual Studio 2019 version 16.2 or higher.
Windows ロゴWindows logo

Windows 10 SDK (10.0.18362.0) (手動インストールのリンク)Windows 10 SDK (10.0.18362.0) (Manual install link)

HoloLens 2 で Windows 10 アプリを作成するための最新のヘッダー、ライブラリ、メタデータ、ツールが用意されています。Provides the latest headers, libraries, metadata, and tools for building Windows 10 apps on HoloLens 2.
HoloLens 2 アプリを構築するには、ビルド 18362 以降の Windows SDK をインストールする必要があります。To build HoloLens 2 apps, you must install the Windows SDK, build 18362 or later.

デスクトップの Windows Mixed Reality ヘッドセットまたは HoloLens (第 1 世代) 用のアプリケーションのみを開発している場合は、Visual Studio 2017 によってインストールされた Windows SDK を使用することができます。If you are only developing applications for desktop Windows Mixed Reality headsets or HoloLens (1st gen), you can use the Windows SDK installed by Visual Studio 2017.
Visual Studio のロゴVisual Studio logo

HoloLens 2 エミュレーター (Windows Holographic バージョン 2004、2020 年 10 月の更新プログラム) (Install link:10.0.19041.1124)HoloLens 2 Emulator (Windows Holographic, version 2004 October 2020 Update) (Install link: 10.0.19041.1124)

HoloLens (第 1 世代) エミュレーター (インストールのリンク:10.0.17763.134)HoloLens (1st gen) Emulator (Install link: 10.0.17763.134)

エミュレーターを使用すると、物理的な HoloLens を使用せずに、HoloLens 仮想マシン イメージ上でアプリケーションを実行できます。The emulator lets you run applications on a HoloLens virtual machine image without a physical HoloLens.

エミュレーターの使用を開始する方法については、「Using the HoloLens emulator (HoloLens エミュレーターを使用する)」を参照してください。See Using the HoloLens emulator for more information on getting started with the emulator.

エミュレーターのインストールを成功させるには、ご使用のシステムが Hyper-V をサポートしている必要がありますYour system must support Hyper-V for the emulator installation to succeed. 詳細については、以下の「システム要件」セクションを参照してください。Reference the System Requirements section below for details.

HoloLens (第 1 世代) エミュレーターに関する注意Note on HoloLens (1st gen) Emulator
インストールを正常に完了するには、Visual Studio 2017 が必要です。Visual Studio 2017 is required to successfully complete the installation. Visual Studio 2019 を使用して HoloLens (第1世代) エミュレーターをインストールする場合は、VS テンプレートの選択を解除し、後ほど手動で追加する必要があります。If you're installing the HoloLens (1st gen) emulator with Visual Studio 2019 you need to deselect the VS templates and manually add them later on.

エンジンの選択Choose your engine

これで、Windows 10、Visual Studio、Windows 10 SDK の準備ができました。次に、構築の基盤となるエンジンを選択します。Now that you have your Windows 10, Visual Studio, and Windows 10 SDK ready to go, let's choose an engine to build on.

Unity logo banner

1. Download the latest version

We recommend the Unity LTS (Long Term Support) stream as the best version to use when starting new projects, updating to its latest revision to pick up the latest stable fixes.

  • The current recommendation is to use Unity 2019, which is the LTS build required for MRTK v2 below.
  • If you need to use a different version of Unity for specific reasons, Unity supports side-by-side installs of different versions.

2. Import Mixed Reality Toolkit (MRTK)

MRTK

Mixed Reality Toolkit (MRTK) is an open-source, cross-platform development kit for mixed reality applications. MRTK provides a cross-platform input system, foundational components, and common building blocks for spatial interactions. The toolkit is intended to accelerate the development of applications targeting Microsoft HoloLens, Windows Mixed Reality immersive (VR) headsets, and the OpenVR platform.

For installation, we recommend completing the Getting Started section of our curated Unity development journey. If you're already following the Unity development journey, finish up the rest of the setup steps listed below and continue on to the HoloLens 2 Getting Started tutorials.

重要

Note that installation instructions are targeted for the latest stable combination of MRTK and Unity releases, which are MRTK 2.4.0 and Unity 2019.3.15.

注意

If you don't want to use MRTK for Unity, you'll need to script all interactions and behaviors yourself.

Other tools [optional]

3. Set up your PC for Mixed Reality development

The Windows 10 SDK works best on the Windows 10 operating system. This SDK is also supported on Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2. Note that not all tools are supported on older operating systems.

注意

You can develop and deploy your apps for HoloLens, VR immersive headsets, or both. Make sure you fulfill the requirements below depending on your needs.

For HoloLens development

When setting up your development PC for HoloLens development, please make sure it meets the system requirements for both Unity and Visual Studio. If you plan on using the HoloLens emulator, you'll want to make sure your PC meets the HoloLens emulator system requirements as well.

To get started with the HoloLens emulator, see Using the HoloLens emulator.

If you plan to develop for both HoloLens and Windows Mixed Reality immersive (VR) headsets, use the system recommendations and requirements in the section below.

Immersive (VR) headset requirements

注意

The following guidelines are the current minimum and recommended specs for your immersive (VR) headset development PC, and are updated regularly.

警告

Do not confuse this with the minimum PC hardware compatibility guidelines, which outlines the consumer PC specs to which you should target your immersive (VR) headset app or game.

If you're using a Reverb G2 headset, download the Microsoft-Valve OpenXR plugin (TODO: // Need link).

If your immersive headset development PC does not have full-sized HDMI and/or USB 3.0 ports, you'll need adapters to connect your headset.

There are currently known issues with some hardware configurations, particularly notebooks that have hybrid graphics.

Minimum Recommended
Processor Notebook: Intel Mobile Core i5 7th generation CPU, Dual-Core with Hyper Threading Desktop: Intel Desktop i5 6th generation CPU, Dual-Core with Hyper Threading OR AMD FX4350 4.2Ghz Quad-Core equivalent Desktop: Intel Desktop i7 6th generation (6 Core) OR AMD Ryzen 5 1600 (6 Core, 12 threads)
GPU Notebook: NVIDIA GTX 965M, AMD RX 460M (2GB) equivalent or greater DX12 capable GPU Desktop: NVIDIA GTX 960/1050, AMD Radeon RX 460 (2GB) equivalent or greater DX12 capable GPUDesktop: NVIDIA GTX 980/1060, AMD Radeon RX 480 (2GB) equivalent or greater DX12 capable GPU
GPU driver WDDM version WDDM 2.2 driver
Thermal Design Power 15W or greater
Graphics display ports 1x available graphics display port for headset (HDMI 1.4 or DisplayPort 1.2 for 60Hz headsets, HDMI 2.0 or DisplayPort 1.2 for 90Hz headsets)
Display resolution Resolution: SVGA (800x600) or greater Bit depth: 32 bits of color per pixel
Memory 8 GB of RAM or greater 16 GB of RAM or greater
Storage >10 GB additional free space
USB Ports 1x available USB port for headset (USB 3.0 Type-A) Note: USB must supply a minimum of 900mA
Bluetooth Bluetooth 4.0 (for accessory connectivity)

If you're new to MRTK development with Unity, we recommend following our curated Unity development journey:

Next Development Checkpoint

If you're following the Unity development checkpoint journey we've laid out, your next task is to work through our HoloLens 2 tutorial series.

You can always go back to the Unity development checkpoints at any time.