Установка инструментовInstall the tools

Получите инструменты, необходимые для создания приложений для иммерсивных гарнитур (гарнитур виртуальной реальности) Microsoft HoloLens и Windows Mixed Reality.Get the tools you need to build applications for Microsoft HoloLens and Windows Mixed Reality immersive (VR) headsets. Для разработки решений для Windows Mixed Reality не существует отдельного пакета SDK. Вы будете использовать Visual Studio с пакетом SDK для Windows 10.There is no separate SDK for Windows Mixed Reality development; you'll use Visual Studio with the Windows 10 SDK.

У вас нет устройства смешанной реальности?Don't have a mixed reality device? Вы можете установить эмулятор HoloLens, чтобы протестировать отдельные функции приложений смешанной реальности без HoloLens.You can install the HoloLens emulator to test some functionality of mixed reality apps without a HoloLens. Вы также можете использовать симулятор Windows Mixed Reality, чтобы протестировать приложения смешанной реальности для иммерсивных гарнитур.You can also use the Windows Mixed Reality simulator to test your mixed reality apps for immersive headsets. Если вы работаете с Unity, вы можете использовать имитацию ввода, предлагаемую набором средств для смешанной реальности (МРТК), чтобы протестировать разные типы взаимодействий ввода, например с помощью отслеживания взгляда или движений рук.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.

Рекомендуем установить игровой модуль 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.

Совет

Добавьте эту страницу в закладки и регулярно просматривайте ее, чтобы быть в курсе самых последних версий каждого инструмента, рекомендованного для разработки приложений смешанной реальности.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
Логотип WindowsWindows logo

Windows 10 (ссылка для установки вручную)Windows 10 (Manual install link)

Установите самую последнюю версию 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 10Installing Windows 10
Вы можете установить последнюю версию Windows 10 с помощью клиентского компонента Центра обновления Windows, к которому можно перейти в разделе параметров, или путем создания установочного носителя (открыв ссылку, указанную в левом столбце).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, см. в заметках о текущем выпуске.See current release notes for information about the newest mixed reality features available with each release of Windows 10. Включите режим разработчика на компьютере в разделе "Параметры > Обновление и безопасность > Для разработчиков".Enable developer mode on your PC at Settings > Update & Security > For developers.

Примечание, касающееся корпоративных компьютеровNote for enterprise and corporate-managed PCs
Если вашим компьютером управляет ИТ-отдел вашей организации, возможно, вам потребуется связаться с его сотрудниками для обновления.If your PC is managed by an your organization's IT department, you might need to contact them in order to update.

N-версии Windows'N' versions of Windows
Иммерсивные гарнитуры (виртуальная реальность) Windows Mixed Reality не поддерживаются в N-версиях Windows.Windows Mixed Reality immersive (VR) headsets are not supported on 'N' versions of Windows.
Изображение с логотипом Visual StudioVisual Studio logo image

Visual Studio 2019 (версии 16.2 или более поздней) (ссылка для установки)Visual Studio 2019 (16.2 or higher) (Install link)

Полнофункциональная интегрированная среда разработки (IDE) для Windows и многое другое.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 2019Installing Visual Studio 2019
Установите следующие рабочие нагрузки:Be sure you install the following workloads:

● Разработка классических приложений на C++● Desktop development with C++
● Разработка приложений универсальной платформы Windows (UWP)● Universal Windows Platform (UWP) development

В рабочей нагрузке UWP обязательно проверьте следующий дополнительный компонент, если вы выполняете разработку для HoloLens:Within the UWP workload, be sure to check the following optional component if you'll be developing for HoloLens:

● Подключение USB-устройств● USB Device Connectivity

Примечание, касающееся UnityNote about Unity
Если вам не нужно устанавливать более новую (не LTS) версию Unity для своих задач, мы рекомендуем не устанавливать рабочую нагрузку Unity в составе установки Visual Studio, а вместо этого установить версию 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) существует ряд известных проблем с отладкой приложений смешанной реальности.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.
Логотип WindowsWindows logo

Пакет SDK для Windows 10 (10.0.18362.0) (ссылка для установки вручную)Windows 10 SDK (10.0.18362.0) (Manual install link)

Содержит новейшие заголовки, библиотеки, метаданные и средства для создания приложений для Windows 10 в HoloLens 2.Provides the latest headers, libraries, metadata, and tools for building Windows 10 apps on HoloLens 2.
Для создания приложений HoloLens 2 потребуется установить пакет Windows SDK сборки 18362 или более поздней.To build HoloLens 2 apps, you must install the Windows SDK, build 18362 or later.

Если вы разрабатываете приложения только для настольных гарнитур Windows Mixed Reality или HoloLens (1-го поколения), можно использовать пакет SDK для Windows, установленный в Visual Studio 2017.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 StudioVisual Studio logo

Эмулятор HoloLens 2 (Windows Holographic, версия 2004 с обновлением за октябрь 2020 г.) (ссылка для установки: 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.

Дополнительные сведения об использовании эмулятора 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. Если вы устанавливаете эмулятор HoloLens (1-го поколения) с Visual Studio 2019, вам необходимо отменить выбор шаблонов 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 и пакет SDK Windows 10 готовы к работе, выберите движок для разработки.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 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.