Mensajes de UI
Hay tres tipos de mensajes durante la ejecución de EasyAR Sense Unity Plugin.
- Excepciones de ejecución, incluidas Sense Error, Session Error, Error y Warning
- Session Dump
- Excepciones especiales de desarrollo de EasyAR Mega
Puede ajustar el modo de salida de los dos primeros tipos de mensajes según sea necesario. Puede configurarlo en el editor mediante el componente DiagnosticsController en la session, o configurarlo en scripts con la interfaz DiagnosticsController.MessageOutput.
Consejo
En la versión 4000, si la escena fue creada con una versión antigua del plugin, DiagnosticsController se añadirá automáticamente a la session al abrir la escena. En algunas versiones de Unity puede no añadirse automáticamente; en esas versiones de Unity, DiagnosticsController se creará automáticamente en runtime con valores predeterminados.
Excepciones de ejecución
Durante la ejecución del plugin, a veces se reciben en el sistema, en forma de mensajes, problemas detectados por componentes internos. Algunos mensajes pueden ser fallos graves que impiden continuar el uso, otros pueden haberse activado intencionadamente y otros pueden deberse a que el dispositivo no es compatible. Según la severidad, de mayor a menor, se dividen en las siguientes categorías:
- SenseError: error de EasyAR Sense, normalmente relacionado con la license de EasyAR Sense.
- SessionError: error de ARSession, normalmente relacionado con que el dispositivo no admite algunas funciones o con una configuración incorrecta.
- Error: otra información de error
- Warning: información de advertencia
Debido a las particularidades del desarrollo en Unity, de forma predeterminada mostramos estos mensajes en la UI para ayudar al desarrollo.
Puede controlar en el editor o en scripts cómo se muestran estos mensajes. Los modos de salida disponibles son:
- UIAndLog: salida a UI y log. En un visor, se muestra a 5 metros delante de los ojos.
- Log: salida al log del sistema.
Consejo
- Se recomienda usar la configuración predeterminada UIAndLog durante las etapas de desarrollo y prueba.
- Se recomienda cambiar la opción a Log al publicar. También puede conservar UIAndLog, pero estos mensajes de UI normalmente no son amigables para los usuarios finales.
- Se recomienda comprobar la disponibilidad de la session y el soporte del dispositivo antes de ejecutar, y proporcionar indicaciones razonables para dispositivos no compatibles.
Sense Error
Sense Error es un tipo especial de error. Cuando aparece, las funciones de EasyAR no pueden seguir utilizándose. Causas comunes:
- La license no está configurada correctamente o la verificación falla. Este error puede recuperarse reinicializando con una license correcta.
- En algunos dispositivos, incluidos AR Foundation, AR Engine, todos los dispositivos que usan cámaras personalizadas o varios visores, se ha superado el tiempo limitado fijo de uso de productos de prueba, como license Personal Edition, XR license de prueba o servicio Mega de prueba. Este error no puede recuperarse.
Session Error
Session Error es un error por el cual la ARSession actual no puede seguir funcionando. Modificar la configuración y volver a ejecutar ARSession puede resolver estos errores. Normalmente se deben a una configuración incorrecta, a una excepción lanzada durante el flujo de inicio que interrumpe el ensamblaje, a que el dispositivo no es compatible con la configuración actual de ARSession, o a la pérdida de componentes de ARSession durante la ejecución.
Situaciones comunes:
- Error de ensamblaje de Session: por ejemplo, el dispositivo no es compatible o el Frame Source de un dispositivo compatible no está configurado correctamente en ARSession.
- Error de inicio de Session: la información de configuración de cloud service es incorrecta y provoca un error al crear funciones de cloud service, o la configuración no se ha rellenado, incluidos el servicio Mega, el servicio de cloud recognition y el servicio SpatialMap.
- Error durante la ejecución de Session: un componente ARSession es destruido externamente, RendererFeature no está configurado correctamente en un entorno URP, etc.
En general, los errores de configuración y las excepciones del flujo de inicio que interrumpen el ensamblaje deben evitarse durante el desarrollo. Los casos de dispositivos no compatibles aparecen principalmente en funciones que requieren capacidad de motion tracking. Consulte Motion tracking y funciones de EasyAR para saber qué funciones requieren atención al soporte del dispositivo, y elija dispositivos adecuados para depurar durante el desarrollo.
Session Dump
El mensaje SessionDump muestra el estado de ejecución de ARSession recopilado mientras el plugin se ejecuta, incluidos algunos estados clave de cada componente. Esta información de estado ayuda mucho a comprender la ejecución de EasyAR y analizar problemas.
Puede controlar en el editor o en scripts cómo se muestran estos estados. Los modos de salida disponibles son:
- UI: se muestra en la UI y se actualiza cada frame. En un visor, se muestra a 5 metros delante de los ojos.
- Log: salida al log del sistema. Como se emite en cada frame, afecta al rendimiento de ejecución, por lo que se recomienda usarlo durante desarrollo o pruebas.
- None: sin salida.
Consejo
- Se recomienda usar la configuración predeterminada UI durante las etapas de desarrollo y prueba. La información mostrada arriba es indispensable para comunicarse con el personal de EasyAR.
- Se recomienda cambiarlo a None después del lanzamiento oficial, y conservar un interruptor de software para activar UI, o recopilar datos mediante otros sistemas. Al enviar comentarios sobre un problema a EasyAR, EasyAR le solicitará esta información a usted o a sus usuarios para determinar el estado de ejecución de la aplicación.
- En la mayoría de los casos, cuando una aplicación tiene problemas después del lanzamiento, el lado de la aplicación debe realizar primero la investigación y el análisis. Los problemas pueden resolverse mejor después de descartar problemas de la aplicación y obtener información suficiente. Hay muchos SDK y plataformas de terceros para la recopilación y el análisis de logs, y se recomienda usarlos antes del lanzamiento. Si no tiene experiencia o recursos para usar estas plataformas, conservar un interruptor para activar UI, por ejemplo un interruptor oculto, para que el usuario informe la información que ve, será relativamente sencillo.
Excepciones especiales de desarrollo de EasyAR Mega
En el desarrollo de Mega también hay un tipo de advertencia que no se puede controlar. Estos mensajes se mostrarán en la UI cuando se cumplan condiciones de configuración específicas, y el desarrollador no puede cerrarlos directamente.
Se recomienda prestar atención al propio mensaje, ya que el texto indica la causa y el método de configuración. Los desarrolladores deben comprender los requisitos de distintas configuraciones para distintos modos de uso y elegir razonablemente según el avance del desarrollo.
Estos mensajes se muestran intencionadamente, porque bajo condiciones de uso específicas estas funciones ayudan al desarrollo del flujo de contenido, pero al mismo tiempo no pueden obtener resultados de ejecución razonables. Tenga cuidado de no publicar con estos mensajes.