Comienza a usar AR Foundation

AR Foundation de Unity es un framework multiplataforma que te permite escribir experiencias de realidad aumentada una vez y, luego, compilar para dispositivos Android o iOS sin hacer ningún cambio adicional. El framework está disponible a través del paquete AR Foundation de Unity.

El paquete opcional Extensiones de ARCore para RA Foundation de ARCore agrega funcionalidad adicional, lo que te permite usar funciones como Cloud Anchors, filtros de configuración de cámara y grabación y reproducción a tu app.

Migra o actualiza proyectos existentes

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

Requisitos

Según la plataforma que uses, 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 la base de RA

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

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

  2. Navega a Window > Package Manager.

  3. Junto a Packages, selecciona Unity Registry.

  4. En la barra de búsqueda, escribe "AR Foundation".

  5. Haz clic en Install.

Instala y habilita paquetes de complementos específicos de la plataforma

El paquete AR Foundation presenta una interfaz para que la usen los desarrolladores de Unity, pero no implementa ninguna función de RA por sí mismo. Para usar AR Foundation en un dispositivo de destino, también deberás instalar paquetes independientes 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 instalarla en tu proyecto de Unity si tu aplicación está orientada a dispositivos Android. Usa la misma versión que el paquete de AR Foundation 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.

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

iOS

El complemento de ARKit XR te permite compilar apps de realidad aumentada para dispositivos iOS. Sigue estos pasos para instalarla en tu proyecto de Unity si tu aplicación está orientada a dispositivos iOS. Usa la misma versión que el paquete de AR Foundation 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.

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

Configura una sesión de RA y agrega componentes de Base de RA a tu escena

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

AR Foundation 4.x

  • 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 nuevos objetos del juego de RA a tu escena: haz clic con el botón derecho en el panel Hierarchy y selecciona XR. Agrega un nuevo AR Session y un nuevo objeto de juego AR Session Origin.

AR Foundation 5.x

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

  • XR 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 XR Origin.

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

Configura el reproductor

Android

  1. Navega a File > Build Settings para abrir la ventana de Build Settings.
  2. En Platform, elige Android y haz clic en Switch Platform.
  3. Haz clic en Player Settings.
  4. Aplica los siguientes cambios:

    Player Settings > … Valor
    Other Settings > Rendering Desmarca Auto Graphics API.
    Si Vulkan aparece en Graphics APIs, quítalo, ya que Vulkan aún no es compatible con ARCore.
    Other Settings > Package Name Crea un ID de app único con un formato de nombre de paquete de Java.
    Por ejemplo, usa com.example.helloAR.
    Other Settings > Minimum API Level Si estás compilando una app que requiere RA, especifica Android 7.0 'Nougat' (API Level 24) or higher.
    Si estás compilando una app opcional de 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)
    • Instala un APK de ARCore FAT (32 y 64 bits)

    Cuando realices envíos a Play Store, ten en cuenta lo siguiente:

    • Usa IL2CPP
    • Habilita 32 bits (ARMv7) y 64 bits (ARM64) para cumplir con los requisitos de 64 bits de Play Store.
    • Opcional (compatible con 2018.3 y versiones posteriores): 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 de Build Settings.
  2. En Platform, elige iOS y haz clic en Switch Platform.
  3. Haz clic en Player Settings.
  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 el uso que haces de la RA (por ejemplo, ARKit).
    Other Settings > Target minimum iOS version 11.0 o más
    Other Settings > Architecture ARM64

Próximos pasos