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

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

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

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

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

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

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

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

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

Андроид

  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 необязательным

Андроид

  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 , чтобы установить для вашего приложения статус AR «Необязательно».

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

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

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

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

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

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

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

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

Состояние Действие
Устройство не поддерживает ARCore. Скрывает функциональность, связанную с AR.
Устройство поддерживает 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 к конфиденциальности пользователей .

Что дальше