Habilita la API de Geospatial para tu app de Unity (AR Foundation) orientada a Android

Configura la app para que pueda usar la API de Geospatial.

Requisitos previos

Asegúrate de comprender los conceptos fundamentales de RA y cómo configurar una sesión de ARCore antes de continuar.

Consulta la Introducción a la API de Geospatial para obtener más información sobre la API de Geospatial.

Si es la primera vez que desarrollas con ARCore, consulta Primeros pasos para obtener información sobre los requisitos de software y hardware, las necesidades previas y otra información específica de las plataformas que usas.

Para usar la API de ARCore Geospatial, tu proyecto debe ser compatible con AR Foundation y ARCore Extensions para AR Foundation.

Habilita la API de ARCore

Antes de usar el sistema de posicionamiento visual (VPS) en tu app, primero debes habilitar la API de ARCore en un proyecto de Google Cloud nuevo o existente. Este servicio es responsable de alojar, almacenar y resolver las anclas geoespaciales.

Se prefiere la autorización sin llave, pero también se admite la autorización de la clave de API.

Agrega las bibliotecas necesarias a tu app

Después de autorizar tu app para que llame a la API de ARCore, debes agregar bibliotecas para habilitar las funciones geoespaciales en tu app.

  1. Navega a Edit > Project Settings > XR Plug-In Management > ARCore Extensions.
  2. En Componentes opcionales, selecciona Geoespacial.

Habilita las capacidades geoespaciales en la configuración de la sesión

Una vez que se habilite la funcionalidad geoespacial en tu app, habilita las capacidades geoespaciales en la configuración de la sesión de RA de la app para que pueda comunicarse con la API de ARCore:

  1. Asegúrate de que la carpeta Recursos del proyecto contenga un objeto ARCoreExtensionsConfig programable. Para crear una, haz clic con el botón derecho en el panel Recursos y selecciona Crear > XR > Configuración de extensiones de ARCore.

  2. Selecciona el objeto de secuencia de comandos ARCoreExtensionsConfig en la carpeta Assets y establece el modo geoespacial en Habilitado.

  3. Configura el objeto de juego ARCore Extensions para usar la configuración de ARCoreExtensionsConfig. En el panel Hierarchy, busca el objeto de juego ARCore Extensions que creaste cuando configuraste las extensiones de ARCore inicialmente y conecta el campo ARCore Extensions Config al objeto con secuencias de comandos ARCoreExtensionsConfig en tu carpeta Assets.

Solicita al usuario que permita el uso de los datos del dispositivo

Las apps que usan la API de ARCore Geospatial deben presentarle al usuario un mensaje para que acepte y permita el uso de los datos de su dispositivo. Consulta los requisitos de privacidad del usuario para obtener más información.

Cómo verificar la compatibilidad del dispositivo

No todos los dispositivos compatibles con ARCore también admiten la API de Geospatial. Para verificar la compatibilidad del dispositivo del usuario, llama a AREarthManager.IsGeospatialModeSupported(). Si se muestra FeatureSupported.Unsupported, no intentes configurar la sesión.

Solicita permisos de ubicación al usuario durante el tiempo de ejecución

Las extensiones de ARCore solicitan automáticamente los permisos de ubicación adecuados cuando el modo geoespacial está habilitado en ARCoreExtensions.Update(). Si el usuario no otorga permiso de ubicación precisa, la sesión no se reanuda y se produce un error de "permiso no otorgado". Este es un error de finalización y requiere un reinicio para volver a activar la solicitud de permiso.

Comprueba la disponibilidad de datos geoespaciales en la ubicación actual del dispositivo

Debido a que la API de Geospatial usa una combinación de VPS y GPS para determinar una pose geoespacial, la API se puede usar siempre y cuando el dispositivo pueda determinar su ubicación. En áreas con baja precisión del GPS, como espacios interiores y entornos urbanos densos, la API utilizará la cobertura del VPS para generar poses de alta precisión. En condiciones típicas, se espera que la VPS proporcione una precisión de posición de aproximadamente 5 metros y una precisión de rotación de 5 grados. Usa AREarthManager.CheckVpsAvailability() para determinar si una ubicación determinada tiene cobertura de VPS.

La API de Geospatial también se puede usar en áreas que no tienen cobertura de VPS. En entornos exteriores con pocas obstrucciones en el techo o sin ellas, es posible que el GPS sea suficiente para generar una pose con alta precisión.

¿Qué sigue?