Comienza a usar el marco de interacción de Android XR para Unity

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Más información sobre los tipos de dispositivos de realidad extendida →
Visores de realidad extendida
Lentes de realidad extendida con cable
Más información sobre los tipos de dispositivos de realidad extendida →

El Framework de interacción de Android XR (AXRIF) proporciona interacciones familiares, de alto nivel, con opiniones para aplicaciones de OpenXR en Android XR. AXRIF cierra la brecha entre las interacciones a nivel del sistema y las interacciones en la app, y ofrece una forma intuitiva y cohesiva de controlar la entrada del usuario.

Sigue esta guía para configurar AXRIF y comenzar a usarlo con Unity.

Requisitos previos

Antes de comenzar, asegúrate de que tu entorno de desarrollo cumpla con los siguientes requisitos:

Configura Unity

Antes de probar la escena de muestra, debes configurar Unity para AXRIF. Sigue los pasos de las siguientes secciones para completar este proceso.

Importa el paquete AXRIF

Primero, instala el paquete AXRIF y sus dependencias:

  1. Navega a Window > Package Manager.
  2. Abre el menú de agregar en la barra de herramientas del Administrador de paquetes.
  3. En las opciones para agregar paquetes, haz clic en + (más).

  4. En el menú desplegable, selecciona Install package from git URL.

    Importa el paquete de AXRIF con su URL de Git.

  5. Ingresa la siguiente URL:

    https://github.com/android-xr/android-xr-interaction-framework-unity-package.git

  6. Haz clic en Instalar.

    Detalles del paquete de AXRIF en Unity Package Manager.

Verifica la versión del kit de herramientas de interacción de XR

El paquete AXRIF funciona junto con el kit de herramientas de interacción de XR (XRIT) de Unity y no lo reemplaza. Debido a que el paquete AXRIF define una dependencia de XRIT, Unity debería haber instalado XRIT cuando instalaste el paquete AXRIF en los pasos anteriores. Sin embargo, debes verificar que la versión 3.3.1 o posterior esté instalada. Para ello, navega a Window > Package Manager > Unity Registry > XR Interaction Toolkit en el editor de Unity.

Figura 1. Verifica la versión instalada del kit de herramientas de interacción de XR en el editor de Unity.

Selecciona el perfil de compilación de Android XR

Selecciona el perfil de compilación de Android XR para habilitar las extensiones de OpenXR y la configuración de compilación adecuadas para Android XR:

  1. Navega a File > Build Profiles.

  2. Haz clic en Android XR y, luego, en Switch Platform.

    Selecciona el perfil de compilación de Android XR en la configuración de Unity.

Configura los parámetros de OpenXR

Configura los parámetros de OpenXR de Unity para que Unity pueda acceder a los datos de OpenXR necesarios:

  1. Navega a Edit > Project Settings > XR Plug-in Management > OpenXR.
  2. En la pestaña Android, haz clic en + (más) para la sección Enabled Interaction Profiles.

  3. Agrega cualquiera de los siguientes perfiles, según las necesidades de tu app:

    • Eye Gaze Interaction Profile
    • Hand Interaction Profile
    • Oculus Touch Controller Profile
    • Android XR Mouse Interaction Profile

  4. En la lista de funciones de XR Plug-in Management > OpenXR, habilita las siguientes funciones:

    • Android XR (Extensions): Passthrough Composition Layer
    • Android XR (Extensions): Session Management
    • Android XR Support
    • Android XR: AR Camera
    • Android XR: AR Session
    • Android XR: AR Hand Mesh Data
    • Composition Layers Support
    • Hand Tracking Subsystem

Realiza la validación del proyecto

Realiza la validación del proyecto para corregir cualquier error de OpenXR en la configuración de tu proyecto:

  1. Navega a Edit > Project Settings > XR Plug-in Management > Project Validation.

  2. Corrige las alertas o advertencias pendientes para asegurarte de que los errores de tiempo de ejecución no afecten la compilación.

    Realiza la validación del proyecto para resolver los problemas pendientes de OpenXR.

Usa la escena de muestra

Ahora que terminaste la configuración preliminar, puedes usar la escena de muestra de AXRIF. Sigue los pasos de las siguientes secciones para obtener la escena de muestra y probarla.

Importa los paquetes de muestra de XRIT y la muestra de AXRIF

La escena de muestra de AXRIF depende de los paquetes de muestra de Hands Interaction Demo y Starter Assets del kit de herramientas de interacción de XR (XRIT) de Unity.

Importa los paquetes de muestra de XRIT

Importa los paquetes de muestra de XRIT de los que depende la muestra de AXRIF:

  1. Navega a Window > Package Manager.
  2. Selecciona XR Interaction Toolkit de la lista de paquetes.

  3. En la pestaña Samples, haz clic en Import junto a Starter Assets y Hands Interaction Demo.

    Importa los paquetes de muestra de XRIT necesarios antes de importar el paquete de muestra de AXRIF.

Importa la muestra de AXRIF

Importa la muestra de AXRIF para obtener la escena de muestra:

  1. Navega a Window > Package Manager.
  2. Selecciona Android XR Interaction Framework de la lista de paquetes.

  3. En la pestaña Samples, haz clic en Import junto a Axrif Sample.

    Importa la muestra de AXRIF en el administrador de paquetes de Unity.

Abre la escena

Después de importar los paquetes de muestra necesarios, puedes abrir la escena:

  1. Navega a Assets > Samples > Android XR Interaction Framework > [AXRIF Version Number] > Axrif Sample.

  2. Abre AxrifDemoScene.

    Importa el paquete de muestra de AXRIF en el administrador de paquetes de Unity.

Explora los prefabs

La escena viene preconfigurada con prefabs modulares ubicados en Packages > Android XR Interaction Framework > Prefabs.

Prefabs de Interactor

Los prefabs de Axrif Interactor controlan la mecánica del interactor de XRIT de Unity con las modalidades de entrada correspondientes de la siguiente lista:

  • Hand/Controller Ray:
    • Axrif Left Interactor: Usa el raycast o el controlador de la mano izquierda.
    • Axrif Right Interactor: Usa el raycast o el controlador de la mano derecha.
  • Gaze Pinch:
    • Axrif Left GazePinch Interactor: Usa la mirada y el movimiento de la mano izquierda cuando pellizcas.
    • Axrif Right GazePinch Interactor: Usa la mirada y el movimiento de la mano derecha cuando pellizcas.
    • Axrif Gaze Interactor: Usa la mirada solo para apuntar.
  • Hand Poke:
    • Axrif Left Poke Interactor: Usa el dedo índice izquierdo cuando tocas elementos interactivos.
    • Axrif Right Poke Interactor: Usa el dedo índice derecho cuando tocas elementos interactivos.
  • Mouse:
    • Axrif Mouse Interactor: Usa el mouse espacial de Android XR.

Prefabs de Axrif Interaction Manager y Origin

  • Axrif Interaction Manager: Este prefab es el centro de AXRIF en la escena. El prefab aloja el componente Axrif Interaction Manager, que está diseñado para funcionar junto con el XR Interaction Manager de XRIT. Este prefab es responsable de lo siguiente:

    • Inicializar y administrar los subsistemas principales de AXRIF en el tiempo de ejecución
    • Procesar y enrutar datos de entrada desde OpenXR con el adaptador de entrada del framework de interacción
    • Observar los estados de la IU y del colisionador con el integrador de escenas del framework de interacción

  • Axrif XR Origin: Funciona como el personaje principal y el controlador de la cámara, y administra los visualizadores de malla de la mano.

Configura las acciones de entrada

Para conectar los datos de tiempo de ejecución de OpenXR con las acciones de entrada de Unity, registra las vinculaciones de mapas en todo el proyecto:

  1. Navega a Packages > Android XR Interaction Framework > InputActions.
  2. Busca AndroidXRInteractionFramework Input Actions.

  3. Haz clic en Assign as the Project-wide Input Actions.

    Configura las acciones de entrada para que Unity conecte los datos de tiempo de ejecución con las acciones de entrada de Unity.

Modifica las interacciones

Con el prefab de Axrif Interaction Manager, puedes habilitar o inhabilitar diferentes modalidades de entrada. AXRIF admite las siguientes modalidades de entrada:

  • Controller Raycasting
  • Pinch and Gaze
  • Hand Raycasting
  • Direct Hand
  • Mouse Interactions

Puedes configurar las modalidades de entrada directamente dentro del Inspector en la sección Configurations del componente Interaction Framework Manager.

Figura 2: Configura las modalidades de entrada dentro del Inspector.

Compila la muestra

Cuando quieras compilar la muestra, haz clic en Build o Build and Run en el editor de Unity.