Comienza a usar las extensiones de ARCore para RA Foundation

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

Requisitos

Si quieres desarrollar con las extensiones de ARCore para AR Foundation, necesitarás lo siguiente:

Android

Hardware

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

Software

iOS

Hardware

Software

Instala el paquete de extensiones de ARCore

Sigue estos pasos para instalar las extensiones de ARCore para AR Foundation.

Dependencias empaquetadas

  1. Asegúrate de tener AR Foundation instalado y configurado en tu entorno de desarrollo.
  2. Abre o crea un proyecto de Unity nuevo.
  3. Selecciona la plataforma de compilación de destino que desees:
    1. En el menú File, selecciona Build Settings.
    2. Selecciona Android o iOS, según la plataforma de segmentación que desees.
    3. Haz clic en Switch Platform.

  4. Importa el paquete de extensiones de ARCore más reciente:

    1. Navega a Window > Package Manager.

    2. Haz clic en el botón y elige la opción Add package from git URL... en el menú desplegable.

    3. Pega la siguiente URL en el campo de texto:

      https://github.com/google-ar/arcore-unity-extensions.git

    4. Haz clic en Add.

Sin EDM4U

De forma predeterminada, las extensiones de ARCore se agrupan con dependencias adicionales. Cuando usas otras bibliotecas (por ejemplo, Firebase Analytics) que dependen de una versión diferente de External Dependency Manager for Unity, es posible que se produzca un comportamiento indefinido que haga que las dependencias dejen de funcionar correctamente.

Instala las extensiones de ARCore sin dependencias empaquetadas para evitar conflictos de control de versiones de bibliotecas:

  1. Descarga la versión de las extensiones de ARCore sin EDM4U y com.google.external-dependency-manager,
  2. Sigue las instrucciones para importar paquetes UPM con archivos .tgz e instalarlos en el siguiente orden:
    1. com.google.external-dependency-manager,
    2. Extensiones de ARCore (sin EDM4U)

Cuando instales ARCore Extensions, Unity también instalará automáticamente una versión adecuada de las dependencias requeridas:

  • AR Foundation
  • ARCore XR Plugin (se usa cuando se orienta a Android)
  • ARKit XR Plugin (se usa cuando se orienta a iOS)

Es posible que estas dependencias no sean visibles en la vista Package Manager > Package: In project. Sin embargo, los paquetes se pueden ver en la ventana Project debajo de Packages.

Configura extensiones de ARCore

AR Foundation 4.x

  1. En el panel de Hierarchy, haz clic con el botón derecho y agrega los siguientes objetos del juego (si aún no los agregaste):

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions

  2. En el panel Hierarchy, selecciona el paquete ARCore Extensions.

  3. En el panel Inspector, para cada uno de los siguientes campos, haz clic en el botón de destino y conecta cada campo con su objeto de juego correspondiente de la siguiente manera:

    • Session: Usa el AR Session de tu escena.
    • AR Session Origin: Usa el AR Session Origin de tu escena.
    • Camera Manager: Usa el AR Camera de tu escena.

  4. De manera opcional, crea y conecta los siguientes elementos para Cloud Anchors y los filtros de configuración de cámara.

    1. En el panel Project > Assets, haz clic con el botón derecho y selecciona Create > XR > ARCore Extensions Config.

    2. En el panel Project > Assets, haz clic con el botón derecho y selecciona Create > XR > Camera Config Filter.

    3. En el panel Hierarchy, selecciona el paquete ARCore Extensions.

    4. En el campo ARCore Extensions Config del panel Inspector, haz clic en el botón de destino y conéctate al recurso ARCoreExtensionsConfig.

    5. En el campo Camera Config Filter del panel Inspector, haz clic en el botón de destino y conéctate al recurso ARCoreExtensionsCameraConfigFilter.

      Para obtener más información, consulta la Guía para desarrolladores de Cloud Anchors y la guía para configurar la cámara.

    6. Si usas una versión de Unity anterior a la 2020.3:

      • Selecciona Custom Gradle Properties Template en Project Settings > Player > Android > Publishing Settings > Build.

Con todos los campos anteriores de las extensiones de ARCore conectados de forma correcta, el panel Inspector de las extensiones de ARCore se ve de la siguiente manera:

AR Foundation 5.x

  1. En el panel de Hierarchy, haz clic con el botón derecho y agrega los siguientes objetos del juego (si aún no los agregaste):

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions

  2. En el panel Hierarchy, selecciona el paquete ARCore Extensions.

  3. En el panel Inspector, para cada uno de los siguientes campos, haz clic en el botón de destino y conecta cada campo con su objeto de juego correspondiente de la siguiente manera:

    • Session: Usa el AR Session de tu escena.
    • XR Origin: Usa el XR Origin de tu escena.
    • Camera Manager: Usa el AR Camera de tu escena.

  4. De manera opcional, crea y conecta los siguientes elementos para Cloud Anchors y los filtros de configuración de cámara.

    1. En el panel Project > Assets, haz clic con el botón derecho y selecciona Create > XR > ARCore Extensions Config.

    2. En el panel Project > Assets, haz clic con el botón derecho y selecciona Create > XR > Camera Config Filter.

    3. En el panel Hierarchy, selecciona el paquete ARCore Extensions.

    4. En el campo ARCore Extensions Config del panel Inspector, haz clic en el botón de destino y conéctate al recurso ARCoreExtensionsConfig.

    5. En el campo Camera Config Filter del panel Inspector, haz clic en el botón de destino y conéctate al recurso ARCoreExtensionsCameraConfigFilter.

      Para obtener más información, consulta la Guía para desarrolladores de Cloud Anchors y la guía para configurar la cámara.

    6. Si usas una versión de Unity anterior a la 2020.3:

      • Selecciona Custom Gradle Properties Template en Project Settings > Player > Android > Publishing Settings > Build.

Con todos los campos anteriores de las extensiones de ARCore conectados de forma correcta, el panel Inspector de las extensiones de ARCore se ve de la siguiente manera:

Si quieres obtener más información para configurar propiedades, consulta la guía de Unity sobre cómo editar propiedades.

Proyectos de muestra

Las extensiones de ARCore para AR Foundation son proyectos de muestra que puedes usar para comenzar a compilar tus propios proyectos.

  1. En el menú Window, abre Package Manager y selecciona el paquete ARCore Extensions.

  2. En Samples, haz clic en Import para acceder al proyecto de muestra, que se describe a continuación.

Los siguientes proyectos de muestra se importan desde el repositorio de GitHub:

  • Geospatial (solo para Android): Crea experiencias de RA a escala global y adjunta contenido de forma remota a cualquier área cubierta por Google Street View. Consulta la Introducción a la API de Geospatial para obtener más información.

  • PersistentCloudAnchors (iOS y Android): Crea experiencias persistentes de RA en el mundo real con capas interactivas de información digital ancladas a ubicaciones reales y diseña experiencias que varias personas puedan compartir con el tiempo en muchos dispositivos diferentes. Consulta la Introducción a Cloud Anchors para obtener más información.

Próximos pasos

Con las extensiones de ARCore para AR Foundation, ahora puedes usar Cloud Anchors y los parámetros de configuración de la cámara en tus apps.