Habilitar soporte para auriculares en proyectos EasyAR
Este documento explica cómo habilitar soporte para auriculares en una escena de Unity con EasyAR existente.
Antes de comenzar
- Lee Soporte para auriculares en EasyAR para conocer los tipos de auriculares compatibles con EasyAR y las funciones que pueden ejecutarse en ellos.
- Lee Soporte para auriculares de EasyAR en Unity para comprender la arquitectura general del soporte para auriculares en Unity.
Este artículo asume que ya tienes una escena funcional con EasyAR. Si necesitas crear dicha escena o agregar componentes de EasyAR a una escena para auriculares, consulta:
Agregar componentes de auriculares a la escena
Antes de agregar componentes de auriculares, generalmente necesitas eliminar la cámara y el XR Origin existentes.
Eliminar la cámara y XR Origin
Elimina la cámara existente en la escena.

Si ya existe un XR Origin en la escena, ya sea de EasyAR o del marco XR de Unity, en la mayoría de los casos debes eliminarlo.

Consejo
En usos avanzados, puedes decidir si eliminarlo según tus necesidades.
Agregar componentes de auriculares
Sigue las instrucciones oficiales del auricular para agregar sus componentes. Aquí se usa el auricular Pico como ejemplo; en caso de conflicto con las instrucciones oficiales, prevalece lo oficial.
Usa el menú para agregar un XR Interaction Manager:

Usa el menú para agregar un XR Origin:

Antes de ejecutar, asegúrate de leer las instrucciones oficiales del auricular para comprender cómo se debe configurar y ejecutar una escena con SDK de auriculares.
Configurar frame source
Dispositivos con soporte integrado
Selecciona AR Session (EasyAR), haz clic derecho y crea el frame source de [Nombre] manteniendo solo ese mediante el menú EasyAR Sense > Head-Mounted Display (Built-in) > Frame Source : [Name] (keep it only).
Por ejemplo, para configurar el frame source para Apple Vision Pro:

Después de la operación, el frame source en la sesión se verá así:

Consejo
Si la sesión contiene el frame source correspondiente al dispositivo y es el primer frame source disponible en el dispositivo (por ejemplo, en el sistema visionOS, VisionOS ARKit es el primer frame source disponible), no es necesario modificarlo. Algunas sesiones creadas por defecto desde el menú entran en este caso.
Dispositivos con soporte extendido
Selecciona AR Session (EasyAR), haz clic derecho y crea el frame source de [Nombre] manteniendo solo ese mediante el menú EasyAR Sense > Extensions > Frame Source : [Name] (keep it only).
Por ejemplo, para configurar el frame source para auriculares Pico:

Después de la operación, el frame source en la sesión se verá así:

Soporte multiplataforma
Si necesitas que la escena se ejecute en diferentes dispositivos, debes mantener otros frame sources y asegurarte de que el frame source actual del dispositivo pueda seleccionarse.
Usa elementos de menú sin (keep it only) para agregar solo el frame source sin eliminar otros. Por ejemplo, EasyAR Sense > Extensions > Frame Source : Pico creará un frame source para Pico al final de todos los frame sources de la sesión. Generalmente, después de agregar el frame source de esta manera, también debes moverlo a la posición adecuada.
Consejo
En usos avanzados, puedes ajustar la posición del frame source según tus necesidades o modificarla mediante código.
Pasos siguientes
- Configuración del proyecto para Vision Pro
- Configuración del proyecto para XREAL
- Configuración del proyecto para otros dispositivos Android