5. Пространственные привязки Azure для Android и iOS5. Azure Spatial Anchors for Android and iOS

В этом руководстве показано, как выполнить сборку проекта на устройствах Android и iOS с помощью пакетов AR Foundation, ARCore XR Plugin и ARKit XR Plugin.In this tutorial, you will learn how to build your project to Android and iOS devices using AR Foundation, ARCore XR Plugin, and ARKit XR Plugin.

ЗадачиObjectives

  • Узнайте, как выполнить сборку проекта на своем устройстве Android с помощью пакетов Unity AR Foundation и ARCore XR Plugin.Learn how to build your project to your Android device using Unity's AR Foundation and ARCore XR Plugin
  • Узнайте, как выполнить сборку проекта на своем устройстве iOS с помощью пакетов Unity AR Foundation и ARKit XR Plugin.Learn how to build your project to your iOS device using Unity's AR Foundation and ARKit XR Plugin

Установка встроенных пакетов UnityInstalling inbuilt Unity packages

В этом разделе будут обновлены и установлены следующие встроенные пакеты:In this section, you will upgrade and install the following inbuilt packages:

  • AR Foundation 3.1.3;AR Foundation 3.1.3
  • XR Legacy Input Helpers 2.1.4XR Legacy Input Helpers 2.1.4
  • пакет поддержки ARCore XR Plugin 3.1.3 для Android;ARCore XR Plugin 3.1.3 for Android support
  • пакет поддержки ARKit XR plugin 3.1.3 для iOS.ARKit XR plugin 3.1.3 for iOS support

Внимание!

Не все версии совместимы с MRTK. С набором будет работать только определенная версия, поэтому убедитесь, что установлены в точности те версии, которые перечислены выше.Not all version are compatible with MRTK and only certain version works together, so make sure you install the exact versions listed above.

В меню Unity выберите Window (Окно) > Package Manager (Диспетчер пакетов) , чтобы открыть окно диспетчера пакетов. Затем выберите AR Foundation > 3.1.3 и нажмите кнопку Update to 3.1.3 (Обновить до 3.1.3), чтобы обновить пакет.In the Unity menu, select Window > Package Manager to open the Package Manager window, then select AR Foundation > 3.1.3 and click the Update to 3.1.3 button to update the package:

Диспетчер пакетов Unity с выбранным пакетом AR Foundation

С помощью той же процедуры вы можете по мере необходимости импортировать остальные пакеты.Follow the same process to import the remaining packages as needed.

Примечание

Если вы разрабатываете проект для Android, устанавливать пакет ARKit XR Plugin не нужно.If you are developing this project for Android, there is no need to install the ARKit XR Plugin package. Если вы разрабатываете проект для iOS, устанавливать пакет ARCore XR Plugin также не нужно.Similarly, if you are developing this project for iOS, you do not need to install the ARCore XR Plugin.

Настройка MRTK для камеры AR FoundationConfigure MRTK for AR Foundation Camera

Из этого раздела вы узнаете, как настроить MRTK для развертывания на мобильном устройстве.In this section, you will learn how to configure MRTK for deploying to a mobile device.

В окне Hierarchy (Иерархия) выберите объект MixedRealityToolkit.In the Hierarchy window, select the MixedRealityToolkit object. Затем в окне Inspector (Инспектор) перейдите на вкладку Camera (Камера), клонируйте профиль камеры и присвойте ему понятное имя, например AzureSpatialAnchors_ARCameraProfile:Then in the Inspector window, select the Camera tab, clone the camera profile, and give it a suitable name, for example, AzureSpatialAnchors_ARCameraProfile:

Unity с выбранным созданным профилем ARCameraProfile

Совет

Сведения о том, как правильно клонировать профили MRTK, см. в статье Настройка профилей MRTK.For a reminder on how to clone MRTK profiles, you can refer to the Configuring the Mixed Reality Toolkit profiles instructions.

Оставив выбранной вкладку Camera (Камера) в окне Inspector (Инспектор), разверните раздел Camera Setting Providers (Поставщики параметров камеры) и нажмите кнопку + Add Camera Setting Provider (+ Добавить поставщик параметров), а затем разверните появившийся раздел New data provider 1 (Новый поставщик данных 1).With the Camera tab still selected in the Inspector window, expand the Camera Setting Providers and click the + Add Camera Setting Provider button, then expand the newly added New data provider 1:

Профиль ARCameraProfile в Unity с добавленным поставщиком данных

В раскрывающемся списке Type (Тип) измените тип на Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:Using the Type dropdown, change the type to Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:

Выбор типа поставщика данных для профиля ARCameraProfile в Unity

Оставив выбранным объект MixedRealityToolkit в окне Hierarchy (Иерархия), нажмите кнопку Add Component (Добавить компонент) в окне Inspector (Инспектор), чтобы добавить следующие компоненты:With the MixedRealityToolkit object still selected in the Hierarchy window, use the Add Component button in the Inspector window to add the following components:

  • диспетчер привязок AR (скрипт);AR Anchor Manager (Script)
  • DisableDiagnosticsSystem (скрипт).DisableDiagnosticsSystem (Script)

Объект MixedRealityToolkit в Unity с добавленными компонентами AR Anchor Manager и DisableDiagnosticsSystemUnity MixedRealityToolkit object with AR Anchor Manager and DisableDiagnosticsSystem components added

Примечание

При добавлении компонента диспетчера опорных точек AR (скрипт) автоматически добавляется компонент источника сеанса AR (скрипт), так как он необходим компоненту диспетчера опорных точек AR (скрипт).When you add the AR Reference Point Manager (Script) component, the AR Session Origin (Script) component is automatically added because it is required by the AR Reference Point Manager (Script) component.

Создание приложения для устройства AndroidBuilding your application to your Android device

Из этого раздела вы узнаете, как настроить проект для сборки и развертывания на устройстве Android.In this section, you will learn how to configure your project to build and deploy it to an Android device.

В меню Unity щелкните File (Файл) > Build Settings... (Параметры сборки...) , чтобы открыть окно параметров сборки. Переключите платформу на Android.In the Unity menu, select File > Build Settings... to open the Build Settings window and then switch the platform to Android:

Окно параметров сборки Unity с выбранной платформой Android

Совет

Сведения о процедуре можно найти в разделе Переключение платформы сборки.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

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

В меню Unity выберите Mixed Reality Toolkit (Набор средств для смешанной реальности) > Utilities (Служебные программы) > Configure Unity Project (Настройка проекта Unity) ,чтобы открыть окно MRTK Project Configurator (Конфигуратор проектов MRTK). Убедитесь, что выбраны все параметры, а затем нажмите кнопку Apply (Применить), чтобы применить эти параметры.In the Unity menu, select Mixed Reality Toolkit > Utilities > Configure Unity Project to open the MRTK Project Configurator window, ensure all options are selected, then click the Apply button to apply the settings:

Окно конфигуратора проектов MRTK в Unity для Android

В меню Unity щелкните Edit > Project Settings... (Правка > Параметры проекта...), чтобы открыть окно параметров проигрывателя, а затем найдите раздел Player (Проигрыватель) > Other Settings (Другие параметры) . Выберите элемент Vulkan и удалите его, щелкнув символ - .In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Other Settings section, select Vulkan and remove it by clicking the "-" symbol:

Другие параметры Unity с выбранным API Vulcan

Закройте окно Player Settings (Параметры проигрывателя) и снова откройте окно Build Settings (Параметры сборки).Close the Player Settings window and open the Build Settings window again.

В окне Build Settings (Параметры сборки) нажмите кнопку Add Open Scenes (Добавить открытые сцены), чтобы добавить текущую сцену в список Scenes In Build (Сцены в сборке).In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list. Затем с помощью USB-кабеля подключите к компьютеру устройство Android и выберите его в раскрывающемся списке Run Device (Запустить устройство).Then, use a USB cable, connect your Android device to your computer and select it from the Run Device dropdown:

Окно параметров сборки в Unity с добавленной сценой и выбранным устройством выполнения

Примечание

Если устройство не отображается в раскрывающемся списке Run Device (Запустить устройство), возможно, потребуется нажать кнопку Refresh (Обновить) рядом с раскрывающимся списком.If your device does not appear in the Run Device dropdown, you might need to press the Refresh button next to the dropdown.

В окне Build Settings (Параметры сборки) нажмите кнопку Build And Run (Сборка и запуск), чтобы открыть окно сборка Android.In the Build Settings window, click the Build And Run button to open the Build Android window.

Выберите подходящее расположение для хранения сборки, например D:\MixedRealityLearning\Builds. Присвойте сборке APK понятное имя, например MRTKTutorials-AzureSpatialAnchors. Затем нажмите кнопку Save (Сохранить), чтобы запустить процесс сборки.Choose a suitable location to store your build, for example, D:\MixedRealityLearning\Builds, then give the apk a suitable name, for example, MRTKTutorials-AzureSpatialAnchors, and click the Save button to start the build process:

Окно параметров сборки Unity с окном сохранения для Android

Примечание

Если в окне консоли Unity появится сообщение об ошибке, связанной с модулями пакетов SDK, NDK и JDK для Android, необходимо открыть Unity Hub и установить соответствующие модули Android Build Support.If you get any error in the Unity Console window related to Android SDK, NDK, or JDK modules, you need to open Unity Hub and install the associated Android Build Support modules.

По завершении сборки приложения должны автоматически загрузиться на устройство Android.When the build process is complete, your apps should automatically load on your Android device.

Создание приложения для устройства iOSBuilding your application to your iOS device

Из этого раздела вы узнаете, как настроить проект для сборки и развертывания на устройстве iOS.In this section, you will learn how to configure your project, to build and deploy it to your iOS device.

В меню Unity щелкните File (Файл) > Build Settings... (Параметры сборки...) , чтобы открыть окно параметров сборки. Переключите платформу на iOS.In the Unity menu, select File > Build Settings... to open the Build Settings window and switch platform to iOS:

Окно параметров сборки Unity с выбранным вариантом iOS

Совет

Сведения о процедуре можно найти в разделе Переключение платформы сборки.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

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

В меню Unity выберите Mixed Reality Toolkit (Набор средств для смешанной реальности) > Utilities (Служебные программы) > Configure Unity Project (Настройка проекта Unity) ,чтобы открыть окно MRTK Project Configurator (Конфигуратор проектов MRTK). Убедитесь, что выбраны все параметры, а затем нажмите кнопку Apply (Применить), чтобы применить эти параметры.In the Unity menu, select Mixed Reality Toolkit > Utilities > Configure Unity Project to open the MRTK Project Configurator window, ensure all options are selected, then click the Apply button to apply the settings:

Окно конфигурации проекта MRTK в Unity для iOS

В меню Unity щелкните Edit > Project Settings... (Правка > Параметры проекта...), чтобы открыть окно параметров проигрывателя, а затем найдите раздел Player (Проигрыватель) > Other Settings (Другие параметры) . Снимите флажок Strip Engine Code (Удалить код обработчика), чтобы отключить его.In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Other Settings section, uncheck the Strip Engine Code checkbox to disable it:

Другие параметры Unity с отключенным параметром Strip Engine Code (Удалить код обработчика)

Закройте окно Player Settings (Параметры проигрывателя) и снова откройте окно Build Settings (Параметры сборки).Close the Player Settings window and open the Build Settings window again.

В окне Build Settings (Параметры сборки) нажмите кнопку Add Open Scenes (Добавить открытые сцены), чтобы добавить текущую сцену в список Scenes In Build (Сцены в сборке).In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list:

Окно параметров сборки Unity с добавленной сценой

В окне Build Settings (Параметры сборки) нажмите кнопку Build (Сборка), чтобы открыть окно сборки iOS.In the Build Settings window, click the Build button to open the Build iOS window.

Выберите подходящее расположение для хранения проекта Xcode, например D:\MixedRealityLearning\Builds. Создайте папку и присвойте ей понятное имя, например MRTKTutorials-AzureSpatialAnchors. Затем нажмите кнопку Select Folder (Выбрать папку), чтобы начать сборку.Choose a suitable location to store your Xcode project, for example, D:\MixedRealityLearning\Builds, create a new folder and give it a suitable name, for example, MRTKTutorials-AzureSpatialAnchors, and then click the Select Folder button to start the build process:

Окно параметров сборки Unity с окном сохранения для iOS

После сборки выполните инструкции из раздела Экспорт проект Xcode, чтобы научиться развертывать проекты Xcode на устройствах iOS.When the build process is complete, follow the Export the Xcode project instructions to learn to deploy your Xcode project to your iOS device.

Поздравляем!Congratulations

Из этого руководства вы узнали, как выполнить сборку проекта на устройствах Android и iOS с помощью пакетов AR Foundation, ARCore XR Plugin и ARKit XR Plugin.In this tutorial, you learned how to build your project to Android and iOS devices using AR Foundation, ARCore XR Plugin, and ARKit XR Plugin.