Habilita la RA en tu app de AR Foundation (solo para Android)

Habilita la RA para usar funciones de realidad aumentada en tu app nueva o existente.

Configura tu app para que sea obligatoria o opcional.

Para ahorrar espacio en dispositivos individuales, todas las funciones de RA se almacenan en una app llamada Servicios de Google Play para RA que Play Store actualiza por separado. Las apps para Android que usan funciones de RA se comunican con los Servicios de Google Play para RA a través del SDK de ARCore. Una app compatible con funciones de RA se puede configurar de dos maneras: se requiere RA y RA opcional. Esta designación determina cómo interactúa la app con los Servicios de Google Play para RA.

Una app requerida RA no puede funcionar sin ARCore. Requiere un dispositivo compatible con ARCore que tenga instalados los Servicios de Google Play para RA.

  • Google Play Store solo pondrá a disposición las apps que requieren RA en los dispositivos que admitan ARCore.
  • Cuando los usuarios instalan una app que requiere RA, Google Play Store instala automáticamente los Servicios de Google Play para RA en sus dispositivos. Sin embargo, tu app igualmente debe realizar verificaciones adicionales del tiempo de ejecución en caso de que los Servicios de Google Play para RA estén desactualizados o se desinstalen manualmente.

Una app opcional de RA usa ARCore para mejorar las funciones existentes. Tiene funciones opcionales de RA que solo se activan en dispositivos compatibles con ARCore que tienen instalados los Servicios de Google Play para RA.

  • Las apps opcionales de RA se pueden instalar y ejecutar en dispositivos que no admiten ARCore.
  • Cuando los usuarios instalan una app opcional de RA, Google Play Store no instalará automáticamente Servicios de Google Play para RA en el dispositivo.
Se requiere RARA opcional
Uso de las funciones de RA Tu app necesita ARCore para tener una funcionalidad básica. ARCore aumenta la funcionalidad de tu app. Tu app puede ejecutarse sin compatibilidad con ARCore.
Visibilidad en Play Store Tu app solo aparece en Play Store para dispositivos compatibles con ARCore. Tu app sigue los procedimientos de enumeración normales.
Método de instalación de los Servicios de Google Play para RA Play Store instala los Servicios de Google Play para RA junto con tu app. Tu app usa la corrutina ARSession.Install() para descargar e instalar ARCore.
Requisitos para Android minSdkVersion Android 7.0 (nivel de API 24) Android 4.4 (nivel de API 19), aunque ejecutar cualquier funcionalidad de RA requiere al menos Android 7.0 (nivel de API 24)
Se debe usar ARSession.state para verificar la compatibilidad de ARCore y el estado de instalación
Se debe usar la corrutina ARSession.Install() para instalar los Servicios de Google Play para RA

Cómo hacer que tu app requiera RA

Android

  1. Navega a Edit > Project Settings > XR Plug-in Management > ARCore. Requirement se configura como Required de forma predeterminada.

  2. Haz clic en Edit > Project Settings > Player y selecciona la pestaña con el ícono de Android.

  3. En Other Settings > Identification, especifica un Minimum API Level que sea 24 o superior.

iOS

  1. Navega a Edit > Project Settings > XR Plug-in Management > ARKit. Requirement se configura como Required de forma predeterminada.

  2. Haz clic en Edit > Project Settings > Player y selecciona la pestaña con el ícono de iOS.

  3. En Other Settings > Configuration, especifica el objeto Target minimum iOS Version de tu app.

Haz que tu app sea opcional

Android

  1. Navega a Edit > Project Settings > XR Plug-in Management > ARCore.

  2. En el menú desplegable Requirement, selecciona Optional para configurar tu app en RA opcional.

  3. Haz clic en Edit > Project Settings > Player y selecciona la pestaña con el ícono de Android.

  4. En Other Settings > Identification, especifica un Minimum API Level que sea 24 o superior.

iOS

  1. Navega a Edit > Project Settings > XR Plug-in Management > ARKit.

  2. En el menú desplegable Requirement, selecciona Optional para configurar tu app en RA opcional.

  3. Haz clic en Edit > Project Settings > Player y selecciona la pestaña con el ícono de iOS.

  4. En Other Settings > Configuration, especifica el objeto Target minimum iOS Version de tu app.

Realiza verificaciones del entorno de ejecución

Verifica si los Servicios de Google Play para RA están instalados

Tanto las apps de RA obligatorias como las de RA deben usar la corrutina ARSession.Install() antes de crear una sesión de ARCore para verificar si todavía está instalada una versión compatible de los Servicios de Google Play para RA y garantizar que se hayan descargado todos los datos de perfil necesarios del dispositivo ARCore.

Durante el tiempo de ejecución, las apps requeridas para RA realizarán automáticamente verificaciones en el tiempo de ejecución para garantizar que el dispositivo de destino haga lo siguiente:

  • Compatible con ARCore
  • Tenga instalada Google Play Services for AR. Si no está instalada (posiblemente porque el usuario la quitó) o la versión es demasiado antigua, tu app le solicitará al usuario que la instale o la actualice.
  • Tiene datos de perfil del dispositivo de ARCore actualizados. Si están desactualizados, tu app descargará datos nuevos.

Establece ARSession.attemptUpdate en false para inhabilitar estas verificaciones predeterminadas. Tu app aún debería controlar estas condiciones:

Condición Acción
El dispositivo no es compatible con ARCore. Oculta funciones relacionadas con la RA.
El dispositivo es compatible con ARCore, pero los datos de perfil del dispositivo de Google Play Services for AR o ARCore no están instalados o están desactualizados. Le solicita al usuario que instale o actualice los datos de perfil de dispositivo de Google Play Services for AR o ARCore mediante una llamada a ARSession.Install().
El dispositivo es compatible con ARCore y Google Play Services for AR, y los datos de perfil de dispositivo de ARCore están instalados y actualizados. Crea un Session de ARCore y comienza a usarlo.

También puedes verificar el ARSession.state para conocer los estados de instalación y compatibilidad.

Cómo satisfacer los requisitos de privacidad del usuario

Para publicar tu app en Play Store, asegúrate de que cumpla con los Requisitos de Privacidad del Usuario de ARCore.

¿Qué sigue?