Включить ARCore

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

  1. Установите Unity 2019.4.3f1 или более позднюю версию.
  2. Иметь работающий проект с использованием AR Foundation
  3. Установите пакет расширений ARCore.
  4. Настройте приложение как обязательное или необязательное с дополненной реальностью.
  5. Выполнение проверок во время выполнения
  6. Настройте свое приложение так, чтобы оно было обязательным или необязательным.
  7. Убедитесь, что ваше приложение соответствует требованиям конфиденциальности пользователей ARCore.

Настройте приложение как обязательное или необязательное с дополненной реальностью.

Приложение, поддерживающее функции дополненной реальности, можно настроить двумя способами: AR Required или AR Optional .

Приложение, требующее дополненной реальности, не может работать без AR Required . Для этого требуется устройство с поддержкой ARCore , на котором установлен ARCore, также известный как Google Play Services for AR .

  • Магазин Google Play делает приложения, требующие дополненной реальности, доступными только на устройствах, поддерживающих ARCore AR Required
  • Когда пользователи устанавливают приложение, AR Required реальности, магазин Google Play автоматически устанавливает Google Play Services for AR . Однако ваше приложение должно по-прежнему выполнять дополнительные проверки во время выполнения на случай, если Google Play Services for AR должны быть обновлены или удалены вручную.

AR Optional использует ARCore для расширения другой функциональности. Он имеет дополнительные функции дополненной реальности, которые активируются только на устройствах с поддержкой ARCore, на которых установлены Google Play Services for AR дополненной реальности.

  • AR Optional можно устанавливать и запускать на устройствах, не поддерживающих ARCore.
  • Когда пользователи устанавливают AR Optional , магазин Google Play не будет автоматически устанавливать Google Play Services for AR вместе с приложением.
AR Required AR Optional
Использование функций дополненной реальности Вашему приложению требуется ARCore для базовой функциональности. ARCore расширяет функциональные возможности вашего приложения. Ваше приложение может работать без поддержки ARCore.
Видимость в Play Маркете Ваше приложение отображается в Play Store только на устройствах с поддержкой ARCore. Ваше приложение следует обычным процедурам листинга .
Google Play Services for AR Play Store устанавливает Google Play Services for AR вместе с вашим приложением. Ваше приложение использует ARSession.state для загрузки и установки ARCore.
Требования Android minSdkVersion 24 (Андроид 7.0) 18 (Андроид 4.3)
Необходимо использовать ARSession.state для проверки поддержки ARCore и состояния установки.

Дополнительные сведения см. в нашем обзоре распространения приложений .

Сделайте ваше приложение AR Required для дополненной реальности

Андроид:

  1. Перейдите к Edit > Project Settings > XR Plug-in Management > ARCore . По умолчанию для параметра « Requirement » установлено значение « Required ».

  2. Нажмите Edit > Project Settings > Player , выберите вкладку со значком Android.

  3. В разделе « Other Settings > Identification » укажите Minimum API Level 24 или выше.

iOS:

  1. Перейдите в Edit > Project Settings > XR Plug-in Management > ARKit . По умолчанию для параметра « Requirement » установлено значение « Required ».

  2. Нажмите Edit > Project Settings > Player , выберите вкладку со значком iOS.

  3. В разделе « Other Settings > Configuration » укажите Target minimum iOS Version для вашего приложения.

Сделайте ваше приложение AR Optional

Андроид:

  1. Перейдите к Edit > Project Settings > XR Plug-in Management > ARCore .

  2. В раскрывающемся меню « Requirement » выберите « Optional », чтобы сделать ваше приложение необязательным.

  3. Нажмите Edit > Project Settings > Player , выберите вкладку со значком Android.

  4. В разделе « Other Settings > Identification » укажите Minimum API Level 19 или выше.

iOS:

  1. Перейдите в Edit > Project Settings > XR Plug-in Management > ARKit .

  2. В раскрывающемся меню « Requirement » выберите « Optional », чтобы сделать ваше приложение необязательным.

  3. Нажмите Edit > Project Settings > Player , выберите вкладку со значком iOS.

  4. В разделе « Other Settings > Configuration » укажите Target minimum iOS Version для вашего приложения.

Выполнение проверок во время выполнения

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

  • Поддерживает ARCore
  • Установил Google Play Services for AR — если он не установлен (возможно, потому, что он был удален пользователем) или его версия слишком старая, ваше приложение предложит пользователю установить или обновить его.
  • Имеет актуальные данные профиля устройства ARCore — если они устарели, ваше приложение загрузит новые данные.

Установите для ARSession.attemptUpdate значение false , чтобы отключить эти проверки по умолчанию. Ваше приложение по-прежнему должно обрабатывать следующие условия:

Условие Действие
Устройство не поддерживает ARCore. Скрывает функциональность, связанную с дополненной реальностью.
Устройство поддерживает ARCore, но Google Play Services for AR и/или данные профиля устройства ARCore не установлены или устарели. Предлагает пользователю установить или обновить данные профиля устройства Google Play Services for AR и/или ARCore, вызвав ARSession.Install() .
Устройство поддерживает ARCore и сервисы Google Play Services for AR , а данные профиля устройства ARCore установлены и обновлены. Создает Session ARCore и начинает использовать ARCore.

Вы также можете проверить состояние установки и поддержки в ARSession.state .

Настройте свое приложение так, чтобы оно было Depth Required или Depth Optional (только для Android).

Если вашему приложению требуется поддержка API глубины , либо потому, что основная часть взаимодействия с дополненной реальностью зависит от глубины, либо потому, что нет изящного резерва для частей приложения, которые используют глубину, вы можете ограничить распространение своего приложения в Google Play. Хранить на устройствах, поддерживающих API глубины .

Сделайте ваше приложение Depth Required

Перейдите к Edit > Project Settings > XR Plug-in Management > ARCore .

По умолчанию для Depth установлено значение « Required ».

Сделайте Depth Optional

  1. Перейдите к Edit > Project Settings > XR Plug-in Management > ARCore .

  2. В раскрывающемся меню « Depth » выберите « Optional », чтобы задать для приложения необязательную глубину.

Требования конфиденциальности

Убедитесь, что ваше приложение соответствует требованиям конфиденциальности пользователей ARCore.

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