Comienza a usar RA Foundation

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

La base de RA de Unity es un marco de trabajo multiplataforma que te permite escribir experiencias de realidad aumentada una vez y, luego, compilarlas 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 Extensiones de ARCore para RA 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 en tu app.

Migra o actualiza proyectos existentes

  • Para migrar un proyecto existente del SDK de ARCore (obsoleto) de Unity a AR Foundation de Unity y, de manera opcional, Extensiones de ARCore, consulta la guía de migración.
  • Para actualizar un proyecto existente desde una versión anterior de RA 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 RA 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 "RA Foundation".

  5. Haz clic en Install.

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

El paquete de RA presenta una interfaz para que usen los desarrolladores de Unity, pero no implementa ninguna función de RA. Para usar la RA de fundación 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 AR Foundation para evitar problemas de compatibilidad.

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

  2. Junto a Packages, selecciona Unity Registry.

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

  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 ARKit 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 Fundamentos de RA para evitar problemas de compatibilidad.

  1. En tu proyecto, navega a 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 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 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 nuevos objetos del juego, 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 la 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.

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.
  4. Aplica los siguientes cambios:

    Player Settings > … Valor
    Other Settings > Rendering Desmarca Auto Graphics API.
    Si Vulkan aparece en Graphics APIs, quítala, 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 compilas una app que requiere 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 la compatibilidad con ARM64 se habilite en el siguiente paso.

    Durante el desarrollo:

    • Usar Mono + 32 bits (ARMv7)
    • Cómo instalar un APK de ARCore FAT (32 bits + 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+): 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.
  4. Establece la siguiente configuración:

    Player Settings > … Valor
    Other Settings > Bundle Identifier Agrega el nombre de la 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

¿Qué sigue?