Windows sdk для unity

uerceg released this Feb 10, 2021

Added

• Added support for Apple Search Ads attribution with usage of AdServices.framework .
• Added setAllowAdServicesInfoReading method to AdjustConfig to allow option for users to prevent SDK from performing any tasks related to Apple Search Ads attribution with usage of AdServices.framework .
• Added wrapper method updateConversionValue method to Adjust to allow updating SKAdNetwork conversion value via SDK API.
• Added getAppTrackingAuthorizationStatus getter to Adjust instance to be able to get current iOS app tracking status.
• Added improved measurement consent management and third party sharing mechanism.
• Added public constants to be used as sources for ad revenue tracking with trackAdRevenue method.

Fixed

• Fixed hardcoded scene name under the hood of requestTrackingAuthorizationWithCompletionHandler method which caused that game object was always expected to be named «Adjust».

Native versions:

uerceg released this Dec 24, 2020

Fixed

• Fixed handling of native null values for cost amount.

Native versions:

uerceg released this Dec 11, 2020

Added

• Added possibility to get cost data information in attribution callback.
• Added setNeedsCost method to AdjustConfig to indicate if cost data is needed in attribution callback (by default cost data will not be part of attribution callback if not enabled with this setter method).
• Added setPreinstallTrackingEnabled method to AdjustConfig to allow enabling of preintall tracking (this feature is OFF by default).
• Added support for MSA SDK v1.0.23 in OAID plugin.

Note: Version 4.24.1 contains updated logic for proper handling of cost data, so please update to v4.24.1 or higher.

Native versions:

uerceg released this Oct 2, 2020

Added

• Added note to Assets/Adjust menu toggling actions that project needs to be saved in order for actions to take effect.

Changed

• Switched to usage of relative paths when working with AdjustSettings.asset file.

Native versions:

uerceg released this Sep 28, 2020

Fixed

• Fixed duplicate ADJUrlStrategy symbol error.

Changed

• Switched to usage of AssetDatabase instead of EditorPrefs to store relevant information from AdjustEditor .

Native versions:

uerceg released this Aug 20, 2020

Added

• Added communication with SKAdNetwork framework by default on iOS 14.
• Added method deactivateSKAdNetworkHandling method to AdjustConfig to switch off default communication with SKAdNetwork framework in iOS 14.
• Added wrapper method requestTrackingAuthorizationWithCompletionHandler to Adjust to allow asking for user’s consent to be tracked in iOS 14 and immediate propagation of user’s choice to backend.
• Added handling of new iAd framework error codes introduced in iOS 14.
• Added sending of value of user’s consent to be tracked with each package.
• Added setUrlStrategy method to AdjustConfig class to allow selection of URL strategy for specific market.
• Added new entries to Assets/Adjust menu ( Assets/Adjust/Is iOS 14 Support Enabled and Assets/Adjust/Toggle iOS 14 Support ) to enable / disable iOS 14 support when building iOS project. If enabled, resulting Xcode project will get StoreKit.framework and AppTrackingTransparency.framework linked to it.

⚠️ Note: iOS 14 beta versions prior to 5 appear to have an issue when trying to use iAd framework API like described in here. For testing of v4.23.0 version of SDK in iOS, please make sure you’re using iOS 14 beta 5 or later.

Установка инструментов 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 или Unreal. Это самый простой способ приступить к созданию приложений смешанной реальности. We recommend installing either the Unity or Unreal 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.

Если вы работаете с Unity, вы можете использовать имитацию ввода, предлагаемую Набором средств для Смешанной реальности для Unity, чтобы протестировать разные типы взаимодействий ввода, например с помощью отслеживания взгляда или движений рук. If you’re using Unity, you can use Mixed Reality Toolkit for Unity’s input simulation to test various types of input interactions such as hand-tracking and eye-tracking input. Для проектов Unreal используйте подключаемый модуль UX Tools, чтобы проверить общие взаимодействия ввода и возможности взаимодействия с пользователем. For Unreal projects, use the UX Tools plugin to test common input interactions and user experience features.

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

Полнофункциональная интегрированная среда разработки (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 2019 Installing 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

Примечание, касающееся Unity Note 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.8. Please ensure that you update to Visual Studio 2019 version 16.8 or higher.

Содержит новейшие заголовки, библиотеки, метаданные и средства для создания приложений для 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.

Эмулятор позволяет запускать приложения с помощью образа виртуальной машины 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 и установить их из Visual Studio Marketplace. If you’re installing the HoloLens (1st gen) emulator with Visual Studio 2019 you need to deselect the VS templates and install them from the Visual Studio Marketplace.

Выберите подсистему 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.

1. Скачайте последнюю версию. 1. Download the latest version

В качестве лучшей версии для запуска новых проектов мы рекомендуем Unity LTS (долгосрочная поддержка). Затем ее можно обновить до последней версии, чтобы получить новые стабильные исправления. 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.

• Сейчас рекомендуем использовать сборку Unity 2019.4 LTS , необходимую для MRTK версии 2 (см. ниже). The current recommendation is to use Unity 2019.4 LTS, which is the LTS build required for MRTK v2 below.
• Если вам по определенным причинам требуется использовать другую версию Unity, с этим не возникнет затруднений, так как Unity поддерживает параллельную установку различных версий. If you need to use a different version of Unity for specific reasons, Unity supports side-by-side installs of different versions.

2. Установка Mixed Reality Feature Tool 2. Install the Mixed Reality Feature Tool

Средство Mixed Reality Feature Tool предоставляет новый способ для обнаружения и добавления пакетов функций смешанной реальности в проекты Unity. The Mixed Reality Feature Tool is a new way for developers to discover and add Mixed Reality feature packages into Unity projects.

Вы можете искать пакеты по имени или категории, просматривать их зависимости и даже проверять предлагаемые изменения в файле манифеста проектов перед импортом. You can search packages by name or category, see their dependencies, and even view proposed changes to your projects manifest file before importing. Когда вы подтвердите список нужных пакетов, средство Mixed Reality Feature Tool скачает их в выбранный вами проект. Once you’ve validated the packages you want, the Mixed Reality Feature tool will download them into the project of your choice.

Импорт набора средств для смешанной реальности (MRTK) Importing the Mixed Reality Toolkit

Набор средств для смешанной реальности (MRTK) — это кросс-платформенный пакет разработки с открытым кодом для приложений смешанной реальности. Mixed Reality Toolkit (MRTK) is an open-source, cross-platform development kit for mixed reality applications.

• Установите пакет Mixed Reality Toolkit, следуя инструкциям по установке и использованию, и выберите пакет Mixed Reality Toolkit Foundation. Install the Mixed Reality Toolkit package by following the installation and usage instructions and selecting the Mixed Reality Toolkit Foundation package.

Мы рекомендуем изучить раздел по началу работы, следуя нашим курируемым этапам разработки дляHoloLens или виртуальной реальности. We recommend completing the getting started section in our curated HoloLens or VR development journeys. Если вы уже работаете с этими этапами, выполните остальные шаги по настройке (см. ниже) и перейдите к руководствам по началу работы с HoloLens 2. If you’re already following the Unity development for HoloLens journey, finish up the rest of the setup steps listed below and continue on to the HoloLens 2 Getting Started tutorials.

Обратите внимание, что инструкции по установке приведены для последнего стабильного сочетания выпусков MRTK и Unity — MRTK 2.5.1 и Unity 2019.4 LTS. Note that installation instructions are targeted for the latest stable combination of MRTK and Unity releases, which are MRTK 2.5.1 and Unity 2019.4 LTS.

Если вы не хотите использовать MRTK для Unity, вам придется самостоятельно написать скрипты для всех взаимодействий и моделей поведения. If you don’t want to use MRTK for Unity, you’ll need to script all interactions and behaviors yourself.

Другие средства [необязательно] Other tools [optional]

• Вспомогательный набор средств для смешанной реальности (GitHub) — фрагменты кода и компоненты, которые не могут работать непосредственно в HoloLens или иммерсивных гарнитурах (гарнитурах виртуальной реальности), но могут объединяться с ними для взаимодействия в Windows Mixed Reality. Mixed Reality Companion Kit (GitHub) — code bits and components that might not run directly on HoloLens or immersive (VR) headsets, but instead pair with them to build experiences targeting Windows Mixed Reality.
• Набор средств для смешанной реальности — общий (GitHub). Это коллекция общих скриптов и компонентов. Mixed Reality Toolkit — Common (GitHub) — a collection of shared scripts and components.

3. Настройте компьютер для разработки приложений смешанной реальности. 3. Set up your PC for Mixed Reality development

Этот пакет SDK для Windows 10 лучше всего использовать в операционной системе Windows 10. The Windows 10 SDK works best on the Windows 10 operating system. Он также поддерживается в следующих операционных системах: Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2. 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.

Вы можете разрабатывать и развертывать приложения для HoloLens, иммерсивных гарнитур виртуальной реальности или для устройств обоих типов. 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.

Для разработки решений для HoloLens For HoloLens development

При настройке компьютера для разработки решений для HoloLens убедитесь, что он соответствует системным требованиям для Unity и Visual Studio. When setting up your development PC for HoloLens development, please make sure it meets the system requirements for both Unity and Visual Studio. Если вы хотите запустить приложение на устройстве HoloLens, вам потребуется выполнить инструкции по настройке портала устройств Windows. If you want to run your app on a HoloLens device, you need to follow the Windows Device Portal setup instructions. Если вы планируете использовать эмулятор HoloLens, убедитесь, что ваш компьютер соответствует его системным требованиям. If you plan on using the HoloLens emulator, you’ll want to make sure your PC meets the HoloLens emulator system requirements as well.

Сведения о начале работы с эмулятором HoloLens см. в этой статье. To get started with the HoloLens emulator, see Using the HoloLens emulator.

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

Устранение неполадок с HoloLens HoloLens troubleshooting

Неактивная кнопка для включения режима разработчика Setting Developer Mode is grayed out

Если вы сталкиваетесь с проблемами при включении режима разработчика на устройстве, возможно, у вас нет прав владельца устройства. If you’re running into issues enabling Developer Mode on your device you might not be the device owner. В многопользовательском режиме то лицо, которое использует устройство первым, назначается владельцем. Все последующие пользователи не будут иметь нужных разрешений для включения режима разработчика или внесения других изменений в конфигурацию. In multi-user mode, the person who uses the device first is the device owner — any subsequent users won’t have the required permissions to enable Developer Mode or other configuration changes. Однако существует исключение, при котором первый пользователь может не быть владельцем устройства в среде с Autopilot. Подробные сведения см. в документации по безопасности HoloLens. However, there is an exception where the first user may not be the device owner in an Autopilot environment, which is detailed in the HoloLens security documentation.

Ниже представлены возможные решения. Possible solutions include:

• Владелец устройства должен включить режим разработчика перед передачей устройства другим пользователям или разработчикам. Having the device owner turn Developer Mode on before passing the device to other users or developers
• Рекомендация ИТ-администратору или администратору MDM включить параметр политики CSP ApplicationManagement/AllowDeveloperUnlock для конкретного устройства или группы устройств, с которыми работают разработчики. Suggesting that your IT/MDM Admin enables CSP Policy ApplicationManagement/AllowDeveloperUnlock for the specific device or a developer device group.
  • Эту политику можно задать с помощью пакетов подготовки или через MDM для устройств HoloLens This policy can be set by Provisioning Packages or via MDM for HoloLens devices
• Использование решения Advanced Recovery Companion (ARC). Using the Advanced Recovery Companion (ARC)

Дополнительные сведения об управлении устройствами HoloLens см. в этом обзоре . You can learn more about device management in the HoloLens device management overview.

Не удается выполнить развертывание по USB I can’t deploy over USB

Если вы не можете развернуть приложение непосредственно по USB, убедитесь, что вы выполнили все приведенные выше требования к установке, и следуйте инструкциям из нашего пошагового руководства. If you’re not able to deploy an application directly over USB, make sure you’ve met all the installation requirements listed above and follow our step-by-step tutorial.

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

Если на компьютере для разработки решений для иммерсивных гарнитур отсутствуют полноразмерные порты HDMI и (или) USB 3.0, для подключения гарнитуры вам потребуются адаптеры. 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	Ноутбук: двухъядерный ЦП Intel Core i5 для мобильных систем 7-го поколения с технологией Hyper-Threading. Настольный компьютер: двухъядерный ЦП Intel i5 для настольных систем 6-го поколения с технологией Hyper-Threading или эквивалентный четырехъядерный процессор AMD FX4350 с частотой 4,2 ГГц. 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	Настольный компьютер: Intel i7 для настольных систем 6-го поколения (6 ядер) или AMD Ryzen 5 1600 (6 ядер, 12 потоков). Desktop: Intel Desktop i7 6th generation (6 Core) OR AMD Ryzen 5 1600 (6 Core, 12 threads)
Графический процессор GPU	Ноутбук: графический процессор, эквивалентный NVIDIA GTX 965M, AMD RX 460M (2 ГБ) или более мощным процессорам с поддержкой DX12; настольный компьютер: графический процессор, эквивалентный NVIDIA GTX 960/1050, AMD Radeon RX 460 (2 ГБ) или более мощным процессорам с поддержкой DX12 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 GPU	Настольный компьютер: графический процессор, эквивалентный NVIDIA GTX 980/1060, AMD Radeon RX 480 (2 ГБ) или более мощным процессорам с поддержкой DX12 Desktop: NVIDIA GTX 980/1060, AMD Radeon RX 480 (2GB) equivalent or greater DX12 capable GPU
Версия WDDM драйвера графического процессора GPU driver WDDM version	Драйвер WDDM 2.2 WDDM 2.2 driver
Тепловая мощность Thermal Design Power	15 Вт или выше 15W or greater
Порты для графического отображения Graphics display ports	1 доступный порт графического отображения для гарнитуры (HDMI 1.4 или DisplayPort 1.2 для гарнитур с частотой 60 Гц, HDMI 2.0 или DisplayPort 1.2 для гарнитур с частотой 90 Гц) 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	Разрешение: SVGA (800 x 600) или большая глубина цвета: 32 бита цвета на пиксель Resolution: SVGA (800×600) or greater Bit depth: 32 bits of color per pixel
Память Memory	8 ГБ ОЗУ или более 8 GB of RAM or greater	16 ГБ ОЗУ или более 16 GB of RAM or greater
Хранение Storage	>10 ГБ дополнительного пространства >10 GB additional free space
USB-порты USB Ports	1 доступный USB-порт для гарнитуры (USB 3.0 Type-A)Примечание. Сила тока USB должна составлять минимум 900 мА. 1x available USB port for headset (USB 3.0 Type-A) Note: USB must supply a minimum of 900mA
Bluetooth Bluetooth	Bluetooth 4.0 (для подключения периферийных устройств) Bluetooth 4.0 (for accessory connectivity)

Если у вас нет опыта разработки с использованием MRTK в Unity, мы рекомендуем вам изучить наш обзор разработки для Unity: If you’re new to MRTK development with Unity, we recommend following our curated Unity development journey:

Следующий этап разработки Next Development Checkpoint

Если вы следуете изложенным нами этапам разработки в Unity для HoloLens, вашей следующей задачей будет изучение руководств по HoloLens 2. If you’re following the Unity for HoloLens development checkpoint journey we’ve laid out, your next task is to work through our HoloLens 2 tutorial series.

Если вы следуете этапам разработки в Unity для виртуальной реальности, настройте свой проект. If you’re following the Unity for VR journey, your next task is to setup your project.

Вы можете в любой момент вернуться к этапам разработки в Unity для HoloLens и виртуальной реальности. You can always go back to the Unity development checkpoints for HoloLens and VR at any time.

1. Скачайте последнюю версию. 1. Download the latest version

Мы рекомендуем установить Unreal Engine 4.25 или более поздней версии, чтобы воспользоваться всеми преимуществами встроенной поддержки HoloLens. We recommend installing Unreal Engine version 4.25 or later to take full advantage of built-in HoloLens support.

2. Импортируйте набор средств для смешанной реальности (MRTK). 2. Import Mixed Reality Toolkit (MRTK)

Набор средств для смешанной реальности (MRTK) — это кроссплатформенный пакет SDK с открытым кодом для приложений смешанной реальности. Mixed Reality Toolkit (MRTK) is an open-source, cross-platform development kit for mixed reality applications. MRTK предоставляет кросс-платформенную систему ввода, базовые компоненты и общие строительные блоки для пространственных взаимодействий. MRTK provides a cross-platform input system, foundational components, and common building blocks for spatial interactions. Набор используется для ускорения разработки приложений, предназначенных для Microsoft HoloLens, иммерсивных гарнитур (гарнитур виртуальной реальности) Windows Mixed Reality и платформы OpenVR. The toolkit is intended to accelerate the development of applications targeting Microsoft HoloLens, Windows Mixed Reality immersive (VR) headsets, and the OpenVR platform.

Для выполнения установки мы рекомендуем изучить раздел по началу работы нашего обзора разработки для Unreal. For installation, we recommend completing the Getting Started section of our curated Unreal development journey. Если вы уже работаете с этим обзором, выполните остальные шаги по настройке (см. ниже) и перейдите к руководствам по началу работы с HoloLens 2. If you’re already following the Unreal development journey, finish up the rest of the setup steps listed below and continue on to the HoloLens 2 Getting Started tutorials.

Если вы не хотите использовать MRTK для Unreal, вам придется самостоятельно написать скрипты для всех взаимодействий и моделей поведения. If you don’t want to use MRTK for Unreal, you’ll need to script all interactions and behaviors yourself.

Другие средства [необязательно] Other tools [optional]

• Вспомогательный набор средств для смешанной реальности (GitHub) — фрагменты кода и компоненты, которые не могут работать непосредственно в HoloLens или иммерсивных гарнитурах (гарнитурах виртуальной реальности), но могут объединяться с ними для взаимодействия в Windows Mixed Reality. Mixed Reality Companion Kit (GitHub) — code bits and components that might not run directly on HoloLens or immersive (VR) headsets, but instead pair with them to build experiences targeting Windows Mixed Reality.
• Набор средств для смешанной реальности (общий (GitHub)) — это коллекция общих скриптов и компонентов. Mixed Reality Toolkit — Co mmon (GitHub) — a collection of shared scripts and components.

3. Настройте компьютер для разработки приложений смешанной реальности. 3. Set up your PC for mixed reality development

Этот пакет SDK для Windows 10 лучше всего использовать в операционной системе Windows 10. The Windows 10 SDK works best on the Windows 10 operating system. Он также поддерживается в следующих операционных системах: Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2. 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.

Вы можете разрабатывать и развертывать приложения для HoloLens, иммерсивных гарнитур виртуальной реальности или для устройств обоих типов. 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.

Для разработки решений для HoloLens For HoloLens development

При настройке компьютера для разработки решений для HoloLens убедитесь, что он соответствует системным требованиям для Unreal и Visual Studio. When setting up your development PC for HoloLens development, please make sure you meet the system requirements for Unreal and and Visual Studio. Если вы хотите запустить приложение на устройстве HoloLens, вам потребуется выполнить инструкции по настройке портала устройств Windows. If you want to run your app on a HoloLens device, you need to follow the Windows Device Portal setup instructions. Если вы планируете использовать эмулятор HoloLens, убедитесь, что ваш компьютер соответствует его системным требованиям. If you plan on using the HoloLens emulator, you’ll want to make sure your PC meets the HoloLens emulator system requirements as well.

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

Устранение неполадок с HoloLens HoloLens troubleshooting

Неактивная кнопка для включения режима разработчика Setting Developer Mode is grayed out

Если вы сталкиваетесь с проблемами при включении режима разработчика на устройстве, возможно, у вас нет прав владельца устройства. If you’re running into issues enabling Developer Mode on your device you might not be the device owner. В многопользовательском режиме то лицо, которое использует устройство первым, назначается владельцем. Все последующие пользователи не будут иметь нужных разрешений для включения режима разработчика или внесения других изменений в конфигурацию. In multi-user mode, the person who uses the device first is the device owner — any subsequent users won’t have the required permissions to enable Developer Mode or other configuration changes. Однако существует исключение, при котором первый пользователь может не быть владельцем устройства в среде с Autopilot. Подробные сведения см. в документации по безопасности HoloLens. However, there is an exception where the first user may not be the device owner in an Autopilot environment, which is detailed in the HoloLens security documentation.

Ниже представлены возможные решения. Possible solutions include:

• Владелец устройства должен включить режим разработчика перед передачей устройства другим пользователям или разработчикам. Having the device owner turn Developer Mode on before passing the device to other users or developers
• Рекомендация ИТ-администратору или администратору MDM включить параметр политики CSP ApplicationManagement/AllowDeveloperUnlock для конкретного устройства или группы устройств, с которыми работают разработчики. Suggesting that your IT/MDM Admin enables CSP Policy ApplicationManagement/AllowDeveloperUnlock for the specific device or a developer device group.
  • Эту политику можно задать с помощью пакетов подготовки или через MDM для устройств HoloLens This policy can be set by Provisioning Packages or via MDM for HoloLens devices
• Использование решения Advanced Recovery Companion (ARC). Using the Advanced Recovery Companion (ARC)

Дополнительные сведения об управлении устройствами HoloLens см. в этом обзоре . You can learn more about device management in the HoloLens device management overview.

Не удается выполнить развертывание по USB I can’t deploy over USB

Если вы не можете развернуть приложение непосредственно по USB, убедитесь, что вы выполнили все приведенные выше требования к установке, и следуйте инструкциям из нашего пошагового руководства. If you’re not able to deploy an application directly over USB, make sure you’ve met all the installation requirements listed above and follow our step-by-step tutorial.

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

Если на компьютере для разработки решений для иммерсивных гарнитур отсутствуют полноразмерные порты HDMI и (или) USB 3.0, для подключения гарнитуры вам потребуются адаптеры. 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	Ноутбук: двухъядерный ЦП Intel Core i5 для мобильных систем 7-го поколения с технологией Hyper-Threading. Настольный компьютер: двухъядерный ЦП Intel i5 для настольных систем 6-го поколения с технологией Hyper-Threading или эквивалентный четырехъядерный процессор AMD FX4350 с частотой 4,2 ГГц. 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	Настольный компьютер: Intel i7 для настольных систем 6-го поколения (6 ядер) или AMD Ryzen 5 1600 (6 ядер, 12 потоков). Desktop: Intel Desktop i7 6th generation (6 Core) OR AMD Ryzen 5 1600 (6 Core, 12 threads)
Графический процессор GPU	Ноутбук: графический процессор, эквивалентный NVIDIA GTX 965M, AMD RX 460M (2 ГБ) или более мощным процессорам с поддержкой DX12; настольный компьютер: графический процессор, эквивалентный NVIDIA GTX 960/1050, AMD Radeon RX 460 (2 ГБ) или более мощным процессорам с поддержкой DX12 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 GPU	Настольный компьютер: графический процессор, эквивалентный NVIDIA GTX 980/1060, AMD Radeon RX 480 (2 ГБ) или более мощным процессорам с поддержкой DX12 Desktop: NVIDIA GTX 980/1060, AMD Radeon RX 480 (2GB) equivalent or greater DX12 capable GPU
Версия WDDM драйвера графического процессора GPU driver WDDM version	Драйвер WDDM 2.2 WDDM 2.2 driver
Тепловая мощность Thermal Design Power	15 Вт или выше 15W or greater
Порты для графического отображения Graphics display ports	1 доступный порт графического отображения для гарнитуры (HDMI 1.4 или DisplayPort 1.2 для гарнитур с частотой 60 Гц, HDMI 2.0 или DisplayPort 1.2 для гарнитур с частотой 90 Гц) 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	Разрешение: SVGA (800 x 600) или большая глубина цвета: 32 бита цвета на пиксель Resolution: SVGA (800×600) or greater Bit depth: 32 bits of color per pixel
Память Memory	8 ГБ ОЗУ или более 8 GB of RAM or greater	16 ГБ ОЗУ или более 16 GB of RAM or greater
Хранение Storage	>10 ГБ дополнительного пространства >10 GB additional free space
USB-порты USB Ports	1 доступный USB-порт для гарнитуры (USB 3.0 Type-A)Примечание. Сила тока USB должна составлять минимум 900 мА. 1x available USB port for headset (USB 3.0 Type-A) Note: USB must supply a minimum of 900mA
Bluetooth Bluetooth	Bluetooth 4.0 (для подключения периферийных устройств) Bluetooth 4.0 (for accessory connectivity)

Если у вас нет опыта разработки с использованием MRTK в Unreal, мы рекомендуем вам изучить наш обзор разработки для Unreal: If you’re new to MRTK development with Unreal, we recommend following our curated Unreal development journey:

Следующий этап разработки Next Development Checkpoint

Если вы следуете изложенным нами этапам разработки для Unreal, вашей следующей задачей будет изучение руководств по HoloLens 2. If you’re following the Unreal development checkpoint journey we’ve laid out, your next task is to work through our HoloLens 2 tutorial series.

Вы можете в любой момент вернуться к этапам разработки для Unreal. You can always go back to the Unreal development checkpoints at any time.

Для нативной разработки с использованием OpenXR вам не нужно скачивать движок. Native OpenXR development doesn’t have an engine for you to download. Все необходимое для начала разработки с помощью OpenXR можно найти в этом документе. You can find everything you need to begin development in the Getting started with OpenXR document.

1. Настройте компьютер для разработки приложений смешанной реальности. 1. Set up your PC for mixed reality development

Этот пакет SDK для Windows 10 лучше всего использовать в операционной системе Windows 10. The Windows 10 SDK works best on the Windows 10 operating system. Он также поддерживается в следующих операционных системах: Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2. 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.

Для разработки решений для HoloLens For HoloLens development

При настройке компьютера для разработки решений для HoloLens убедитесь, что он соответствует системным требованиям для Visual Studio. When setting up your development PC for HoloLens development, please make sure you meet the system requirements for Visual Studio. Если вы хотите запустить приложение на устройстве HoloLens, вам потребуется выполнить инструкции по настройке портала устройств Windows. If you want to run your app on a HoloLens device, you need to follow the Windows Device Portal setup instructions. Если вы планируете использовать эмулятор HoloLens, убедитесь, что ваш компьютер соответствует его системным требованиям. If you plan on using the HoloLens emulator, you’ll want to make sure your PC meets the HoloLens emulator system requirements as well.

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

Вы можете разрабатывать и развертывать приложения для HoloLens, иммерсивных гарнитур виртуальной реальности или для устройств обоих типов. 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.

Устранение неполадок с HoloLens HoloLens troubleshooting

Неактивная кнопка для включения режима разработчика Setting Developer Mode is grayed out

Если вы сталкиваетесь с проблемами при включении режима разработчика на устройстве, возможно, у вас нет прав владельца устройства. If you’re running into issues enabling Developer Mode on your device you might not be the device owner. В многопользовательском режиме то лицо, которое использует устройство первым, назначается владельцем. Все последующие пользователи не будут иметь нужных разрешений для включения режима разработчика или внесения других изменений в конфигурацию. In multi-user mode, the person who uses the device first is the device owner — any subsequent users won’t have the required permissions to enable Developer Mode or other configuration changes. Однако существует исключение, при котором первый пользователь может не быть владельцем устройства в среде с Autopilot. Подробные сведения см. в документации по безопасности HoloLens. However, there is an exception where the first user may not be the device owner in an Autopilot environment, which is detailed in the HoloLens security documentation.

Ниже представлены возможные решения. Possible solutions include:

• Владелец устройства должен включить режим разработчика перед передачей устройства другим пользователям или разработчикам. Having the device owner turn Developer Mode on before passing the device to other users or developers
• Рекомендация ИТ-администратору или администратору MDM включить параметр политики CSP ApplicationManagement/AllowDeveloperUnlock для конкретного устройства или группы устройств, с которыми работают разработчики. Suggesting that your IT/MDM Admin enables CSP Policy ApplicationManagement/AllowDeveloperUnlock for the specific device or a developer device group.
  • Эту политику можно задать с помощью пакетов подготовки или через MDM для устройств HoloLens This policy can be set by Provisioning Packages or via MDM for HoloLens devices
• Использование решения Advanced Recovery Companion (ARC). Using the Advanced Recovery Companion (ARC)

Дополнительные сведения об управлении устройствами HoloLens см. в этом обзоре . You can learn more about device management in the HoloLens device management overview.

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

Если на компьютере для разработки решений для иммерсивных гарнитур отсутствуют полноразмерные порты HDMI и (или) USB 3.0, для подключения гарнитуры вам потребуются адаптеры. 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	Ноутбук: двухъядерный ЦП Intel Core i5 для мобильных систем 7-го поколения с технологией Hyper-Threading. Настольный компьютер: двухъядерный ЦП Intel i5 для настольных систем 6-го поколения с технологией Hyper-Threading или эквивалентный четырехъядерный процессор AMD FX4350 с частотой 4,2 ГГц. 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	Настольный компьютер: Intel i7 для настольных систем 6-го поколения (6 ядер) или AMD Ryzen 5 1600 (6 ядер, 12 потоков). Desktop: Intel Desktop i7 6th generation (6 Core) OR AMD Ryzen 5 1600 (6 Core, 12 threads)
Графический процессор GPU	Ноутбук: графический процессор, эквивалентный NVIDIA GTX 965M, AMD RX 460M (2 ГБ) или более мощным процессорам с поддержкой DX12; настольный компьютер: графический процессор, эквивалентный NVIDIA GTX 960/1050, AMD Radeon RX 460 (2 ГБ) или более мощным процессорам с поддержкой DX12 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 GPU	Настольный компьютер: графический процессор, эквивалентный NVIDIA GTX 980/1060, AMD Radeon RX 480 (2 ГБ) или более мощным процессорам с поддержкой DX12 Desktop: NVIDIA GTX 980/1060, AMD Radeon RX 480 (2GB) equivalent or greater DX12 capable GPU
Версия WDDM драйвера графического процессора GPU driver WDDM version	Драйвер WDDM 2.2 WDDM 2.2 driver
Тепловая мощность Thermal Design Power	15 Вт или выше 15W or greater
Порты для графического отображения Graphics display ports	1 доступный порт графического отображения для гарнитуры (HDMI 1.4 или DisplayPort 1.2 для гарнитур с частотой 60 Гц, HDMI 2.0 или DisplayPort 1.2 для гарнитур с частотой 90 Гц) 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	Разрешение: SVGA (800 x 600) или большая глубина цвета: 32 бита цвета на пиксель Resolution: SVGA (800×600) or greater Bit depth: 32 bits of color per pixel
Память Memory	8 ГБ ОЗУ или более 8 GB of RAM or greater	16 ГБ ОЗУ или более 16 GB of RAM or greater
Хранение Storage	>10 ГБ дополнительного пространства >10 GB additional free space
USB-порты USB Ports	1 доступный USB-порт для гарнитуры (USB 3.0 Type-A)Примечание. Сила тока USB должна составлять минимум 900 мА. 1x available USB port for headset (USB 3.0 Type-A) Note: USB must supply a minimum of 900mA
Bluetooth Bluetooth	Bluetooth 4.0 (для подключения периферийных устройств) Bluetooth 4.0 (for accessory connectivity)

Если у вас нет опыта разработки с использованием MRTK на нативных платформах, мы рекомендуем вам изучить наш обзор разработки для нативных платформ: If you’re new to Native development with MRTK, we recommend following our curated Native development journey:

Следующий этап разработки Next Development Checkpoint

Если вы следуете изложенным нами этапам разработки для нативных платформ, вашей следующей задачей будет настройка среды разработки для HoloLens 2. If you’re following the Native development checkpoint journey we’ve laid out, your next task is to configure your development environment for HoloLens 2.

Вы можете в любой момент вернуться к этапам разработки для нативных платформ. You can always go back to the Native development checkpoints at any time.