Дополнительный пакет ARCore Extensions for AR Foundation добавляет функциональные возможности к пакету Unity AR Foundation , позволяя вам использовать в своем приложении такие функции, как облачные привязки , фильтры конфигурации камеры , а также запись и воспроизведение .
Требования
Для разработки с помощью ARCore Extensions for AR Foundation вам понадобится следующее:
Андроид
Аппаратное обеспечение
- Устройство Android с поддержкой ARCore
- USB-кабель для подключения вашего устройства к машине разработки.
Программное обеспечение
- Unity 2019.4.3f1 или новее с поддержкой сборки Android
- AR Foundation 4.1.5 или новее (автоматически устанавливается вместе с ARCore Extensions for AR Foundation SDK)
- Плагин ARCore XR 4.1.5 или новее (автоматически устанавливается вместе с ARCore Extensions for AR Foundation SDK)
iOS
Аппаратное обеспечение
- Устройство, совместимое с ARKit и поддерживающее ARCore.
- USB-кабель для подключения вашего устройства к машине разработки.
Программное обеспечение
- Unity 2019.4.3f1 или новее с поддержкой сборки iOS
- AR Foundation 4.1.5 или новее (автоматически устанавливается вместе с ARCore Extensions for AR Foundation SDK)
- Плагин ARKit XR 4.1.5 или новее (автоматически устанавливается вместе с ARCore Extensions for AR Foundation SDK)
- Xcode 11.0 или новее
Установите пакет расширений ARCore.
Выполните следующие действия, чтобы установить расширения ARCore для AR Foundation.
Связанные зависимости
- Убедитесь, что в вашей среде разработки установлен и настроен AR Foundation.
- Откройте или создайте новый проект Unity.
- Выберите желаемую целевую платформу сборки:
- В меню File выберите Build Settings .
- Выберите Android или iOS в зависимости от желаемой целевой платформы.
- Нажмите Switch Platform .
Импортируйте последний пакет расширений ARCore:
- Перейдите в Window > Package Manager .
Нажмите кнопку и выберите опцию Add package from git URL... в раскрывающемся меню.
Вставьте следующий URL-адрес в текстовое поле:
https://github.com/google-ar/arcore-unity-extensions.git
Нажмите Add .
Без ЭДМ4У
По умолчанию расширения ARCore поставляются с дополнительными зависимостями. При использовании других библиотек (например, Firebase Analytics ), которые зависят от другой версии Диспетчера внешних зависимостей для Unity , может возникнуть неопределенное поведение , в результате чего зависимые элементы перестанут работать правильно.
Установите расширения ARCore без связанных зависимостей, чтобы предотвратить конфликты версий библиотек:
- Загрузите расширения ARCore без выпуска EDM4U и
com.google.external-dependency-manager
, - Следуйте инструкциям по импорту пакетов UPM с файлами
.tgz
, устанавливая пакеты в следующем порядке:-
com.google.external-dependency-manager
, - Расширения 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
На панели Hierarchy щелкните правой кнопкой мыши и добавьте следующие игровые объекты (если они еще не добавлены):
- XR > AR Session
- XR > AR Session Origin
- XR > ARCore Extensions
На панели Hierarchy выберите пакет ARCore Extensions .
На панели Inspector для каждого из следующих полей щелкните целевой объект. кнопку и соедините каждое поле с соответствующим игровым объектом следующим образом:
- Session : используйте AR Session вашей сцены.
- AR Session Origin : используйте AR Session Origin вашей сцены.
- Camera Manager : используйте AR Camera вашей сцены.
При необходимости создайте и подключите следующие ресурсы для облачных привязок и фильтров конфигурации камеры.
На панели Project > Assets щелкните правой кнопкой мыши и выберите Create > XR > ARCore Extensions Config .
На панели Project > Assets щелкните правой кнопкой мыши и выберите Create > XR > Camera Config Filter .
На панели Hierarchy выберите пакет ARCore Extensions .
В поле ARCore Extensions Config на панели Inspector щелкните целевой объект. кнопку и подключитесь к активу ARCoreExtensionsConfig .
В поле Camera Config Filter на панели Inspector щелкните цель. кнопку и подключитесь к активу ARCoreExtensionsCameraConfigFilter .
Дополнительные сведения см. в руководстве разработчика Cloud Anchors и в руководстве по настройке камеры .
Если вы используете версию Unity ниже 2020.3:
- Выберите «Настраиваемый шаблон свойств Gradle» в разделе «Настройки проекта» > «Плеер» > «Android» > «Настройки публикации» > «Сборка» .
Если все вышеперечисленные поля расширений ARCore подключены соответствующим образом, панель Inspector расширений ARCore будет выглядеть следующим образом:
AR Фонд 5.x
На панели Hierarchy щелкните правой кнопкой мыши и добавьте следующие игровые объекты (если они еще не добавлены):
- XR > AR Session
- XR > XR Origin (Mobile AR)
- XR > ARCore Extensions
На панели Hierarchy выберите пакет ARCore Extensions .
На панели Inspector для каждого из следующих полей щелкните целевой объект. кнопку и соедините каждое поле с соответствующим игровым объектом следующим образом:
- Session : используйте AR Session вашей сцены.
- XR Origin : используйте XR Origin вашей сцены.
- Camera Manager : используйте AR Camera вашей сцены.
При необходимости создайте и подключите следующие ресурсы для облачных привязок и фильтров конфигурации камеры.
На панели Project > Assets щелкните правой кнопкой мыши и выберите Create > XR > ARCore Extensions Config .
На панели Project > Assets щелкните правой кнопкой мыши и выберите Create > XR > Camera Config Filter .
На панели Hierarchy выберите пакет ARCore Extensions .
В поле ARCore Extensions Config на панели Inspector щелкните целевой объект. кнопку и подключитесь к ресурсу ARCoreExtensionsConfig .
В поле Camera Config Filter на панели Inspector щелкните цель. кнопку и подключитесь к активу ARCoreExtensionsCameraConfigFilter .
Дополнительные сведения см. в руководстве разработчика Cloud Anchors и в руководстве по настройке камеры .
Если вы используете версию Unity ниже 2020.3:
- Выберите «Настраиваемый шаблон свойств Gradle» в разделе «Настройки проекта» > «Плеер» > «Android» > «Настройки публикации» > «Сборка» .
Если все вышеперечисленные поля расширений ARCore подключены соответствующим образом, панель Inspector расширений ARCore будет выглядеть следующим образом:
Дополнительную информацию о настройке свойств см. в руководстве Unity по редактированию свойств.
Примеры проектов
В комплект ARCore Extensions for AR Foundation входят примеры проектов, которые вы можете использовать, чтобы начать создавать свои собственные проекты.
В меню Window откройте « Package Manager и выберите пакет ARCore Extensions .
В разделе Samples нажмите Import для примера проекта, описанного ниже.
Следующие примеры проектов импортированы из репозитория GitHub :
Геопространственные возможности (только для Android). Создавайте возможности дополненной реальности в глобальном масштабе и удаленно прикрепляйте контент к любой области, охватываемой Google Street View. Дополнительную информацию см. во введении к Geospatial API .
PersistentCloudAnchors (Android и iOS) — создавайте постоянные возможности дополненной реальности в реальном мире с помощью интерактивных слоев цифровой информации, привязанных к реальным местоположениям, и проектируйте опыт, которым со временем могут делиться несколько людей на разных устройствах. Дополнительную информацию см. во введении к облачным якорям .
Что дальше
Благодаря расширениям ARCore для AR Foundation вы теперь можете использовать облачные привязки и конфигурации камер в своих приложениях.