Table of Contents

Primeros pasos rápidos con EasyAR Mega Unity usando ejemplos

Este tutorial explica cómo configurar y ejecutar los ejemplos de EasyAR Mega Unity para comenzar rápidamente con el desarrollo en EasyAR Mega.

Antes de comenzar

Antes de leer este artículo, asegúrese de haber completado:

Ejemplo de uso (seis pasos)

A continuación se describen seis pasos para configurar y ejecutar el ejemplo central de EasyAR Mega, MegaBlock_Basic.

Paso 1: Importar muestra

Nota

Si importó todas las muestras a través de **All Samples**, omita este paso.

  1. Use el menú Window > Package Manager para abrir Package Manager, seleccione EasyAR Sense Unity Plugin. En el panel derecho, expanda todas las muestras en Samples.
  2. Seleccione una muestra (por ejemplo, MegaBlock_Basic) y haga clic en Import.

Importar muestra

Nota
  • Este tutorial no es aplicable directamente a dispositivos de visualización montados en la cabeza (head-mounted displays), pero se requiere comprender el flujo usando un teléfono móvil para desarrollo antes de desarrollar para dichos dispositivos.
  • Si importó previamente muestras de una versión anterior del SDK, después de actualizar el SDK, elimine primero las muestras antiguas y vuelva a importar las nuevas.

Paso 2: Introduzca la License Key y configure el servicio de posicionamiento en la nube Mega

  1. En la barra de menú, seleccione EasyAR > Sense > Configuration;
    License Guide
  2. En el panel Project Settings que se abre, pegue su License Key;
    Fill License
Consejo

La License de EasyAR Sense puede crearse desde el Centro de desarrollo de EasyAR. Para primeros usos, siga estos pasos:

  • Cree EasyAR Sense 4.x Personal Edition
  • En "Mapa espacial disperso", seleccione No
  • Rellene el nombre de la aplicación libremente. En Bundle ID y Package Name, ingrese com.mycompany.myproject
  • Seleccione la License recién creada y haga clic en el botón de copiar a la derecha

copykey

Nota

Bundle ID y Package Name pueden modificarse posteriormente, pero con límites. Si tiene un nombre de paquete de aplicación definido, ingréselo.

La edición Personal no tiene límite de creaciones. Otros tipos pueden crearse según necesidades.

  1. Configure la información de su biblioteca de posicionamiento en la nube Mega en el ítem Mega Block del panel Project Settings;
    Mega Config Guide
Consejo

La configuración de la biblioteca de posicionamiento en la nube Mega puede obtenerse desde el Centro de desarrollo de EasyAR.
Mega Config Detail
Asegúrese de que su API Key tenga permisos para Mega Block. Si no, modifíquela o créela de nuevo.
API Key Auth

Paso 3: Colocar contenido 3D

  1. Haga clic derecho en un espacio vacío del panel Hierachy y agregue la herramienta de visualización de Block (desarrollo de Unity);
    Add Block Viewer

  2. Acceda al servicio de localización Mega;

    1. Seleccione el nodo EasyAR.Mega.BlockViewer (Dev), complete la información de su cuenta EasyAR en el panel Inspector e inicie sesión;
      login
    2. Haga clic en el botón a la derecha de Mega Cloud Service;
      Click Mega CLS
    3. Seleccione el Mega定位服务 que desea utilizar y haga clic en Aceptar.
      Select Mega CLS

  3. Cargar Block

    Después de seleccionar el servicio, la lista de Blocks en la biblioteca actual se mostrará bajo el nodo MegaBlocks y en el panel de herramientas. Haga clic en Cargar para cargar el Block seleccionado:
    Load Block

    Una vez cargado, el Block se mostrará en la ventana Scene. Puede operar en la ventana Scene para ajustar el ángulo de visualización y la posición. Verifique también si el archivo Block es utilizable (por ejemplo, si el sistema de coordenadas del Block es normal, si existe estratificación, si es demasiado borroso, si tiene defectos que impiden encontrar una ubicación para colocar recursos de RA, etc.).
    Display Block

  4. Colocar contenido 3D

    En este punto, puede colocar objetos 3D haciendo referencia al Block.
    Place 3D Object

    Nota
    • Los objetos 3D deben colocarse bajo el nodo MegaBlocks > Block_* generado automáticamente por la herramienta, para garantizar que la posición de renderizado del contenido virtual sea correcta durante el tiempo de ejecución.
    • No modifique el nombre del nodo Block_* ni su local transform, ya que son gestionados automáticamente por la herramienta.

Paso 4: Configurar MegaTracker

  1. Configurar Block Root;

    Despliega AR Session, selecciona Mega Block Tracker y establece Block Root como el nodo MegaBlocks generado por la herramienta.
    Set Block Root

Paso 5: Modificar la configuración del Player

En el menú de Unity, ve a File > Build Settings > Player Settings, haz clic en el icono de Android para abrir la configuración correspondiente de la plataforma Android.

switchtoandroid

  • Modifica el Package Name para que coincida con el Package Name mostrado en la página de License Key

    androidPackageName

    Consejo

    Por ejemplo, si el Package Name que ingresaste al crear la License Key era com.mycompany.myproject, debes establecer aquí el Package Name como com.mycompany.myproject, de lo contrario la ejecución fallará.

  • Modifica Minimum API Level a API Level 21 o superior

    androidAPILevel

  • Modifica Scripting Backend a IL2CPP y selecciona ARM64 en Target Architecture

    androidarm64

Paso 6: Construir y ejecutar

  1. Agrega la escena actual a File > Build Settings o Build Profiles > Scene List;
  2. Cambia a la plataforma objetivo (por ejemplo, Android / iOS), verifica que el nombre del paquete (Bundle ID) y la License Key coincidan;
    Switch Platform
  3. Haz clic en Build And Run.
    Build And Run

El efecto de funcionamiento real se muestra a continuación:

Sobre la escritura amarilla en la pantalla

Durante la ejecución, es posible que vea dos mensajes en amarillo mostrados en la pantalla.

  1. Advertencia de ejecución de simulación Está ubicada en la parte inferior de la pantalla:

    Esta advertencia aparece porque, con la configuración predeterminada, la aplicación puede ejecutarse sin estar on-site. Tiene un ligero impacto en el rendimiento de la aplicación. Si está usando la aplicación on-site, puede modificar la configuración de MegaTracker antes de crear el paquete.

  2. Información de diagnóstico Está ubicada en la parte superior de la pantalla. Se utiliza para conocer el estado de funcionamiento y los problemas de la sesión. Se recomienda mantenerla visible durante las fases de desarrollo y prueba:

    Puede consultar La información de diagnóstico en la escena para comprender rápidamente cómo configurar y usar esta información de diagnóstico.

Próximos pasos: de principiante a experto

¡Felicidades! Siguiendo los pasos anteriores, ha ejecutado con éxito los ejemplos principales de EasyAR Mega en 10 minutos, experimentando de primera mano el encanto de la localización espacial y la superposición de contenido AR.

Ahora que domina los conceptos básicos. Si desea:

  • Construir aplicaciones AR más estables y eficientes
  • Lograr efectos complejos como oclusión mixta, alineación de contenido, etc.
  • Depurar cuando no disponga de dispositivos o no pueda acudir al sitio

Consulte las siguientes guías detalladas. Le ayudarán a resolver problemas prácticos durante el desarrollo.

Desarrollo avanzado

Si desea conocer la configuración completa de ingeniería, puede consultar el siguiente contenido:

Si desea comprender más a fondo el uso de EasyAR, puede comenzar desde aquí:

También se recomienda leer el siguiente contenido para ayudarle en el desarrollo y depuración:

Control preciso de las funciones Mega

El contenido a continuación te ayudará a utilizar mejor Mega en tu aplicación:

El contenido a continuación te ayudará a verificar las funciones Mega sin necesidad de desplazarte al lugar:

Temas avanzados

El siguiente contenido es más adecuado para leer después de tener cierta experiencia con EasyAR.

Si deseas ejecutar EasyAR Mega en un visor, puedes consultar:

Si deseas usar AR Foundation, puedes comenzar aquí: