Informe de problemas y comentarios

Valoramos mucho sus comentarios, ya que son clave para ayudarnos a mejorar los productos y servicios de EasyAR Mega. Para que podamos localizar y resolver rápidamente los problemas que encuentre, tómese unos minutos para leer esta guía antes de enviar un informe.

Nuestros datos de contacto

Puede enviarnos informes de problemas a través de los siguientes canales:

• Comunidad/Foro oficial de desarrolladores - Recomendado para preguntas generales e intercambio comunitario.

  • Usuarios en chino, haga clic aquí
  • Otros usuarios, haga clic aquí

• Grupo de WeChat empresarial - Aplicable para usuarios empresariales que requieran soporte confidencial o más formal.

  • Escanee el código QR a continuación para unirse al grupo
    

• Más formas de contacto - Como opción alternativa.

  • Para obtener los datos de contacto, haga clic aquí

Elementos clave para un informe de alta calidad

Un informe que incluya la siguiente información nos ayudará enormemente a reproducir y resolver el problema. Cuanto más completa sea la información, más rápido se resolverá el problema.

Lista de verificación general (necesaria para todos los problemas)

1. Descripción clara del problema:

   • ¿Qué resultado esperaba lograr?
   • ¿Qué sucedió realmente? (Por ejemplo: la aplicación se cierra inesperadamente, fallo de localización, desplazamiento del contenido)
   • ¿Con qué frecuencia ocurre el problema (siempre/ocasionalmente)? ¿Bajo qué condiciones ocurre?

2. Información del dispositivo y entorno:

   • Modelo del dispositivo: Por ejemplo, iPhone 14 Pro, Samsung Galaxy S23 Ultra, Apple Vision Pro.
   • Versión del sistema operativo: Por ejemplo, iOS 17.2, Android 14, visionOS 26.
   • Versión de EasyAR SDK: Por ejemplo, EasyAR Sense Unity Plugin v4.6.0.
   • Entorno de prueba: Interior/exterior, condiciones de iluminación, si es un entorno dinámico.

3. Datos EIF (la evidencia más importante):

   • Proporcione siempre el archivo de grabación EIF que pueda reproducir el problema.
   • Los datos EIF contienen toda la información de sensores e imágenes en el momento del problema, siendo nuestra herramienta más poderosa para diagnosticarlo. Consulte Grabar datos de ejecución simulada para aprender a grabar.

4. Archivo de registro (Log):

   • Proporcione el registro completo de la aplicación en el momento del problema.
   • Android: Salida de Logcat.
   • iOS: Registros de Console.app o salida de la consola de Xcode.
   • Unity: Registros de la Consola del Editor de Unity.
   • Mini programa de WeChat: Archivo de registro obtenido mediante session.dumpLog().

5. Grabación de pantalla o captura de pantalla:

   • Una grabación de pantalla o una captura de pantalla de alta definición en el momento del problema, que muestre visualmente el fenómeno descrito.
   • Para guías de operación en diferentes dispositivos, consulte: Grabación de pantalla en teléfonos, Grabación de pantalla en dispositivos de realidad aumentada.

6. Información de la biblioteca de localización de Mega

   • Información de diagnóstico del block utilizado para exportar la aplicación en Unity / Información del servicio de la biblioteca de localización de Mega. Método de exportación:
   • Desarrollo en Unity, versión del plugin >= 4003
   • Desarrollo en Unity, versión del plugin 4.7 - 4002
   • Desarrollo de mini programas

   

Lista de verificación adicional para tipos específicos de problemas

Para una localización más precisa del problema, proporcione la siguiente información adicional según el tipo de problema:

A. Fallo o inestabilidad en la localización

• Se ha intentado verificar en la misma ubicación utilizando Mega Toolbox o la herramienta de PC, y se ha indicado el resultado.
• Se ha confirmado que el mapa cargado en la biblioteca de localización coincide con el espacio físico actual.
• Se describe la ubicación aproximada donde ocurre el problema (por ejemplo, atrio de un centro comercial, entrada de una atracción turística).

B. El contenido no se muestra

• Se ha proporcionado el resultado de la verificación de localización utilizando una herramienta externa.
• Se ha confirmado que no hay problemas con la ubicación del contenido o la lógica del código.
• Si es un problema de renderizado, proporcione una captura de pantalla o descripción del modelo, Shader o efecto utilizado.

C. El contenido salta o se desplaza

• Se describe la forma de movimiento del dispositivo (movimiento suave/rápido).
• Se describe la textura y condiciones de iluminación del entorno, y si existen áreas de confusión extremadamente similares.
• Se describe la lógica de procesamiento de la pose dentro de la aplicación y se confirma que la ubicación del contenido es correcta.

D. Problemas con mini programas de WeChat

• Se ha proporcionado una captura de pantalla que muestra que el usuario ha activado los permisos del servicio Mega dentro de WeChat.
• Se indica si el modelo de teléfono del usuario está en la lista oficial de soporte de WeChat.
• Se proporciona el AppID del mini programa y una descripción específica del escenario de negocio.

E. Problemas de rendimiento (tirones, alto consumo de energía)

• Se indica el modelo del dispositivo donde ocurre el problema.
• Se proporciona información sobre el uso de CPU/GPU o la temperatura del dispositivo durante la ejecución de la aplicación (si es posible).
• Se describe la complejidad del contenido 3D (número de polígonos del modelo, tamaño de las texturas).
• Se indica si se utiliza una configuración de múltiples mapas.

Uso de EasyAR Sense Unity Plugin para exportar información de desarrollo de Unity

Específicamente, para el desarrollo de aplicaciones Mega en la plataforma Unity, hemos preparado una herramienta más conveniente para generar información de comentarios. Los pasos detallados son los siguientes:

1. Abra EasyAR > Sense > Hacer una pregunta en la barra de menú
   
2. Proporcione la siguiente información en Hacer una pregunta:

• Marque el entorno de ejecución (selección única), por ejemplo, Android.
• Copie la información del dispositivo. En ARSession, establezca DiagnosticsController.DumpSession en Log, copie la salida de un fotograma y complete el resultado en el cuadro de información del dispositivo.
  
• Marque todas las funciones de EasyAR que utiliza su aplicación, se admite la selección múltiple.
• Confirme que ha completado las cuatro verificaciones en la página y márquelas, se recomienda describir cómo reproducir el problema en el Sample al hacer la pregunta.
• Haga clic en la función de copiar en la esquina superior derecha, con lo que habrá completado la recopilación de información de desarrollo de Unity.
  

Sugerencia para el proceso de envío de informes

1. Preparar materiales: Según la lista anterior, recopile EIF, registros, capturas de pantalla/grabaciones, información del servicio, información de desarrollo, etc.
2. Redactar el informe: Describa el problema claramente y adjunte todos los materiales.
3. Enviar: Envíe el informe a través del canal que elija.
4. Seguimiento: Una vez que recibamos el informe, nos pondremos en contacto con usted a través de negocios o correo electrónico. Por favor, manténgase atento.

¡Gracias por su tiempo y por su apoyo a los productos EasyAR Mega! Cada uno de sus comentarios nos ayuda a construir un mejor futuro para la computación espacial.