Mega preguntas frecuentes

Encontrar problemas durante el desarrollo es inevitable. Este documento tiene como objetivo ayudarte a identificar y resolver rápidamente problemas comunes. Comenzamos con una lista de preguntas frecuentes (FAQ); si no encuentras la respuesta aquí, consulta las secciones posteriores o envía un informe de problemas.

Preguntas frecuentes (FAQ)

Aquí se presentan algunos problemas comunes y sus soluciones que los desarrolladores encuentran al integrar y usar EasyAR Mega.

P: ¿Por qué mi aplicación muestra "Invalid Key"?

R: Esto suele ocurrir por las siguientes razones:

1. La licencia es inválida o ha expirado
2. La licencia no coincide con el Bundle ID / Package Name
3. Los dispositivos de realidad extendida (headset) requieren una XR License adicional
4. Las funciones de cámara personalizada requieren una licencia de versión oficial

P: ¿Por qué mi aplicación tiene una marca de agua?

R: Esto indica que está utilizando una licencia de prueba en lugar de una versión oficial.

P: ¿Por qué mi aplicación muestra un contador regresivo (timeout within * seconds)?

R: Esta es una limitación durante el período de prueba del producto. Usar una licencia oficial de EasyAR Sense y el servicio EasyAR Mega de versión oficial resuelve este problema.

P: ¿Por qué mi aplicación se abre con una pantalla negra?

R: En este caso, normalmente se muestra la causa del error en la información de pantalla o registros (logs). Puede solucionarlo según la causa específica que muestre el sistema. Si no puede resolverlo, proporcione información técnica (incluidos registros, capturas de pantalla, detalles del dispositivo, etc.).

P: ¿Por qué mi aplicación no puede localizarse y el estado siempre es NotFound?

R: Esto suele ocurrir por las siguientes razones:

1. El servicio de localización aún se está iniciando:
   El servicio aún no ha cargado completamente todos los mapas Mega, por lo que no puede garantizar una localización exitosa en ciertas áreas.
2. Fuera del área cubierta por el mapa:
   Asegúrese de que su ubicación física actual esté dentro del área cubierta por el mapa Mega que cargó.
3. Configuración incorrecta en pruebas simuladas:
   No se está ejecutando en el sitio físico, pero MegaLocationInputMode se configuró incorrectamente como Onsite.
4. Condiciones ambientales desfavorables:
   Iluminación extrema (muy oscura o muy brillante) o paredes/suelos de color uniforme (como paredes blancas o pisos pulidos) afectan la localización visual.

P: ¿Por qué mi aplicación no puede localizarse y el estado de retorno es anómalo?

R: Esto suele ocurrir por las siguientes razones:

1. Tiempo de espera agotado (timeout):
   El sistema devolverá RequestTimeout.
2. Intervalo entre solicitudes demasiado corto:
   El sistema devolverá RequestIntervalTooLow.
3. Otros errores excepcionales:
   El sistema devolverá UnknownError. Normalmente, estos errores indican fallos en la conexión/transmisión o errores en el servicio Mega. Puede obtener detalles mediante la interfaz MegaBlockLocalizationResponse.ErrorMessage.

P: ¿Por qué falla mi solicitud para usar el plugin en mini-programas?

R: Esto ocurre porque los plugins de mini-programas no son compatibles con el "modo de visitante" en las herramientas de desarrollo de WeChat, ni con mini-programas de titularidad personal. Solicítelo utilizando el AppId de un mini-programa empresarial.

P: ¿Por qué no se aprobó la autorización de mi miniprograma?

R: Necesitas obtener una licencia del complemento Mega Miniprograma desde el centro de desarrollo y asegurarte de que estás utilizando el mismo AppId que aparece en la licencia.

P: ¿Por qué mi miniprograma no funciona en el teléfono XX?

R: La integración de Mega en el miniprograma depende del componente VisionKit de WeChat. Consulta los requisitos del sistema y la lista de dispositivos compatibles en la documentación de WeChat.

P: La ubicación fue exitosa, pero el contenido virtual parece desviado o con deriva?

R: Los problemas relacionados con el efecto de ubicación suelen tener causas complejas. Las posibles razones son:

1. Problema de precisión del mapa:
   El mapa Mega de esa área en sí podría tener errores de precisión. Esto suele ocurrir durante la fase de captura o reconstrucción del mapa; contacta al equipo comercial para confirmarlo.
2. Saltos durante la inicialización:
   En los primeros segundos de la ubicación, la posición puede tener ligeros saltos. Esto se debe a que el sistema SLAM del dispositivo aún no ha completado la inicialización, un proceso particularmente notable en miniprogramas de WeChat (en algunos dispositivos incluso puede ser prolongado).
3. Cambios dinámicos en el entorno:
   Si el entorno físico ha cambiado significativamente (por ejemplo, se movieron elementos grandes, se añadieron paneles temporales), el mapa podría no coincidir con la realidad. En este caso, es necesario actualizar el mapa.
4. Error del sistema del dispositivo:
   La mayoría de los dispositivos, tras funcionar de forma continua durante mucho tiempo, acumulan errores en su sistema SLAM, lo que provoca deriva.
5. Problema de error de ubicación:
   La ubicación visual en sí tiene un margen de error de precisión, que normalmente no afecta la experiencia visual del contenido virtual. Si el error es tan grande que causa una desviación o deriva evidente, se necesitan datos detallados para analizar y resolverlo. Consulta los métodos descritos en Diagnóstico y reporte de problemas para recopilar datos y proporcionar retroalimentación.

P: ¿Cómo capturar y usar datos EIF para depuración?

R: Los datos EIF son una herramienta de depuración poderosa. Consulta los siguientes capítulos:

• Cómo capturar: Lee Captura de datos de simulación para aprender a grabar archivos EIF en un teléfono o un visor.
• Cómo reproducir: Según tu entorno de desarrollo (Unity o miniprograma de WeChat), consulta la guía de reproducción correspondiente en ese capítulo.

Buscar ayuda más específica

Si las preguntas frecuentes anteriores no resuelven tu problema, visita las siguientes páginas temáticas para obtener soluciones más detalladas:

• El contenido no se muestra - Se centra en problemas de renderizado de contenido.
• Saltos y desplazamientos del contenido - Análisis en profundidad de saltos y desplazamientos del contenido.
• Problemas conocidos de integración en miniprogramas de WeChat - Resumen de problemas específicos de la plataforma de miniprogramas.

Reportar un nuevo problema

Si encuentras un problema no cubierto anteriormente, que sospeches que es del SDK o de la plataforma en sí, ayúdanos a mejorar el producto. Puedes consultar los pasos detallados en: Reporte de problemas.

Antes de enviar tu reporte, asegúrate de tener preparada la siguiente información, lo que nos ayudará enormemente a resolver el problema:

1. Descripción del problema: Explica claramente los síntomas, la frecuencia y los pasos para reproducirlo.
2. Información del dispositivo: Modelo del dispositivo, versión del sistema operativo, versión del EasyAR SDK.
3. Datos EIF: Proporciona siempre el archivo de grabación EIF que reproduzca el problema. Esta es la evidencia de diagnóstico más importante.
4. Archivo de registros (logs): Registros completos de la aplicación (salida de Logcat o Consola).
5. Grabación de pantalla o capturas: Video o imágenes de la pantalla cuando ocurre el problema.

Envía esta información a través de nuestro foro, correo electrónico o contacto comercial. ¡Gracias por tus comentarios!