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

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

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

Из этого руководства вы узнаете, как выполнять следующие задачи:

• Развертывание в Azure веб-приложения ASP.NET Core, которое можно применять для совместного использования привязок и сохранения привязок в памяти в течение указанного периода времени.
• Настройка сцены AzureSpatialAnchorsLocalSharedDemo в примере Unity из наших кратких руководств для использования преимуществ веб-приложения для совместного использования пространственных привязок.
• Развертывание и запуск привязок на одном или нескольких устройствах.

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

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

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

• Знакомство со статьей Описание службы "Пространственные привязки Azure".
• Прохождение одного из 5-минутных руководств.

  Примечание.

  Краткие руководства по Android/NDK и iOS/Swift сейчас не содержат сведения о возможностях, описанных в этом руководстве.

• Базовое знание любого из следующих вариантов:
  • ARCore, если вы используете Android;
  • ARKit, если вы используете iOS.
• Компьютер Windows с Visual Studio 2019 или более поздней версии с рабочей нагрузкой ASP.NET и разработка веб-приложений.
• Пакет SDK для .NET Core 3.1.
• Одно или несколько следующих устройств, на которых необходимо развернуть и запустить приложение: HoloLens, HoloLens 2, iOS или Android.

Примечание.

В этом учебнике описано, как использовать Unity и веб-приложение ASP.NET Core, однако описанный здесь подход — это лишь пример того, как можно совместно использовать идентификаторы Пространственных привязок Azure на других устройствах. Вы можете использовать другие языки и серверные технологии в тех же целях.

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

Портал

Переход на портал 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, необходимые для платформы HoloLens.

Развертывание службы совместного использования привязок

Примечание.

В этом руководстве мы будем использовать бесплатный уровень службы приложение Azure. Уровень "Бесплатный" истекает через 20 минут бездействия и сбросит кэш памяти.

Visual Studio

Откройте Visual Studio, а затем откройте проект в папке Sharing\SharingServiceSample.

Запуск мастера публикации

В Обозреватель решений щелкните правой кнопкой мыши проект ShareService и выберите "Опубликовать...".

Запустится мастер публикации.

1. Выберите "Целевой объект Azure>Далее".
2. Выберите конкретную целевую службу приложение Azure (Windows)>Далее
3. Войдите на портал Azure.
4. Выберите зеленый "+" для создания службы приложение Azure

Параметры службы приложений

Параметр	Предлагаемое значение	Описание:
Имя.	myASASharingService	Присвойте службе уникальное имя
Название подписки		Выберите предпочитаемую подписку Azure
Группа ресурсов	myResourceGroup или выберите существующую.	Группа ресурсов — это логический контейнер, в котором происходит развертывание ресурсов Azure (например, веб-приложений, баз данных и учетных записей хранения) и управление ими. Например, в дальнейшем можно удалить всю группу ресурсов при помощи одного простого действия.
План размещения	Выберите "Создать" и см. таблицу ниже	План службы приложений указывает расположение, размер и функции фермы веб-серверов, в которой размещается приложение. Вы можете сэкономить деньги при размещении нескольких приложений, настроив веб-приложения для совместного использования одного плана Служба приложений plan.Служба приложений определить: регион (например, Северная Европа, восточная часть США или Юго-Восточная Азия); Размер экземпляра (небольшой, средний, крупный) Число экземпляров при масштабировании (от 1 до 20) SKU ("Бесплатный", "Общий", "Базовый", "Стандартный" или "Премиум").

Параметры плана размещения

Параметр	Предлагаемое значение	Description
План размещения	MySharingServicePlan	Присвойте плану размещения уникальное имя
Местонахождение	Западная часть США	Центр обработки данных, где размещается веб-приложение. Выберите расположение, ближайшее к физическому расположению приложения, будет использоваться
Размер	Бесплатно	Ценовая категория, которая определяет возможности размещения

5. Выберите "Создать", чтобы создать Служба приложений
6. После создания службы приложений выберите ее в списке "Экземпляры службы приложений" и нажмите кнопку "Готово"
7. На вкладке "Общий доступ" выберите "Опубликовать"

После публикации веб-приложения ASP.NET Core в Azure можно перейти https://<your_app_name>.azurewebsites.net или щелкнуть ссылку рядом с сайтом: на вкладке "ShareService: публикация". Скопируйте этот URL-адрес в текстовый редактор для последующего использования.

Visual Studio Code

Перед развертыванием службы в Visual Studio Code необходимо создать группу ресурсов и план службы приложений.

Вход в Azure

Перейдите на портал Azure, а затем войдите в подписку Azure.

Создание или изменение группы ресурсов

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

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

Присвойте группе ресурсов имя myResourceGroup и щелкните ОК.

Создание плана службы приложений

План службы приложений указывает расположение, размер и функции фермы веб-серверов, в которой размещается приложение. Вы можете сэкономить средства при размещении нескольких приложений, настроив совместное использование одного плана службы приложений в веб-приложениях.

Планы службы приложений определяют такие компоненты:

• регион (например, Северная Европа, восточная часть США или Юго-Восточная Азия);
• Размер экземпляра (небольшой, средний, крупный)
• Число экземпляров при масштабировании (от 1 до 20)
• SKU ("Бесплатный", "Общий", "Базовый", "Стандартный" или "Премиум").

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

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

Параметр	Предлагаемое значение	Description
План службы приложений	MySharingServicePlan	Имя плана службы приложений
Местонахождение	Западная часть США	Центр обработки данных, в котором размещается веб-приложение
Размер	Бесплатно	Ценовая категория, которая определяет возможности размещения

Нажмите ОК.

Откройте Visual Studio Code, а затем откройте проект в папке Sharing\SharingServiceSample.

Чтобы развернуть службу совместного использования с помощью Visual Studio Code, следуйте инструкциям в статье Публикация приложения ASP.NET Core в Azure с помощью Visual Studio Code. Начните с раздела "Открытие проекта с помощью Visual Studio Code". Не создавайте другой ASP.NET проект, как описано на предыдущем шаге, так как у вас уже есть проект для развертывания и публикации: ShareServiceSample.

Настройка и развертывание примера приложения

Unity — HoloLens

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

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

Настройка Параметры сборки

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

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

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

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

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

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

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

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

Откройте сцену с именем AzureSpatialAnchorsLocalSharedDemo , найдя ее Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo , дважды щелкнув ее на панели проекта

На панели "Проект" перейдите в раздел Assets\AzureSpatialAnchors.Examples\Resources.

Выберите SpatialAnchorSamplesConfig. Затем в области Inspector (Инспектор) введите URL-адрес Sharing Anchors Service (из развертывания веб-приложения ASP.NET в Azure) в качестве значения для Base Sharing Url. Добавьте URL-адрес с /swagger/api/anchorsпомощью . Результат будет выглядеть так: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Сохраните сцену, выбрав File>Save (Файл > Сохранить).

Экспорт и развертывание приложения HoloLens

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

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

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

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

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

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

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

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

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

Запуск приложения

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

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

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

Unity — Android

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

В 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 в качестве значения домена учетной записи Пространственных привязок.

Откройте сцену с именем AzureSpatialAnchorsLocalSharedDemo , найдя ее Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo , дважды щелкнув ее на панели проекта

На панели "Проект" перейдите в раздел Assets\AzureSpatialAnchors.Examples\Resources.

Выберите SpatialAnchorSamplesConfig. Затем в области Inspector (Инспектор) введите URL-адрес Sharing Anchors Service (из развертывания веб-приложения ASP.NET в Azure) в качестве значения для Base Sharing Url. Добавьте URL-адрес с /swagger/api/anchorsпомощью . Результат будет выглядеть так: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Сохраните сцену, выбрав File>Save (Файл > Сохранить).

Развернуть

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

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

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

Убедитесь, что флажок Export Project (Экспорт проекта) не установлен. Выберите Build And Run (Сборка и запуск). Появится запрос на сохранение файла APK. Вы можете выбрать для него любое имя.

Запуск приложения

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

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

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

Unity — iOS

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

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

Настройка Параметры сборки

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

В разделе Платформа выберите iOS.

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

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

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

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

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

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

Откройте сцену с именем AzureSpatialAnchorsLocalSharedDemo , найдя ее Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo , дважды щелкнув ее на панели проекта

На панели "Проект" перейдите в раздел Assets\AzureSpatialAnchors.Examples\Resources.

Выберите SpatialAnchorSamplesConfig. Затем в области Inspector (Инспектор) введите URL-адрес Sharing Anchors Service (из развертывания веб-приложения ASP.NET в Azure) в качестве значения для Base Sharing Url. Добавьте URL-адрес с /swagger/api/anchorsпомощью . Результат будет выглядеть так: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Сохраните сцену, выбрав File>Save (Файл > Сохранить).

Развертывание на устройстве с iOS

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

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

Выберите Build (Сборка). На открывшейся панели выберите папку, в которую будет экспортирован проект Xcode.

Когда экспорт успешно завершится, откроется папка, содержащая экспортированный проект Xcode.

Примечание.

Если появится окно с предложением выбрать замену или добавление, мы рекомендуем выбрать Append (Добавить), так как это быстрее. Замените все файлы из целевой папки и создадут новое содержимое.

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

Теперь вы можете открыть проект Unity-iPhone.xcodeproj в Xcode.

Для этого можно запустить Xcode и открыть экспортированный проект Unity-iPhone.xcodeproj или запустить проект с помощью следующей команды из того расположения, в которое этот проект был экспортирован:

open ./Unity-iPhone.xcodeproj

Выберите корневой узел Unity iPhone, чтобы просмотреть параметры проекта, а затем — вкладку General (Общие).

В разделе Deployment Info (Сведения о развертывании) убедитесь, что для цели развертывания установлено значение iOS 11.0.

Откройте вкладку Signing & Capabilities (Подпись и возможности) убедитесь, что установлен флажок Automatically manage signing (Автоматическое управление подписями). Если это не так, установите его и в открывшемся диалоговом окне выберите Enable Automatic (Включить автоматическое), чтобы сбросить параметры сборки.

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

Подключите устройство iOS к Mac и задайте активную схему для устройства iOS.

Выберите параметр Build and then run the current scheme (Сборка, а затем запуск текущей схемы).

Запуск приложения

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

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

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

В Xcode остановите приложение, нажав кнопку Stop (Остановить).

Android

Пример Java для Android поддерживает совместное использование на разных устройствах.

В Android Studio откройте файл SharedActivity.java в папке примеров.

Введите URL-адрес, скопированный на предыдущем шаге (из развертывания ASP.NET веб-приложения Azure), в качестве значения для SharingAnchorsServiceUrl в файле SharedActivity.java.

Измените index.html в URL-адресе на api/anchors. Результат будет выглядеть так: https://<app_name>.azurewebsites.net/api/anchors.

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

После запуска приложения на панели Choose A Demo (Выбор демонстрации) используйте стрелки влево или вправо, чтобы выбрать параметр LocalShare, а затем нажмите кнопку Go! (Запуск).

Следуйте указаниям в приложении. Вы можете выбрать Create & Share Anchor (Создать привязку и предоставить к ней общий доступ) или Locate Shared Anchor (Найти общую привязку).

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

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

iOS

Пример Objective-C для iOS поддерживает совместное использование на разных устройствах.

Откройте файл SharedDemoViewController.m в папке примеров.

Введите URL-адрес, полученный на предыдущем шаге (из развертывания ASP.NET веб-приложения Azure), в качестве значения для SharingAnchorsServiceUrl в файле SharedDemoViewController.m.

Измените index.html в URL-адресе на api/anchors. Результат будет выглядеть так: https://<app_name>.azurewebsites.net/api/anchors.

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

После запуска приложения выберите параметр Tap to start Shared Demo (Коснитесь, чтобы начать общую демонстрацию), а затем следуйте инструкциям из приложения. Вы можете выбрать Tap to locate Anchor by its anchor number (Коснитесь, чтобы найти привязку по ее номеру) или Tap to create Anchor and save it to the service (Коснитесь, чтобы создать привязку и сохранить ее в службе).

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

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

Xamarin

Примеры для Xamarin Android и iOS поддерживают совместное использование на разных устройствах.

Откройте файл AccountDetails.cs в папке примеров.

Введите URL-адрес, полученный на предыдущем шаге (из развертывания ASP.NET веб-приложения Azure), в качестве значения для AnchorSharingServiceUrl в файле AccountDetails.cs.

Измените index.html в URL-адресе на api/anchors. Результат будет выглядеть так: https://<app_name>.azurewebsites.net/api/anchors.

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

После запуска приложения на панели Choose A Demo (Выбор демонстрации) используйте стрелки влево или вправо, чтобы выбрать параметр LocalShare, а затем нажмите кнопку Go! (Запуск).

Следуйте указаниям в приложении. Вы можете выбрать Create & Share Anchor (Создать привязку и предоставить к ней общий доступ) или Locate Shared Anchor (Найти общую привязку).

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

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

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

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

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

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

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

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

Из этого учебника вы узнали, как развернуть веб-приложение ASP.NET Core в Azure, а затем настроить и развернуть приложение Unity. Вы знаете, как создать в приложении пространственные привязки и предоставить к ним доступ другим устройствам с помощью веб-приложения ASP.NET Core.

Вы можете улучшить веб-приложение ASP.NET Core, чтобы оно использовало Azure Cosmos DB для хранения хранилища общих идентификаторов пространственных привязок. Добавив поддержку Azure Cosmos DB, вы можете создать привязку в веб-приложении ASP.NET Core уже сегодня. Затем, благодаря идентификатору привязки, хранящемуся в веб-приложении, вы может вернуться к приложению через несколько дней и найти привязку снова.

Совместное использование привязок между сеансами и устройствами с помощью Пространственных привязок Azure и серверной части службы Azure Cosmos DB