Table of Contents

Usar AllSamplesLauncher para experimentar rápidamente con los ejemplos de EasyAR

AllSamplesLauncher es un lanzador de ejemplos integrado que le ayuda a familiarizarse rápidamente con las diversas funciones de EasyAR SDK. A través de este lanzador, puede cambiar y ejecutar todas las escenas de ejemplo oficiales con un solo clic en un solo proyecto de Unity, sin necesidad de configurar manualmente múltiples proyectos independientes.

Preparativos

Antes de comenzar, asegúrese de haber completado los siguientes preparativos:

  1. Ha instalado Unity Hub y el editor de Unity
  2. Ha creado un nuevo proyecto de Unity
  3. Ha importado EasyAR Sense Unity Plugin y ha importado todos los Samples

Consulte las instrucciones paso a paso en Inicio rápido.

Pasos detallados

  1. Abra todas las escenas en Samples.
    Todas las escenas de ejemplo
  2. Haga clic en la barra de menú File > Build Settings o Build Profiles > Scene List.
  3. Arrastre todas las escenas a Scene List.
  4. Asegúrese de que AllSamplesLauncher esté primero en la lista de escenas. Si no lo está, puede arrastrarlo dentro de la ventana.
    Orden de la lista de escenas
  5. Haga clic en la barra de menú File > Build And Run para compilar y ejecutar.
Nota

Al compilar para ejecutar en un teléfono móvil, no agregue escenas de tipo visor:

  • Combination_BasedOn_AppleVisionPro
  • Combination_BasedOn_Xreal
    No cargar visores

Problemas encontrados durante la compilación

Durante la compilación y empaquetado, puede encontrar algunos errores. Los problemas comunes son:

Mensaje de error Causa Solución
FileNotFoundException:EasyAR Settings Asset Licencia no completada Haga clic en la barra de menú EasyAR > Sense > Configuration, en EasyAR Sense License ingrese su License Key
Missing Prefab Asset: 'XR Interaction Setup' Falta archivo relacionado con visores Elimine las escenas relacionadas con visores de la lista de escenas de compilación. Si confirma que necesita compilar para visores, siga los pasos en Usar ejemplos de visores

Uso del lanzador

Después de ejecutarlo, verá una interfaz de lanzador limpia.

Página de inicio del lanzador

Haga clic en el botón Samples en el centro inferior de la interfaz para acceder a los ejemplos de todas las funciones.

Página de ejemplos del lanzador

En el lado izquierdo de la interfaz están las categorías de funciones, y en el lado derecho está la lista de ejemplos de escenas para cada función. Haga clic en diferentes escenas de ejemplo para experimentar todas las diferentes funciones que ofrece EasyAR.

Además, en la parte inferior de la interfaz se proporcionan videos de demostración de las funciones de EasyAR Sense y EasyAR Mega, que pueden ayudarle a comprender mejor qué funcionalidades y efectos puede ofrecerle EasyAR.

Aspectos esenciales para leer antes de ejecutar los ejemplos

Antes de ejecutar ejemplos específicos, debe completar las siguientes configuraciones clave; de lo contrario, los ejemplos no funcionarán correctamente:

  1. Configure su API Key

    • Algunos ejemplos (especialmente aquellos que involucran reconocimiento en la nube, posicionamiento en la nube Mega, etc.) requieren una API Key válida.
    • En la barra de menú EasyAR > Sense > Configuration, busque el lugar correspondiente que el ejemplo requiere completar.
    • Ingrese allí el App ID, API Key, API Secret que solicitó desde el Centro de desarrolladores de EasyAR.
      Configuración de claves
    • Importante: Si aún no tiene una API Key, algunos ejemplos de funciones locales (como seguimiento de imágenes) aún pueden ejecutarse, pero las funciones en la nube fallarán. Asegúrese de ir al Centro de desarrolladores de EasyAR para crear una aplicación y obtener las claves.

  2. Configure la compatibilidad con XR/plataforma:

    • Si está ejecutando ejemplos relacionados con visores, consulte Usar ejemplos de visores.
    • Asegúrese de que su dispositivo (como teléfono o visor) esté conectado correctamente y en modo desarrollador.

Explorar en profundidad los ejemplos

El lanzador de ejemplos es su mejor punto de partida para aprender. Le recomendamos encarecidamente:

  • Primero ejecute, luego investigue: Experimente rápidamente el efecto de cada ejemplo a través del lanzador para obtener una impresión intuitiva de las capacidades de EasyAR.
  • Abra los archivos fuente de la escena: Cada ejemplo es un archivo de escena de Unity independiente, ubicado en el directorio Assets/Samples/EasyAR Sense Unity Plugin/[versión]/__All Samples__/[nombre de la función]/[nombre del ejemplo]/Scenes.
  • Investigue y lea el código del script: En las escenas de ejemplo, puede abrir los scripts *.cs incluidos en el ejemplo para ver cómo llamamos a la API de EasyAR para implementar funciones específicas. Esta es la mejor manera de aprender a usar la API.

A través del lanzador de ejemplos, puede obtener rápidamente una comprensión de las funciones de EasyAR SDK. ¡Que tenga una feliz exploración!