Comienza a usar AR Foundation

La base de RA de Unity es un marco de trabajo multiplataforma que te permite escribir experiencias de realidad aumentada una vez y, luego, realizar compilaciones para dispositivos Android o iOS sin hacer cambios adicionales. El marco de trabajo está disponible a través del paquete AR Foundation de Unity.

El paquete opcional de las extensiones de ARCore para AR Foundation de ARCore agrega funciones adicionales, lo que te permite usar funciones como Cloud Anchors, filtros de configuración de cámara y grabación y reproducción en tu app.

Migra o actualiza proyectos existentes

  • Para migrar un proyecto existente del SDK de ARCore (obsoleto) (Unity) a Unity AR Foundation y, de manera opcional, ARCore Extensions, consulta la guía de migración.
  • Para actualizar un proyecto existente desde una versión anterior de AR Foundation, consulta las guías de actualización y migración de Unity.

Requisitos

Según la plataforma de destino, el paquete AR Foundation requiere lo siguiente:

Android

Hardware

  • Un emulador o dispositivo Android compatible con ARCore
  • Un cable USB para conectar el dispositivo a la máquina de desarrollo

Software

iOS

Hardware

Software

Instala AR Foundation

Sigue estos pasos para instalar el paquete de Unity AR Foundation.

  1. Abre un proyecto de Unity existente o crea uno nuevo.

  2. Navega a Window > Package Manager.

  3. Junto a Packages, selecciona Unity Registry.

  4. En la barra de búsqueda, escribe "Fundamentos de RA".

  5. Haz clic en Install (Aceptar).

Cómo instalar y habilitar paquetes de complementos específicos de la plataforma

El paquete de AR Foundation presenta una interfaz para que usen los desarrolladores de Unity, pero no implementa ninguna función de RA. Para usar AR Foundation en un dispositivo de destino, también deberás instalar paquetes separados y habilitar el complemento correspondiente para cada plataforma respectiva.

Android

El paquete del complemento de ARCore XR te permite compilar apps de realidad aumentada para dispositivos Android. Sigue estos pasos para instalarlo en tu proyecto de Unity si tu aplicación está orientada a dispositivos Android. Usa la misma versión que el paquete de la base de RA para evitar problemas de compatibilidad.

  1. En tu proyecto, navega hasta Window > Package Manager.

  2. Junto a Packages, selecciona Unity Registry.

  3. En la barra de búsqueda, escribe "ARCore XR plugin".

  4. Haz clic en Install (Aceptar).

  5. Navega a Edit > Project Settings. En XR Plug-in Management, abre la pestaña Android y habilita ARCore.

iOS

El complemento XAR XR te permite compilar apps de realidad aumentada para dispositivos iOS. Sigue estos pasos para instalarlo en tu proyecto de Unity si tu aplicación está orientada a dispositivos iOS. Usa la misma versión que el paquete de la base de RA para evitar problemas de compatibilidad.

  1. En tu proyecto, navega hasta Window > Package Manager.

  2. Junto a Packages, selecciona Unity Registry.

  3. En la barra de búsqueda, escribe "ARKit XR plugin".

  4. Haz clic en Install (Aceptar).

  5. Navega a Edit > Project Settings. En XR Plug-in Management, abre la pestaña iOS y habilita ARKit.

Cómo configurar una sesión de RA y agregar componentes de RA de fundación a tu escena

Una escena necesita una sesión de RA para habilitar procesos de RA, como el seguimiento de movimiento, la comprensión del entorno y la estimación de iluminación. Necesitarás los siguientes objetos de juego para admitir una sesión de RA:

  • AR Session: Controla el ciclo de vida de una experiencia de RA.

  • AR Session Origin: Transforma las coordenadas de RA en coordenadas mundiales de Unity.

Antes de agregar los objetos de juego nuevos, borra el Main Camera predeterminado. Se reemplazará por un AR Camera nuevo en AR Session Origin.

Agrega los objetos de juego de RA nuevos a tu escena: haz clic con el botón derecho en el panel Hierarchy y selecciona XR. Agrega un AR Session nuevo y un nuevo objeto de juego AR Session Origin.

Configurar el reproductor

Android

  1. Navega a File > Build Settings para abrir la ventana Build Settings.
  2. En Platform, elige Android y haz clic en Switch Platform.
  3. Haz clic en Player Settings (Aceptar).

  4. Aplica los siguientes cambios:

    Player Settings > … Valor
    Other Settings > Rendering Desmarca Auto Graphics API.
    Si Vulkan aparece en Graphics APIs, quítalo porque ARCore todavía no admite Vulkan.
    Other Settings > Package Name Crea un ID único de la app con un formato de nombre de paquete de Java.
    Por ejemplo, usa com.example.helloAR.
    Other Settings > Minimum API Level Si compilas una app que se requiere de RA, especifica Android 7.0 'Nougat' (API Level 24) or higher.
    Si compilas una app Opcional para RA, especifica Android API Level 19 or higher.
    Other Settings > Scripting Backend Selecciona IL2CPP en lugar de Mono para permitir que se habilite la compatibilidad con ARM64 en el siguiente paso.

    Durante el desarrollo:

    • Usa Mono + 32 bits (ARMv7)
    • Cómo instalar un APK de ARCore de FAT (32 bits y 64 bits)

    Al realizar envíos a Play Store:

    • Usa IL2CPP
    • Habilita 32 bits (ARMv7) y 64 bits (ARM64) para cumplir con los requisitos de 64 bits de Play Store
    • Opcional (se admite en más de 2018.3): En Build Settings, habilita Android App Bundles
    Other Settings > Target Architectures Para cumplir con el requisito de 64 bits de Google Play, habilita ARM64 (ARM de 64 bits). Deja habilitado ARMv7 (ARM de 32 bits) para admitir dispositivos de 32 bits.

iOS

  1. Navega a File > Build Settings para abrir la ventana Build Settings.
  2. En Platform, elige iOS y haz clic en Switch Platform.
  3. Haz clic en Player Settings (Aceptar).

  4. Establece la siguiente configuración:

    Player Settings > … Valor
    Other Settings > Bundle Identifier Agrega el nombre de tu app en un formato de DNS inverso.
    Por ejemplo, usa com.mycompany.myapp.
    Other Settings > Camera usage description Ingresa una descripción para explicar tu uso de la RA (por ejemplo, ARKit).
    Other Settings > Target minimum iOS version 11.0 o más
    Other Settings > Architecture ARM64

Próximos pasos