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

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

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

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

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

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

В рамках этого краткого руководства вам потребуются:

• Устройство Android с включенным режимом разработчика и поддержкой ARCore.
  • Для взаимодействия компьютера с устройством Android могут потребоваться дополнительные драйверы устройств. Дополнительные сведения и инструкции см. здесь.
• Компьютер с Windows или macOS.
  • Если вы используете Windows, также потребуется Git для Windows и Git LFS.
  • Если вы используете macOS, установите Git с помощью Homebrew. Введите в одну строку терминала такую команду: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Затем выполните brew install git и brew install git-lfs.
• Установка Unity, включая Android Build Support с модулями Android SDK & NDK Tools и OpenJDK. Поддерживаемые версии и требуемые возможности см. на странице настройки проекта Unity.

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

Портал

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Azure CLI

Чтобы подготовить среду для Azure CLI, выполните указанные ниже действия.

• Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.

  

• Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.

  • Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.

  • Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.

  • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

1. После входа выполните команду az account set, чтобы выбрать подписку, в которой нужно задать учетную запись пространственных привязок:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Выполните команду az group create, чтобы создать группу ресурсов, или примените существующую группу ресурсов:

   az group create --name myResourceGroup --location eastus2
   

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

   Вы можете просмотреть текущие учетные записи пространственных привязок для группы ресурсов с помощью команды az spatial-anchors-account list:

   az spatial-anchors-account list --resource-group myResourceGroup
   

   Вы также можете просмотреть учетные записи пространственных привязок для своей подписки:

   az spatial-anchors-account list
   

3. Выполните команду az spatial-anchors-account create, чтобы создать учетную запись пространственных привязок:

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. Просмотрите свойства ресурса с помощью команды az spatial-anchors-account show:

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Скопируйте значение идентификатора учетной записи для ресурса и значение домена учетной записи для ресурса в текстовый редактор (они понадобятся позже).

5. Выполните команду az spatial-anchors-account key show, чтобы получить первичный и вторичный ключи:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Скопируйте значения ключей в текстовый редактор (они понадобятся позже).

   Если необходимо повторно создать ключи, выполните команду az spatial-anchors-account key renew:

   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
   

Вы можете удалить учетную запись с помощью команды az spatial-anchors-account delete:

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

Сначала подготовьте среду для Azure PowerShell:

• Если вы решили использовать Azure PowerShell локально:
  • Установите последнюю версию модуля Az PowerShell.
  • Подключитесь к учетной записи Azure с помощью командлета Connect-AzAccount.
• Если вы решили использовать Azure Cloud Shell:
  • Дополнительные сведения см. в статье Общие сведения об Azure Cloud Shell.

Важно!

Так как модуль Az.MixedReality в PowerShell предоставляется в предварительной версии, его нужно установить отдельно с помощью командлета Install-Module. Как только этот модуль PowerShell станет общедоступным, он будет включен в один из будущих выпусков модуля Az PowerShell и по умолчанию встроен в Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. После входа воспользуйтесь командлетом Set-AzContext, чтобы выбрать подписку, в которой нужно задать учетную запись пространственных привязок:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Выполните командлет New-AzResourceGroup, чтобы создать группу ресурсов, или воспользуйтесь существующей группой ресурсов:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

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

   Вы можете просмотреть текущие учетные записи пространственных привязок для группы ресурсов с помощью командлета Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Вы также можете просмотреть учетные записи пространственных привязок для своей подписки:

   Get-AzSpatialAnchorsAccount
   

3. Запустите командлет New-AzSpatialAnchorsAccount, чтобы создать собственную учетную запись пространственных привязок:

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. Просмотрите свойства ресурса с помощью командлета Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Скопируйте значение accountId свойства и значение accountDomain свойства в текстовый редактор (они понадобятся позже).

5. Выполните командлет Get-AzSpatialAnchorsAccountKey, чтобы получить первичный и вторичный ключи.

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Скопируйте значения ключей в текстовый редактор (они понадобятся позже).

   Если необходимо повторно создать ключи, используйте командлет New-AzSpatialAnchorsAccountKey:

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

Удалить учетную запись можно с помощью командлета Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

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

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

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

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

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

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

Настройка Unity

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

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

В разделе Platform (Платформа) выберите Android и нажмите Switch Platform (Сменить платформу), чтобы перейти на платформу Android. Если отсутствуют какие-то дополнительные компоненты Android, Unity может запросить их установку.

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

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

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

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

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

Экспорт проекта Android Studio

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

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

В окне Run Device (Запуск устройства) выберите свое устройство и щелкните Build And Run (Сборка и запуск). Вам будет предложено сохранить файл .apk, для которого можно выбрать любое имя.

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

Следуйте инструкциям в программе для размещения и отзыва привязки.

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

Проблемы отрисовки

Если во время запуска приложения вы не видите камеру как фон (к примеру, вы видите вместо этого пустой, синий фон или фон с другой текстурой), то вам нужно повторно импортировать файлы в Unity. Остановите приложение. В верхнем меню в Unity выберите "Ресурсы" —> reimport all. Затем снова запустите приложение.

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

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

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

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

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

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

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

Руководство. Совместное использование пространственных привязок на устройствах

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