Включите AR в приложении AR Foundation (только для Android)

Включите поддержку дополненной реальности (AR) для использования функций дополненной реальности в вашем новом или существующем приложении.

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

Для экономии места на отдельных устройствах все функции дополненной реальности хранятся в приложении Google Play Services for AR , которое обновляется отдельно через Play Store. Приложения Android, использующие функции дополненной реальности, взаимодействуют с Google Play Services for AR с помощью SDK ARCore. Приложение, поддерживающее функции дополненной реальности, может быть настроено двумя способами: AR Required и AR Optional . Это обозначение определяет, как приложение взаимодействует с приложением Google Play Services for AR.

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

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

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

  • Приложения с поддержкой дополненной реальности (AR Optional) можно устанавливать и запускать на устройствах, не поддерживающих ARCore.
  • Когда пользователи устанавливают приложение, поддерживающее дополненную реальность (AR Optional), Google Play Store не устанавливает автоматически сервисы Google Play для дополненной реальности на устройство.
Требуется допуск к секретной информации (AR). AR (необязательно)
Использование функций дополненной реальности Для работы базовых функций вашему приложению необходим ARCore. ARCore расширяет функциональность вашего приложения. Ваше приложение может работать и без поддержки ARCore.
видимость в Play Store Ваше приложение отображается в Play Store только на устройствах, поддерживающих ARCore. Ваше приложение соответствует стандартным процедурам размещения .
Способ установки Google Play Services для AR Play Store устанавливает сервисы Google Play для дополненной реальности вместе с вашим приложением. Ваше приложение использует сопрограмму ARSession.Install() для загрузки и установки ARCore.
Требования minSdkVersion Android Android 7.0 (уровень API 24) Android 4.4 (уровень API 19), хотя для работы любых функций дополненной реальности требуется как минимум Android 7.0 (уровень API 24).
Для проверки поддержки ARCore и статуса установки необходимо использовать ARSession.state
Для установки Google Play Services для дополненной реальности необходимо использовать сопрограмму ARSession.Install()

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

Android

  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) в вашем приложении необязательной.

Android

  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 , равный 24 или выше.

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 для вашего приложения.

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

Проверьте, установлены ли сервисы Google Play для дополненной реальности.

Как приложения, требующие дополненной реальности (AR Required), так и приложения, не требующие дополненной реальности (AR Optional), должны использовать сопрограмму ARSession.Install() перед созданием сессии ARCore, чтобы проверить, установлена ​​ли (по-прежнему) совместимая версия Google Play Services for AR, и убедиться, что все необходимые данные профиля устройства ARCore загружены.

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

  • Поддерживает 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 , чтобы узнать состояние установки и поддержки.

Соблюдайте требования к конфиденциальности пользователей.

Чтобы опубликовать свое приложение в Play Store, убедитесь, что оно соответствует требованиям ARCore к защите конфиденциальности пользователей .

Что дальше?