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


Запустите пример приложения: Android — Android Studio (Java или C++/NDK)

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

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

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

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

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

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

  • Компьютер под управлением macOS или Windows с Android Studio 3.4 или более поздних версий.
    • Если вы используете ОС 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.
    • Чтобы создать пример NDK, вам также необходимо установить пакет NDK и SDK Tools CMake 3.6 (или более поздней версии) в Android Studio.
  • Устройство Android с включенным режимом разработчика и поддержкой ARCore.
    • Для взаимодействия компьютера с устройством Android могут потребоваться дополнительные драйверы устройств. Дополнительные сведения и инструкции см. здесь.
  • Целевой ОС для вашего приложения должна быть ARCore 1.11.0.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Открытие примера проекта

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

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

Откройте Android Studio.

Выберите Open an existing Android Studio project (Открыть существующий проект Android Studio), а затем выберите проект, расположенный в Android/Java/.

Настройка идентификатора и ключа учетной записи

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

Открыть Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.

Найдите поле SpatialAnchorsAccountKey и замените Set me ключом учетной записи.

Найдите поле SpatialAnchorsAccountId и замените Set me идентификатором учетной записи.

Найдите поле SpatialAnchorsAccountDomain и замените Set me доменом учетной записи.

Развертывание приложения на устройстве Android

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

Выберите Выполнить на панели инструментов Android Studio.

Развертывание и запуск Android Studio

В диалоговом окне Select Deployment Target (Выбор цели развертывания) выберите устройство с Android, а затем выберите , чтобы запустить приложение на этом устройстве.

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

Остановите программу, выбрав Остановить на панели инструментов Android Studio.

Остановка Android Studio

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

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

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

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

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

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

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