Table of Contents

Usar muestras de EasyAR en auriculares o gafas XR

EasyAR proporciona muestras unificadas para todos los auriculares, sin código en las muestras, todas implementadas mediante configuraciones en la escena. El uso de las funciones en sí se puede consultar en las implementaciones de muestras correspondientes en teléfonos Android/iOS.

El nombre de la muestra para auriculares es Combination_BasedOn_*, por ejemplo, la muestra para Pico es Combination_BasedOn_Pico. Esta muestra demuestra la mayoría de las funciones de EasyAR en una sola escena, que se pueden activar/desactivar dinámicamente, usar individualmente o abrir simultáneamente.

Preparación

  • Asegúrese de que sus auriculares o gafas estén actualmente en la lista de compatibilidad de EasyAR
  • Descargue e importe el paquete de complementos de EasyAR Unity
  • Descargue e importe el paquete de extensión de dispositivos XR de EasyAR Unity
  • Obtenga una licencia de EasyAR adecuada para auriculares o gafas XR. Los tipos de licencia disponibles para auriculares o gafas incluyen:
    • EasyAR Sense 4.x XR License de prueba (prueba, activada de forma independiente en el sitio web de EasyAR)
    • EasyAR Sense 4.x XR License oficial (de pago, póngase en contacto con ventas para comprar y activar)
    • EasyAR Sense 4.x XR License empresarial (para usar con SDK empresarial)
Precaución

En auriculares y gafas solo se permite usar XR License. Las licencias ordinarias no pueden utilizar las funciones de EasyAR.

Importar muestras oficiales

  1. Las muestras para dispositivos compatibles integrados se encuentran en el paquete de complementos de EasyAR Unity. Importe las muestras necesarias según el dispositivo. xr-samples-location

  2. Las muestras para dispositivos compatibles mediante extensiones se distribuyen junto con la extensión del auricular correspondiente. Puede usar Unity para importar las muestras al proyecto. Tomando Pico como ejemplo. xr-pico-extension

Empaquetar y ejecutar muestras

Complete la configuración del proyecto del auricular y las instrucciones de uso de la muestra por separado.

  • Consulte estrictamente la documentación y las instrucciones oficiales del auricular correspondiente para realizar la configuración adecuada. La documentación de EasyAR no cubrirá este contenido.

  • Configure según las instrucciones de cada plataforma en la documentación de EasyAR.

    Android: consulte Configuración del proyecto Android

    visionOS: consulte Configuración del proyecto visionOS

    XREAL, además de configurar según la plataforma Android, requiere adicionalmente Configuración del proyecto XREAL

  • Empaquetado de muestras Empaquete y use las muestras en Unity, e impleméntelas en el dispositivo para ejecutarlas. Para métodos específicos, consulte Ejecutar muestras en Unity.

Instrucciones de uso

La muestra tiene varios botones integrados, cuyas funciones específicas son las siguientes. xr-sample-usage-7

  • Botón 1 HUD: alterna el modo de visualización de la UI. En el estado inicial, la UI se fija en el mundo real; después de abrir HUD, la UI siempre se mostrará frente a los ojos.
  • Botón 2 Record: activa/desactiva la grabación EIF. Después de activarse, debe cerrarse para grabar un archivo EIF normal; de lo contrario, el archivo grabado no podrá usarse.
  • Botón 3 Image: activa/desactiva el seguimiento de imágenes.
  • Botón 4 Image Fusion: activa/desactiva el modo de seguimiento de imágenes + fusión de movimiento.
  • Botón 5 Dense: activa/desactiva el mapeo espacial denso.
  • Botón 6 Sparse: activa/desactiva el mapeo espacial disperso.
  • Botón 7 Mega: activa/desactiva Mega.

Explicación detallada de funciones

  • Activación/desactivación predeterminada de funciones

    Todas las funciones están desactivadas de forma predeterminada al iniciar, lo que se logra deshabilitando el script correspondiente en el editor. La operación de los botones activa/desactiva los scripts correspondientes. Puede configurar las funciones activadas de forma predeterminada según la muestra que desee ejecutar.

    hmd-default-disable

  • Referencia del origen del sistema de coordenadas

    En la muestra, se coloca un modelo estático de panda en el origen del sistema de coordenadas de seguimiento de movimiento para verificar el estado del seguimiento de movimiento. Este modelo es útil para resolver problemas de desacoplamiento. Por ejemplo, al ejecutar Mega, algunos desplazamientos rápidos son causados por el seguimiento de movimiento del dispositivo (es decir, defectos del propio dispositivo). En este caso, este modelo también se desplazará. Puede ajustar o eliminar este modelo de panda según sea necesario.

  • Usar imágenes de seguimiento integradas

    • La muestra preconfigura el tamaño de la imagen utilizada para el seguimiento de imágenes planas. Debe imprimir namecard.jpg en papel A4, manteniendo la proporción de la imagen sin estirar, sin recortar, y llenando la hoja lo más posible (imagen a continuación). namecard

    • Mida la longitud del patrón de tarjeta de visita en el papel impreso. Según el resultado de la medición, debe establecer la Scale de Image Target en la escena de Unity coherente con el tamaño físico real (la unidad es metros). set-the-actual-size

    • Cuando EasyAR fusión de movimiento está activado, solo se pueden rastrear imágenes en ubicaciones fijas (no móviles). Si la fusión de movimiento está desactivada, no se podrá rastrear la imagen cuando esté fuera del campo de visión.

    • A veces, la perspectiva de las gafas no puede reflejar bien el tamaño de la imagen de la cámara. Si no se reconoce, intente acercar la cámara de las gafas a la imagen. Para uso real, se recomienda rastrear imágenes más grandes, por ejemplo, de 5m*5m.

Nota

En auriculares, independientemente de si la función de fusión de movimiento de EasyAR está activada o desactivada, el parámetro Scale de image target debe establecerse en el tamaño físico real; de lo contrario, la posición de visualización será incorrecta.