Unity AR Foundation — это кроссплатформенная среда, которая позволяет вам один раз написать приложения дополненной реальности, а затем создать их для устройств Android или iOS без внесения каких-либо дополнительных изменений. Платформа доступна через пакет Unity AR Foundation .
Дополнительный пакет расширений ARCore для AR Foundation от ARCore добавляет дополнительные функциональные возможности, позволяя вам использовать в вашем приложении такие функции, как облачные привязки, фильтры конфигурации камеры, а также запись и воспроизведение.
Перенос или обновление существующих проектов
- Чтобы перенести существующий проект из (устаревшего) ARCore SDK для Unity в Unity AR Foundation и, при необходимости, в ARCore Extensions , см. руководство по миграции .
- Чтобы обновить существующий проект с более ранней версии AR Foundation, см. руководства по обновлению и миграции Unity.
Требования
В зависимости от вашей целевой платформы пакет AR Foundation требует следующего:
Андроид
Аппаратное обеспечение
- Устройство Android или эмулятор с поддержкой ARCore
- USB-кабель для подключения вашего устройства к машине разработки.
Программное обеспечение
iOS
Аппаратное обеспечение
- Устройство iOS с поддержкой ARCore
- USB-кабель для подключения вашего устройства к машине разработки.
Программное обеспечение
Установить AR Foundation
Выполните следующие действия, чтобы установить пакет AR Foundation Unity.
Откройте существующий проект Unity или создайте новый 3D-проект.
Перейдите в Window > Package Manager .
Рядом с Packages выберите Unity Registry .
В строке поиска введите «AR Foundation».
Нажмите Install .
Установите и включите пакеты плагинов для конкретной платформы.
Пакет AR Foundation предоставляет интерфейс для использования разработчиками Unity, но сам по себе не реализует никаких функций AR. Чтобы использовать AR Foundation на целевом устройстве, вам также необходимо установить отдельные пакеты и включить соответствующий плагин для каждой соответствующей платформы.
Андроид
Пакет плагинов ARCore XR позволяет создавать приложения дополненной реальности для устройств Android. Выполните следующие действия, чтобы установить его в свой проект Unity, если ваше приложение предназначено для устройств Android. Используйте ту же версию, что и пакет AR Foundation , чтобы избежать проблем с совместимостью.
В своем проекте перейдите в Window > Package Manager .
Рядом с Packages выберите Unity Registry .
В строке поиска введите «Плагин ARCore XR».
Нажмите Install .
Перейдите в Edit > Project Settings . В XR Plug-in Management откройте вкладку Android и включите ARCore .
iOS
Плагин ARKit XR позволяет создавать приложения дополненной реальности для устройств iOS. Выполните следующие действия, чтобы установить его в свой проект Unity, если ваше приложение предназначено для устройств iOS. Используйте ту же версию, что и пакет AR Foundation , чтобы избежать проблем с совместимостью.
В своем проекте перейдите в Window > Package Manager .
Рядом с Packages выберите Unity Registry .
В строке поиска введите «Плагин ARKit XR».
Нажмите Install .
Перейдите в Edit > Project Settings . В XR Plug-in Management откройте вкладку iOS и включите ARKit .
Настройте сеанс AR и добавьте компоненты AR Foundation в свою сцену.
Сцене необходим сеанс AR, чтобы активировать процессы AR , такие как отслеживание движения, понимание окружающей среды и оценка освещения. Для поддержки сеанса AR вам потребуются следующие игровые объекты:
AR Фонд 4.x
AR Session : контролирует жизненный цикл AR-опыта.
AR Session Origin : преобразует координаты AR в мировые координаты Unity.
Прежде чем добавлять новые игровые объекты, удалите Main Camera по умолчанию. Она будет заменена новой AR Camera в AR Session Origin .
Добавьте новые игровые объекты AR в свою сцену: щелкните правой кнопкой мыши панель Hierarchy и выберите XR . Добавьте новый AR Session и новый игровой объект AR Session Origin .
AR Фонд 5.x
AR Session : контролирует жизненный цикл AR-опыта.
XR Origin : преобразует координаты AR в мировые координаты Unity.
Прежде чем добавлять новые игровые объекты, удалите Main Camera по умолчанию. В XR Origin она будет заменена новой AR Camera .
Добавьте новые игровые объекты AR в свою сцену: щелкните правой кнопкой мыши панель Hierarchy и выберите XR . Добавьте новый AR Session и новый игровой объект XR Origin .
Настройка параметров проигрывателя
Андроид
- Перейдите в File > Build Settings , чтобы открыть окно Build Settings .
- В разделе Platform выберите Android и нажмите Switch Platform .
- Нажмите Player Settings .
Примените следующие изменения:
Player Settings > … Ценить Other Settings > Rendering Снимите флажок Auto Graphics API .
Если Vulkan указан в разделе Graphics APIs , удалите его, поскольку Vulkan еще не поддерживается ARCore.Other Settings > Package Name Создайте уникальный идентификатор приложения, используя формат имени пакета Java.
Например, используйтеcom.example.helloAR
.Other Settings > Minimum API Level Если вы создаете приложение, требующее AR , укажите Android 7.0 'Nougat' (API Level 24) or higher .
Если вы создаете дополнительное приложение AR , укажите Android API Level 19 or higher .Other Settings > Scripting Backend Выберите IL2CPP вместо Mono , чтобы включить поддержку ARM64 на следующем шаге. В ходе разработки:
- Используйте Mono + 32-бит (ARMv7)
- Установите FAT (32-битный + 64-битный) APK-файл ARCore.
При доставке в Play Store:
- Используйте IL2CPP
- Включите как 32-разрядную версию (ARMv7), так и 64-разрядную версию (ARM64), чтобы соответствовать требованиям Play Store к 64-разрядной версии.
- Необязательно (поддерживается в версии 2018.3+): в Build Settings включите Android App Bundles .
Other Settings > Target Architectures Чтобы соответствовать требованиям Google Play к 64-разрядной версии , включите ARM64 (64-разрядный ARM). Оставьте ARMv7 (32-битный ARM) включенным для поддержки 32-битных устройств.
iOS
- Перейдите в File > Build Settings , чтобы открыть окно Build Settings .
- В разделе Platform выберите iOS и нажмите Switch Platform .
- Нажмите Player Settings .
Настройте следующие параметры:
Player Settings > … Ценить Other Settings > Bundle Identifier Добавьте имя вашего приложения в формате обратного DNS.
Например, используйтеcom.mycompany.myapp
.Other Settings > Camera usage description Введите описание, объясняющее использование вами AR (например, ARKit). Other Settings > Target minimum iOS version 11.0 или выше Other Settings > Architecture ARM64
Что дальше
- Начните работу с дополнительного пакета расширений ARCore , который предоставляет дополнительные функции ARCore для платформы AR Foundation.
- Создайте AR-игру, используя Unity AR Foundation (codelab).