Настройка Пространственных привязок Azure в проекте Unity

  • Статья

Это руководство содержит сведения по началу работы с пакетом SDK для Пространственных привязок Azure в проекте Unity.

Проектные требования

При запуске нового проекта Unity можно выбрать между подключаемым модулем Unity XR и устаревшим встроенным XR.

Подключаемый модуль XR поддерживается только в пакете SDK ДЛЯ ASA версии 2.9.0 или более поздней версии. Чтобы использовать подключаемый модуль XR, используйте Unity 2020.3 (LTS) и AR Foundation 4.1.7 со следующими пакетами в зависимости от платформы:

  • подключаемый модуль OpenXR Смешанная реальность: 1.1.2
  • Подключаемый модуль Windows XR: 4.5.0
  • Подключаемый модуль ARCore XR: 4.1.7
  • Подключаемый модуль ARKit XR: 4.1.7

Настройка проекта

Прежде чем включить пакет SDK для Пространственных привязок Azure в проект Unity, обязательно установите необходимые пакеты с помощью диспетчера пакетов Unity.

Выбор версии ASA

Чтобы определить версию пакета SDK для ASA, которая будет использоваться в проекте Unity, выберите свою версию Unity ниже.

Поддержка Unity 2020 добавлена в пакете SDK для ASA 2.9.0. Для разработки в Unity 2020 мы рекомендуем использовать последний пакет SDK для ASA.

Важно!

Если используется подключаемый модуль OpenXR для смешанной реальности, минимальная поддерживаемая версия пакета SDK ASA — 2.10.0. При использовании Windows XR 4.5.1 или более поздней версии пакет SDK для ASA 2.11.0 является минимальной поддерживаемой версией.

Скачайте пакеты ASA

Следующий шаг — скачать пакеты пространственных привязок Azure для Unity.

Чтобы использовать пространственные привязки Azure в Unity, необходимо скачать основной пакет (com.microsoft.azure.spatial-anchors-sdk.core) и пакет для конкретной платформы для каждой платформы, которую вы планируете поддерживать.

Платформа Обязательные имена пакетов
HoloLens com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>
Android com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.android@<version_number>
iOS com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>

Примечание.

Инструмент Mixed Reality Feature Tool в данный момент поддерживается только в Windows.

Перейдите к следующему шагу. Инструмент Mixed Reality Feature Tool понадобиться вам позднее.

Импортируйте пакеты ASA

Для выполнения этого действия должно быть скачано и доступно решение Mixed Reality Feature Tool.

  1. Следуйте инструкциям в документации к Mixed Reality Feature Tool, чтобы настроить этот инструмент и узнать, как его использовать.
  2. Установите
    1. Ядро пакета SDK для пространственных привязок Azure
    2. Пакет SDK для пространственных привязок Azure для <платформ>
    3. Смешанная реальность подключаемый модуль OpenXR при использовании OpenXR — расположен в разделе "Поддержка платформы"

Дополнительные конфигурации

Если вы разрабатываетесь для HoloLens или Android, выполните дополнительные действия по настройке ниже.

Настройка параметров XR проекта Unity

При разработке приложений MixedReality на HoloLens необходимо задать конфигурацию XR в Unity. Дополнительные сведения см. в разделе "Настройка конфигурации XR " Смешанная реальность | Документация Майкрософт и выбор версии Unity и подключаемого модуля XR — Смешанная реальность | Документация Майкрософт.

Пакет SDK для пространственных привязок Azure версии 2.9.0 или более ранних версий обеспечивает поддержку подключаемого модуля Windows XR,com.unity.xr.windowsmr поэтому пакет Windows Spatial Anchors имеет явную зависимость от подключаемого модуля Windows XR.

Пакет SDK для пространственных привязок Azure версии 2.10.0 или более поздней версии обеспечивает поддержку подключаемого модуля OpenXR Смешанная реальность (com.microsoft.mixedreality.openxr) и подключаемого модуляcom.unity.xr.windowsmr Windows XR. Необходимо включить com.microsoft.mixedreality.openxr пакет или com.unity.xr.windowsmr пакет в проект в зависимости от выбранного варианта.

Настройка возможностей проекта Unity

Обязательно включите следующие возможности в проекте Unity:

  • SpatialPerception;
  • InternetClient
  • PrivateNetworkClientServer;

Предупреждение

Сбой включения возможности PrivateNetworkClientServer может привести к сбою при запросе привязок, когда устройство использует сеть, настроенную как частная.