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

Статья
06/01/2023

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

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

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

Подключаемый модуль 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
Unity 2019

Поддержка 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 понадобиться вам позднее.

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

Для выполнения следующих действий должно быть установлено и доступно решение NPM.

Выполните следующую команду, заменив <version_number> версией Пространственных привязок Azure, которую необходимо скачать в текущую папку:

npm pack com.microsoft.azure.spatial-anchors-sdk.core@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

Примечание.

Чтобы получить список доступных версий пакета Пространственных привязок Azure, выполните следующую команду:

npm view com.microsoft.azure.spatial-anchors-sdk.core --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

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

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

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

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

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

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

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

Настройка файла mainTemplate.gradle

Выберите Изменить>Параметры проекта>Проигрыватель.
На панели Инспектор для параметра Настройки проигрывателя выберите значок Android.
В разделе Сборка установите флажок Настраиваемый основной шаблон Gradle, чтобы создать настраиваемый шаблон Gradle в расположении Assets\Plugins\Android\mainTemplate.gradle.
Откройте файл mainTemplate.gradle в текстовом редакторе.

Вставьте следующие зависимости в разделе dependencies:

implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')

Когда все будет готово, раздел dependencies должен выглядеть примерно так:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
    implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
**DEPS**}

Следующие шаги

Как создавать и размещать пространственные привязки в Unity

Поделиться через