Comienza a usar AR Foundation

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

ARCore opcional Extensiones de ARCore para Bases de RA agrega funciones adicionales, lo que te permite usar funciones como Cloud Anchors, los filtros de configuración de la cámara y las funciones de grabación y reproducción en tus .

Cómo migrar o actualizar proyectos existentes

  • Migrar un proyecto existente del SDK de ARCore para Unity (obsoleto) a AR Foundation de Unity y, opcionalmente, a Extensiones de ARCore, consulta la guía de migración.
  • Para actualizar un proyecto existente desde una versión anterior de AR Foundation, sigue estos pasos: consulta guías de actualización y migración.

Requisitos

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

Android

Hardware

  • Un dispositivo Android compatible con ARCore emulador
  • 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 AR Foundation de Unity.

  1. Abre un proyecto de Unity existente 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 de AR Foundation presenta una interfaz para que la usen los desarrolladores de Unity, pero no implementa ninguna función de RA por sí misma. Cómo usar AR Foundation en un destino también deberás instalar paquetes separados y habilitar la el complemento correspondiente a cada plataforma.

Android

El complemento de ARCore XR te permite crear apps de realidad aumentada para dispositivos Android. Sigue estos pasos para instalarla en tu proyecto de Unity si la app se orienta 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 crear apps de realidad aumentada para dispositivos iOS. Sigue estos pasos para instalarla en tu proyecto de Unity si la app se orienta a dispositivos iOS. Usa la misma versión que el paquete de AR Foundation para hacer lo siguiente: 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 AR Foundation 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 medioambiente y la estimación de la iluminación. Para admitir una sesión de RA, necesitarás los siguientes objetos del juego:

AR Foundation 4.x

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

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

Antes de agregar los nuevos objetos de juego, borra el Main Camera predeterminado. Se reemplazará por un nuevo AR Camera en el 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 AR Session y una AR Session Origin objeto de juego.

AR Foundation 5.x

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

  • XR Origin: Transforma coordenadas de RA en Unity coordenadas mundiales.

Antes de agregar los nuevos objetos de juego, borra el Main Camera predeterminado. Se reemplazará por un nuevo AR Camera en el 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 AR Session y una XR Origin objeto de juego.

Configurar el reproductor

Android

  1. Navega a File > Build Settings para abrir Build Settings en la ventana modal.
  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 con el estado RA requerida, 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:

    • Usar Mono + 32 bits (ARMv7)
    • Instala un APK de ARCore (32 y 64 bits) de FAT

    Cuando realices 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 (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, haz lo siguiente: habilitar ARM64 (ARM de 64 bits). Deja ARMv7 (ARM de 32 bits) habilitado para admitir dispositivos de 32 bits.

iOS

  1. Navega a File > Build Settings para abrir Build Settings en la ventana modal.
  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 cómo usas la RA (por ejemplo, ARKit).
    Other Settings > Target minimum iOS version 11.0 o más
    Other Settings > Architecture ARM64

¿Qué sigue?