Краткое руководство по Google Cardboard для Unity

В этом руководстве показано, как использовать плагин Google Cardboard XR для Unity для создания собственных приложений виртуальной реальности (VR).

Примечание: обязательно ознакомьтесь с правилами брендинга Cardboard, прежде чем распространять свое приложение среди более широкой аудитории.

С помощью Cardboard SDK можно превратить мобильный телефон в платформу виртуальной реальности. Мобильное устройство может отображать 3D-сцены со стереоскопическим рендерингом, отслеживать и реагировать на движения головы, а также взаимодействовать с приложениями, определяя нажатие пользователем кнопки просмотра.

Для начала вам понадобится HelloCardboard — демо-игра, демонстрирующая основные функции Cardboard SDK. В игре пользователи исследуют виртуальный мир, находят и собирают предметы. В ней показано, как:

• Настройте среду разработки
• Загрузите и создайте демо-приложение
• Отсканируйте QR-код устройства просмотра Cardboard, чтобы сохранить его параметры.
• Отслеживайте движения головы пользователя
• Создавайте стереоскопические изображения, устанавливая правильное искажение для каждого глаза.
• Включайте и выключайте режим VR

Настройте среду разработки

Требования к программному обеспечению:

• Unity 6000.0.23f1 или более поздняя версия
  • Обязательно включите поддержку сборки Android и iOS во время установки.
  • Обязательно установите патч версии 23f1 или более поздней.
• Git должен быть установлен, а исполняемый файл git должен быть добавлен в переменную окружения PATH . Подробнее см. в документации по поддержке Git менеджера пакетов Unity .

Импортируйте SDK и создайте новый проект.

Выполните следующие действия, чтобы импортировать Unity SDK и создать новый проект.

1. Откройте Unity и создайте новый 3D- проект.
2. В Unity перейдите в Окно > Менеджер пакетов .
3. Нажмите + и выберите Добавить пакет из URL git .
4. Вставьте https://github.com/googlevr/cardboard-xr-plugin.git в поле ввода текста.
   Пакет следует добавить к установленным пакетам.
5. Перейдите к пакету плагина Google Cardboard XR для Unity . В разделе «Образцы» выберите «Импортировать в проект» .
   Примеры ресурсов следует загрузить в Assets/Samples/Google Cardboard/<version>/Hello Cardboard .

Примечание: <version> — это семантический номер версии XYZ выпущенного пакета (например, 1.1.0 ).

Настроить сцену HelloCardboard

1. Перейдите в Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes , выберите Add Open Scenes и выберите HelloCardboard , чтобы открыть пример сцены.
2. Откройте меню «Слои» и выберите «Редактировать слои...» .
3. Определите новый слой под названием «Интерактивный».
4. Щёлкните по игровому объекту « Сокровище» , чтобы открыть окно «Инспектор». Установите для него слой «Интерактивный». Если появится всплывающее окно с вопросом, хотите ли вы установить интерактивный слой для всех дочерних объектов, нажмите «Да, изменить дочерние объекты».
5. Нажмите «Игровой объект Player» > «Камера» > «CardboardReticlePointer» , чтобы открыть окно «Инспектор». В скрипте «Cardboard reticle pointer» выберите «Interactive» в качестве маски слоя взаимодействия с прицелом .

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

Перейдите в Файл > Параметры сборки .

1. Выберите Android и нажмите «Сменить платформу» .
2. Выберите Добавить открытые сцены и выберите HelloCardboard .

Настройки плеера

Перейдите в Правка > Настройки проекта....

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

Перейдите в меню «Проигрыватель» > «Разрешение и представление» .

1. Установите ориентацию по умолчанию на Альбомная левая или Альбомная правая .
2. Отключить оптимизированную регулировку кадров .

Примечание: несмотря на поддержку плагина Cardboard XR, ориентация «Портрет» и «Перевернутый портрет» может не обеспечивать достаточного пространства для визуализации глаз на устройствах.

Настроить другие параметры

Перейдите в раздел «Проигрыватель» > «Другие настройки» .

1. Выберите OpenGLES2 , OpenGLES3 или Vulkan или любую их комбинацию в графических API .
2. В поле «Минимальный уровень API» выберите Android 8.0 'Oreo' (API level 26) или выше.
3. Выберите API level 35 или выше в поле Целевой уровень API .
4. Выберите IL2CPP в Scripting Backend .
5. Выберите нужную архитектуру, указав ARMv7 , ARM64 или обе в поле «Целевые архитектуры» .
6. Выберите Require в разделе «Доступ в Интернет» .
7. Выберите Input System Package (New) в разделе Активная обработка входных данных .
8. Укажите домен вашей компании в поле «Имя пакета» .
9. Если в качестве графического API выбран Vulkan :
   • Снимите флажок Применить поворот дисплея во время рендеринга в настройках Vulkan .
   • В поле Формат сжатия текстур выберите ETC2 .
10. Выберите Activity и очистите GameActivity в Application Entry Point .

Примечание: можно использовать более низкий минимальный уровень API, изменив совместимость API рендеринга. Подробнее см. в build.gradle SDK .

Примечание: Если у вас возникли проблемы при выборе Vulkan в качестве графического API, установите флажок Development Build в Build Settings и проанализируйте журналы выполнения на предмет ошибок совместимости драйверов.

Примечание: OpenGL ES 2.0 больше не поддерживается в Unity 2023.1 и выше. Для более новых версий используйте OpenGL ES 3.0 или Vulkan. Подробнее см. на странице «Требования и совместимость Android» в руководстве по Unity.

Настроить параметры публикации

Перейдите в раздел «Проигрыватель» > «Настройки публикации» .

1. В разделе «Сборка» выберите Custom Main Gradle Template и Custom Gradle Properties Template .

2. Добавьте следующие строки в раздел зависимостей Assets/Plugins/Android/mainTemplate.gradle :

     implementation 'androidx.appcompat:appcompat:1.6.1'
     implementation 'com.google.android.gms:play-services-vision:20.1.3'
     implementation 'com.google.android.material:material:1.12.0'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. Добавьте следующие строки в Assets/Plugins/Android/gradleTemplate.properties :

     android.enableJetifier=true
     android.useAndroidX=true
   

Примечание: Необходимые зависимости могут меняться от версии к версии. Если вы хотите использовать версию, отличную от последней, ознакомьтесь с историей раздела «Зависимости» в файле sdk/build.gradle репозитория Cardboard SDK.

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

Перейдите в раздел «Управление подключаемыми модулями XR» .

1. Выберите Cardboard XR Plugin в разделе «Поставщики подключаемых модулей» .

Создайте свой проект

Перейдите в Файл > Параметры сборки .

1. Выберите «Сборка» или выберите устройство и выберите «Сборка и запуск» .

Настройте параметры проекта iOS

Перейдите в Файл > Параметры сборки .

1. Выберите iOS и нажмите «Сменить платформу» .
2. Выберите Добавить открытые сцены и выберите HelloCardboard .

Настройки плеера

Перейдите в Правка > Настройки проекта....

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

Перейдите в раздел «Проигрыватель» > «Разрешение и представление» .

1. Установите ориентацию по умолчанию на Альбомная левая или Альбомная правая .

Примечание: несмотря на поддержку плагина Cardboard XR, ориентация «Портрет» и «Перевернутый портрет» может не обеспечивать достаточного пространства для визуализации глаз на устройствах.

Настроить другие параметры

Перейдите в раздел «Проигрыватель» > «Другие настройки» .

1. В описании использования камеры напишите Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters).
2. В поле Минимальная целевая версия iOS напишите 12.0 .
3. Укажите домен вашей компании в поле «Имя пакета» .
4. Проверьте Top Edge , Left Edge и Right Edge в Отсрочке жестов системы на краях .

Примечание: Если вы используете iPhone X, выберите опцию Скрыть кнопку «Домой» на iPhone X.

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

Перейдите в раздел «Управление подключаемыми модулями XR» .

1. Выберите Cardboard XR Plugin в разделе «Поставщики подключаемых модулей» .

Создайте свой проект

Перейдите в Файл > Параметры сборки .

1. Выберите «Сборка» или «Сборка и запуск» .

Повторно центрировать

Cardboard SDK позволяет центрировать устройство отслеживания положения головы с помощью Recenter() .

Чтобы опробовать приложение-пример, выполните следующие действия:

1. Переместите устройство в положение, которое вы хотите центрировать (используйте как новую позу головы, смотрящей вперед).
2. Удерживайте кнопку на устройстве Cardboard активной не менее трех секунд.
3. Отпустите курок.
4. Первоначальная поза теперь находится в направлении, куда указывает камера.

Включайте и выключайте режим VR

API управления плагином Unity XR позволяет включать и выключать режим виртуальной реальности для плагина Google Cardboard XR для Unity . Документация для конечного пользователя и примеры использования доступны в документации для конечного пользователя Unity.

Сцена VrMode в примере HelloCardboard демонстрирует базовое использование вышеупомянутого API. В этой сцене режим виртуальной реальности можно отключить, нажав кнопку «Выход». , и его можно включить снова, просто коснувшись любой точки экрана. Подробности о том, как это реализовано, см. в файле VrModeController.cs.

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

• Ознакомьтесь с рекомендациями по брендингу картона .