Introducción a la plantilla de paquete de extensión para auriculares

El paquete com.easyar.sense.ext.hmdtemplate es un ejemplo y plantilla proporcionados para el desarrollo de extensiones para auriculares. Es una implementación de SDK e incluye ejemplos para desarrolladores de aplicaciones.

Contenido de la plantilla

La estructura de paquetes sigue la disposición de archivos recomendada por Unity:

.
├── CHANGELOG.md
├── Documentation~
├── Editor
├── LICENSE.md
├── package.json
├── Runtime
└── Samples~
    └── Combination_BasedOn_HMD

Algunos contenidos importantes son:

• Runtime: Carpeta para activos de plataforma en tiempo de ejecución. Es la carpeta más importante en la plantilla.
• Samples~: Carpeta para todos los ejemplos en el paquete. Contiene ejemplos para uso descendente, que pueden servir como demo para probar la extensión. Para desarrollar este ejemplo localmente, se debe cambiar el nombre de la carpeta a Samples. Usar el método Client.Pack lo renombrará automáticamente a Samples~ al empaquetar una nueva versión.
• Editor: Carpeta para activos de plataforma en tiempo de edición. Los scripts en esta carpeta se usan principalmente para crear elementos de menú.
• package.json: Archivo de manifiesto del paquete.

Proceso de creación del ejemplo de plantilla

1. Agregar AR Session

   En la vista Hierarchy:

   • Hacer clic derecho en un espacio vacío, agregar ARSession mediante el menú EasyAR Sense > Mega > AR Session (Mega Block Default Preset).
   • Seleccionar AR Session (EasyAR), hacer clic derecho y agregar un ImageTrackerFrameFilter a la sesión mediante el menú EasyAR Sense > Image Tracking > Frame Filter : Image Tracker.
   • Seleccionar AR Session (EasyAR), hacer clic derecho y agregar un DenseSpatialMapBuilderFrameFilter a la sesión mediante el menú EasyAR Sense > SpatialMap > Frame Filter : Dense SpatialMap Builder.
   • Seleccionar AR Session (EasyAR), hacer clic derecho y agregar un SparseSpatialMapBuilderFrameFilter a la sesión mediante el menú EasyAR Sense > SpatialMap > Frame Filter : Sparse SpatialMap Builder.
   • Seleccionar AR Session (EasyAR), hacer clic derecho y agregar/mantener solo HMD Template como FrameSource mediante el menú EasyAR Sense > Extensions > Frame Source : HMD Template (keep it only).

   

2. Agregar ImageTargetController

   En la vista Hierarchy, hacer clic derecho en un espacio vacío y agregar un ImageTargetController a la sesión mediante el menú EasyAR Sense > Image Tracking > Target : Image Target.

   Configurar ImageTargetController:

   

   Tras esta configuración, la imagen mostrada en la vista Scene es un gizmo. Este ejemplo usa un quad para mostrar un objeto virtual con la misma imagen.

   Agregar objeto virtual encima del target:

   

3. Agregar un modelo como referencia de origen de seguimiento de movimiento

   Este modelo es importante tanto para desarrolladores como usuarios finales, ya que desacopla el seguimiento de movimiento del dispositivo de los algoritmos de EasyAR.

   

4. Agregar UI para selección de funciones

   

5. Desactivar funciones de EasyAR al inicio y activarlas mediante interruptores UI

   Por ejemplo, la función de seguimiento de imágenes puede desactivarse al inicio estableciendo enable como false en el componente correspondiente:

   

   Luego agregar manejo de interruptores UI:

   

Temas relacionados

• Hacer que los auriculares admitan EasyAR explica cómo usar esta plantilla para crear un nuevo paquete de extensión para auriculares
• Validación de funcionamiento (bring-up) explica cómo usar el ejemplo de esta plantilla para verificar la corrección de la extensión de entrada
• Publicar paquete de extensión explica cómo completar el empaquetado y distribución final basado en esta plantilla