Table of Contents

Mensajes de UI

El plugin de Unity de EasyAR Sense tiene tres tipos de mensajes en tiempo de ejecución.

  • Excepciones de ejecución, incluyendo Sense Error, Session Error, Error, Warning
  • Session Dump
  • Excepciones especiales de desarrollo de EasyAR Mega

Puede ajustar la salida de los primeros dos tipos de mensajes según sea necesario. Puede configurarse en el editor mediante el componente DiagnosticsController en la sesión, o mediante la interfaz DiagnosticsController.MessageOutput en scripts.

diagnostics ui messages

Consejo

En la versión 4000, si una escena fue creada con una versión anterior del plugin, DiagnosticsController se agregará automáticamente a la sesión al abrir la escena. En algunas versiones de Unity, es posible que no se agregue automáticamente. En esas versiones, DiagnosticsController se creará automáticamente en tiempo de ejecución con valores predeterminados.

Excepciones de ejecución

A veces, durante la ejecución del plugin, se detectan problemas internos que se presentan como mensajes en el sistema. Estos mensajes pueden ser fallas graves que impiden continuar, pueden ser intencionales, o pueden indicar que el dispositivo no es compatible, etc. Se clasifican por nivel de gravedad de mayor a menor de la siguiente manera:

  • SenseError: Error de EasyAR Sense, generalmente relacionado con la licencia de EasyAR Sense.
  • SessionError: Error de ARSession, generalmente relacionado con dispositivos que no admiten ciertas funciones o configuraciones incorrectas.
  • Error: Otra información de error
  • Warning: Información de advertencia

Debido a las particularidades del desarrollo en Unity, mostramos estos mensajes en la UI de forma predeterminada para ayudar en el desarrollo.

Puede controlar cómo se muestran estos mensajes en el editor o en scripts. Los modos de salida disponibles son:

  • UIAndLog: Salida a UI y registro. En dispositivos de visualización en cabeza, se muestra a 5 metros frente al usuario.
  • Log: Salida al registro del sistema.
Consejo

Sense Error

Sense Error es un tipo especial de error. Cuando ocurre, las funciones de EasyAR no se pueden seguir utilizando. Causas comunes:

  • La licencia no se configuró correctamente o falló la verificación. Este error se puede recuperar reinicializando con una licencia válida.
  • Uso de productos de prueba (licencia personal, licencia XR de prueba o servicio Mega de prueba, etc.) en ciertos dispositivos (incluidos todos los dispositivos que usan cámaras personalizadas como AR Foundation, AR Engine o varios dispositivos de visualización en cabeza) más allá de un tiempo limitado fijo. Este error no se puede recuperar.

Session Error

Session Error es un error que impide que el ARSession actual continúe funcionando. Modificar la configuración y reiniciar el ARSession podría resolver estos errores. Generalmente se deben a errores de configuración, excepciones lanzadas durante el flujo de inicio que interrumpen el ensamblaje, dispositivos no compatibles con la configuración actual del ARSession o pérdida de componentes del ARSession durante la ejecución.

Casos comunes:

  • Error de ensamblaje de la sesión: por ejemplo, dispositivo no compatible o Frame Source para dispositivos compatibles no configurado correctamente en el ARSession.
  • Error de inicio de sesión: información de configuración del servicio en la nube incorrecta que causa fallos al crear funciones del servicio en la nube, o información no completada (incluidos servicios Mega, reconocimiento en la nube, SpatialMap).
  • Error durante la ejecución de la sesión: componente ARSession destruido externamente, RendererFeature no configurado correctamente en entornos URP, etc.

Generalmente, los errores de configuración y las excepciones durante el flujo de inicio que interrumpen el ensamblaje deben evitarse durante el desarrollo. Los casos de dispositivos no compatibles ocurren principalmente en funciones que requieren capacidades de seguimiento de movimiento. Consulte Seguimiento de movimiento y funciones de EasyAR para conocer qué funciones requieren atención a la compatibilidad del dispositivo y seleccione dispositivos adecuados para depuración durante el desarrollo.

Session Dump

Los mensajes SessionDump muestran el estado de ejecución del ARSession recopilado durante la ejecución del plugin, incluyendo algunos estados clave de varios componentes. Esta información es muy útil para comprender el funcionamiento de EasyAR y analizar problemas.

Puede controlar cómo se muestran estos estados en el editor o en scripts. Los modos de salida disponibles son:

  • UI: Se muestra en la UI y se actualiza cada fotograma. En dispositivos de visualización en cabeza, se muestra a 5 metros frente al usuario.
  • Log: Salida al registro del sistema. Como se genera cada fotograma, afecta el rendimiento. Se recomienda usar solo durante desarrollo o pruebas.
  • None: Sin salida.
Consejo
  • Se recomienda usar la configuración predeterminada UI durante las fases de desarrollo y prueba. La información mostrada es esencial para la comunicación con el personal de EasyAR.
  • Se recomienda cambiar a None después del lanzamiento oficial, pero mantener un interruptor de software para activar UI, o recopilar datos mediante otro sistema. Al informar problemas a EasyAR, solicitarán esta información a usted o a sus usuarios para evaluar el estado de ejecución de la aplicación.
  • En la gran mayoría de los casos, cuando surgen problemas después del lanzamiento, primero se debe investigar y analizar el problema en el lado de la aplicación. Solo los problemas reportados después de descartar problemas de la aplicación y recopilar suficiente información se pueden resolver adecuadamente. Existen muchos SDK y plataformas de terceros para recopilación y análisis de registros. Se recomienda usarlos antes del lanzamiento. Si no tiene experiencia o recursos con estas plataformas, mantener un interruptor (por ejemplo, oculto) para activar UI y que los usuarios informen lo que ven será más sencillo.

Excepciones especiales de desarrollo de EasyAR Mega

En el desarrollo de Mega, hay otro tipo de mensajes de advertencia que no se pueden controlar. Estos mensajes se muestran en la UI cuando se cumplen ciertas condiciones de configuración específicas, y los desarrolladores no pueden desactivarlos directamente.

Se recomienda prestar atención al mensaje en sí. El texto explica claramente la causa y el método de configuración. Los desarrolladores deben comprender los requisitos de diferentes configuraciones para diferentes modos de uso y seleccionar adecuadamente según el progreso del desarrollo.

Estos mensajes se muestran intencionalmente porque, bajo ciertas condiciones de uso, estas funciones ayudan en el desarrollo del flujo de contenido, pero al mismo tiempo no pueden obtener resultados de ejecución razonables. Tenga cuidado de no lanzar con estos mensajes visibles.

Temas relacionados