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 admita RA o sea 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 Opcional. Esta designación determina la forma en que la app interactúa con los Servicios de Google Play para RA.

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

  • Google Play Store solo permitirá que las apps requeridas para RA estén disponibles en dispositivos compatibles con 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 debe realizar verificaciones de tiempo de ejecución adicionales en caso de que los Servicios de Google Play para RA estén desactualizados o se hayan desinstalado 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 los Servicios de Google Play para RA en el dispositivo.
Se requiere RARA (opcional)
Uso de 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 de Play Store Tu app solo aparecerá en Play Store para dispositivos compatibles con ARCore. Tu app sigue los procedimientos habituales de publicación.
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 ARSession.state 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).
Debes usar ARSession.state para verificar la compatibilidad con ARCore y el estado de instalación

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 una 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 Target minimum iOS Version de tu app.

Cómo hacer que la RA de 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 una 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 Target minimum iOS Version de tu app.

Realiza verificaciones en el tiempo de ejecución

Verifica si se instalaron Servicios de Google Play para RA

Tanto las apps obligatorias como las opcionales deben llamar a ARSession.state antes de crear una sesión de ARCore para verificar si está instalada una versión compatible de los Servicios de Google Play para RA y asegurarte de que se hayan descargado todos los datos necesarios del perfil del dispositivo ARCore.

Durante el tiempo de ejecución, las apps requeridas con 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 la versión 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.
  • Tienen datos actualizados del perfil del dispositivo ARCore. Si están desactualizados, tu app descargará datos nuevos.

Establece ARSession.attemptUpdate en false para inhabilitar estas verificaciones predeterminadas. Tu app debe controlar las siguientes condiciones:

Condición Acción
El dispositivo no es compatible con ARCore. Oculta la funcionalidad relacionada 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 desactualizados. Le solicita al usuario que instale o actualice Google Play Services for AR o los datos del perfil del dispositivo ARCore llamando a ARSession.Install().
El dispositivo es compatible con ARCore y Google Play Services for AR, y los datos de perfil del dispositivo ARCore están instalados y actualizados. Crea un Session de ARCore y comienza a usarlo.

También puedes consultar la ARSession.state para ver los estados de instalación y compatibilidad.

Cumple con 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?