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


Запустите пример приложения: HoloLens — Unity (C#)

В этом кратком руководстве вы запустите пример приложения Пространственных привязок Azure для HoloLens с помощью Unity (C#). Пространственные привязки — это кроссплатформенная служба для разработки, которая позволяет создавать среды смешанной реальности с объектами, расположение которых на устройствах не меняется с течением времени. Завершив работу, вы получите приложение HoloLens, разработанное с использованием Unity, которое может сохранять и удалять пространственные привязки.

Вы изучите следующие темы:

  • создать учетную запись в службе "Пространственные привязки";
  • настроить параметры сборки Unity;
  • настроить идентификатор и ключ учетной записи в службе "Пространственные привязки";
  • экспортировать проект HoloLens в Visual Studio;
  • развернуть приложение и запустить его на устройстве HoloLens.

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.

Необходимые компоненты

Для работы с этим кратким руководством сделайте следующее:

Создание ресурса Пространственных привязок

Переход на портал Azure.

В области слева выберите Создать ресурс.

Выполните поиск по запросу Пространственные привязки с помощью поля поиска.

Снимок экрана, показывающий результаты поиска по запросу

Выберите Пространственные привязки, а затем щелкните Создать.

В области Учетная запись Пространственных привязок выполните следующие действия.

  • Введите уникальное имя ресурса, используя обычные буквенно-цифровые символы.

  • Выберите подписку, к которой нужно присоединить ресурс.

  • Создайте группу ресурсов, нажав Создать. Назовите ее myResourceGroup и нажмите ОК.

    Группа ресурсов — это логический контейнер, в котором происходит развертывание ресурсов Azure (например, веб-приложений, баз данных и учетных записей хранения) и управление ими. Например, в дальнейшем можно удалить всю группу ресурсов при помощи одного простого действия.

  • Выберите расположение (регион), в котором будет размещен ресурс.

  • Выберите Создать, чтобы начать создание ресурса.

Снимок экрана: область Пространственных привязок для создания ресурса.

После создания ресурса на портале Azure отобразится оповещение о завершении развертывания.

Снимок экрана, показывающий, что развертывание ресурса завершено.

Выберите Перейти к ресурсу. Теперь можно просмотреть свойства ресурса.

Скопируйте значение идентификатора учетной записи ресурса в текстовый редактор для дальнейшего использования.

Снимок экрана: область свойств ресурса

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

Снимок экрана, показывающий значение домена учетной записи ресурса.

В разделе Параметры выберите элемент Ключ доступа. Скопируйте значение первичного ключа (ключа учетной записи) в текстовый редактор для дальнейшего использования.

Снимок экрана: область

Скачивание примера проекта и импорт пакета SDK

Репозиторий клонирования примеров

Клонируйте репозиторий примеров, выполнив следующие команды:

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

Импорт пакета SDK ASA

Следуйте приведенным здесь инструкциям, чтобы скачать и импортировать пакеты SDK для ASA, необходимые для платформы HoloLens.

Настройка Unity

В Unity откройте проект в папке Unity. Unity может уведомить вас о разнице между версией в проекте и версией, установленной на компьютере. Это предупреждение допустимо, если версия Unity Editor новее, чем та, с помощью которой создан проект. В таком случае выберите Continue (Продолжить). Если ваша версия старше, чем требуется проекту, щелкните Quit (Выйти) и обновите Unity Editor.

Снимок экрана: область Unity

Откройте Build Settings (Параметры сборки), выбрав пункты File>Build Settings (Файл > Параметры сборки).

В разделе Platform (Платформа) выберите Universal Windows Platform (Универсальная платформа Windows). Измените целевое устройство на HoloLens.

Выберите Switch Platform (Изменить платформу), чтобы изменить значение на Universal Windows Platform (Универсальная платформа Windows). Если отсутствуют какие-то дополнительные компоненты UWP, Unity может запросить их установку.

Снимок экрана: панель параметров сборки Unity — HoloLens

Закройте окно Build Settings (Параметры сборки).

Настройка сведений об учетной записи

Следующим шагом является настройка приложения для использования данных вашей учетной записи. Вы скопировали значения ключа учетной записи, идентификатора учетной записии домена учетной записи в текстовый редактор, как указано ранее в разделе Создание ресурса Пространственных привязок.

В области Проект перейдите к Assets\AzureSpatialAnchors.SDK\Resources.

Выберите SpatialAnchorConfig. В области Инспектор введите Account Key в качестве значения ключа учетной записи Пространственных привязок, Account ID в качестве значения идентификатора учетной записи Пространственных привязок и Account Domain в качестве значения домена учетной записи Пространственных привязок.

Экспорт проекта HoloLens в Visual Studio

Откройте Build Settings (Параметры сборки), выбрав пункты File>Build Settings (Файл > Параметры сборки).

В разделе Scenes In Build (Сцены в сборке) убедитесь, что возле всех сцен установлен флажок.

Выберите Build (Сборка). В диалоговом окне выберите папку для экспорта проекта HoloLens в Visual Studio.

После завершения экспорта появится папка, содержащая экспортированный проект HoloLens.

Развертывание приложения HoloLens

Чтобы открыть проект в Visual Studio, дважды щелкните HelloAR U3D.sln в папке.

Укажите для параметра Solution Configuration (Конфигурация решения) значение Release (Выпуск), а для параметра Solution Platform (Платформа решения) значение x86 и выберите Device (Устройство) в списке целевых вариантов развертывания.

При использовании HoloLens 2 платформой решения будет ARM64, а не x86.

Настройка Visual Studio

Включите устройство HoloLens, войдите и подключите его к компьютеру с помощью USB-кабеля.

Выберите Debug>Start debugging (Отладка > Начать отладку), чтобы развернуть приложение и запустить отладку.

В приложении выберите BasicDemo со стрелками, а затем нажмите кнопку Go! для запуска демонстрации. Следуйте инструкциям для размещения и отзыва привязки.

Снимок экрана 1Снимок экрана 2Снимок экрана: 3Снимок экрана: 4

В Visual Studio остановите приложение, выбрав Остановить отладку или нажав клавиши SHIFT+F5.

Очистка ресурсов

На предыдущем шаге вы создали ресурсы Azure в группе ресурсов. Если вы считаете, что в будущем эти ресурсы вам не понадобятся, их можно удалить, удалив группу ресурсов.

В меню или на странице Главная портала Azure выберите Группы ресурсов. Затем на странице Группы ресурсов выберите myResourceGroup.

На странице myResourceGroup убедитесь, что перечислены те ресурсы, которые нужно удалить.

Выберите Удалить группу ресурсов, введите myResourceGroup в текстовое поле для подтверждения и щелкните Удалить.

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

В этом кратком руководстве вы создали учетную запись Пространственных привязок. Затем вы настроили и развернули приложение для сохранения и повторного вызова пространственных привязок. Дополнительные сведения о том, как улучшить приложение таким образом, чтобы оно совместно использовало пространственные привязки с другими устройствами, см. в следующем руководстве.