Начало работы с расширениями ARCore для AR Foundation

Дополнительный пакет ARCore Extensions for AR Foundation добавляет функциональные возможности к пакету Unity AR Foundation , позволяя вам использовать в своем приложении такие функции, как облачные привязки , фильтры конфигурации камеры , а также запись и воспроизведение .

Требования

Для разработки с помощью ARCore Extensions for AR Foundation вам понадобится следующее:

Андроид

Аппаратное обеспечение

  • Устройство Android с поддержкой ARCore
  • USB-кабель для подключения вашего устройства к машине разработки.

Программное обеспечение

iOS

Аппаратное обеспечение

Программное обеспечение

Установите пакет расширений ARCore.

Выполните следующие действия, чтобы установить расширения ARCore для AR Foundation.

Связанные зависимости

  1. Убедитесь, что в вашей среде разработки установлен и настроен AR Foundation.
  2. Откройте или создайте новый проект Unity.
  3. Выберите желаемую целевую платформу сборки:
    1. В меню File выберите Build Settings .
    2. Выберите Android или iOS в зависимости от желаемой целевой платформы.
    3. Нажмите Switch Platform .

  4. Импортируйте последний пакет расширений ARCore:

    1. Перейдите в Window > Package Manager .

    2. Нажмите кнопку и выберите опцию Add package from git URL... в раскрывающемся меню.

    3. Вставьте следующий URL-адрес в текстовое поле:

      https://github.com/google-ar/arcore-unity-extensions.git

    4. Нажмите Add .

Без ЭДМ4У

По умолчанию расширения ARCore поставляются с дополнительными зависимостями. При использовании других библиотек (например, Firebase Analytics ), которые зависят от другой версии Диспетчера внешних зависимостей для Unity , может возникнуть неопределенное поведение , в результате чего зависимые элементы перестанут работать правильно.

Установите расширения ARCore без связанных зависимостей, чтобы предотвратить конфликты версий библиотек:

  1. Загрузите расширения ARCore без выпуска EDM4U и com.google.external-dependency-manager ,
  2. Следуйте инструкциям по импорту пакетов UPM с файлами .tgz , устанавливая пакеты в следующем порядке:
    1. com.google.external-dependency-manager ,
    2. Расширения ARCore (без EDM4U).

При установке ARCore Extensions Unity также автоматически установит подходящую версию необходимых зависимостей:

  • AR Foundation
  • ARCore XR Plugin (используется для Android)
  • ARKit XR Plugin (используется при настройке iOS)

Эти зависимости могут быть не видны в Package Manager > Package: In project . Однако пакеты можно увидеть в окне Project в разделе Packages .

Настройка расширений ARCore

AR Фонд 4.x

  1. На панели Hierarchy щелкните правой кнопкой мыши и добавьте следующие игровые объекты (если они еще не добавлены):

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions

  2. На панели Hierarchy выберите пакет ARCore Extensions .

  3. На панели Inspector для каждого из следующих полей щелкните целевой объект. кнопку и соедините каждое поле с соответствующим игровым объектом следующим образом:

    • Session : используйте AR Session вашей сцены.
    • AR Session Origin : используйте AR Session Origin вашей сцены.
    • Camera Manager : используйте AR Camera вашей сцены.

  4. При необходимости создайте и подключите следующие ресурсы для облачных привязок и фильтров конфигурации камеры.

    1. На панели Project > Assets щелкните правой кнопкой мыши и выберите Create > XR > ARCore Extensions Config .

    2. На панели Project > Assets щелкните правой кнопкой мыши и выберите Create > XR > Camera Config Filter .

    3. На панели Hierarchy выберите пакет ARCore Extensions .

    4. В поле ARCore Extensions Config на панели Inspector щелкните целевой объект. кнопку и подключитесь к активу ARCoreExtensionsConfig .

    5. В поле Camera Config Filter на панели Inspector щелкните цель. кнопку и подключитесь к активу ARCoreExtensionsCameraConfigFilter .

      Дополнительные сведения см. в руководстве разработчика Cloud Anchors и в руководстве по настройке камеры .

    6. Если вы используете версию Unity ниже 2020.3:

      • Выберите «Настраиваемый шаблон свойств Gradle» в разделе «Настройки проекта» > «Плеер» > «Android» > «Настройки публикации» > «Сборка» .

Если все вышеперечисленные поля расширений ARCore подключены соответствующим образом, панель Inspector расширений ARCore будет выглядеть следующим образом:

AR Фонд 5.x

  1. На панели Hierarchy щелкните правой кнопкой мыши и добавьте следующие игровые объекты (если они еще не добавлены):

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions

  2. На панели Hierarchy выберите пакет ARCore Extensions .

  3. На панели Inspector для каждого из следующих полей щелкните целевой объект. кнопку и соедините каждое поле с соответствующим игровым объектом следующим образом:

    • Session : используйте AR Session вашей сцены.
    • XR Origin : используйте XR Origin вашей сцены.
    • Camera Manager : используйте AR Camera вашей сцены.

  4. При необходимости создайте и подключите следующие ресурсы для облачных привязок и фильтров конфигурации камеры.

    1. На панели Project > Assets щелкните правой кнопкой мыши и выберите Create > XR > ARCore Extensions Config .

    2. На панели Project > Assets щелкните правой кнопкой мыши и выберите Create > XR > Camera Config Filter .

    3. На панели Hierarchy выберите пакет ARCore Extensions .

    4. В поле ARCore Extensions Config на панели Inspector щелкните целевой объект. кнопку и подключитесь к ресурсу ARCoreExtensionsConfig .

    5. В поле Camera Config Filter на панели Inspector щелкните цель. кнопку и подключитесь к активу ARCoreExtensionsCameraConfigFilter .

      Дополнительные сведения см. в руководстве разработчика Cloud Anchors и в руководстве по настройке камеры .

    6. Если вы используете версию Unity ниже 2020.3:

      • Выберите «Настраиваемый шаблон свойств Gradle» в разделе «Настройки проекта» > «Плеер» > «Android» > «Настройки публикации» > «Сборка» .

Если все вышеперечисленные поля расширений ARCore подключены соответствующим образом, панель Inspector расширений ARCore будет выглядеть следующим образом:

Дополнительную информацию о настройке свойств см. в руководстве Unity по редактированию свойств.

Примеры проектов

В комплект ARCore Extensions for AR Foundation входят примеры проектов, которые вы можете использовать, чтобы начать создавать свои собственные проекты.

  1. В меню Window откройте « Package Manager и выберите пакет ARCore Extensions .

  2. В разделе Samples нажмите Import для примера проекта, описанного ниже.

Следующие примеры проектов импортированы из репозитория GitHub :

  • Геопространственные возможности (только для Android). Создавайте возможности дополненной реальности в глобальном масштабе и удаленно прикрепляйте контент к любой области, охватываемой Google Street View. Дополнительную информацию см. во введении к Geospatial API .

  • PersistentCloudAnchors (Android и iOS) — создавайте постоянные возможности дополненной реальности в реальном мире с помощью интерактивных слоев цифровой информации, привязанных к реальным местоположениям, и проектируйте опыт, которым со временем могут делиться несколько людей на разных устройствах. Дополнительную информацию см. во введении к облачным якорям .

Что дальше

Благодаря расширениям ARCore для AR Foundation вы теперь можете использовать облачные привязки и конфигурации камер в своих приложениях.