Herramienta de verificación y diagnóstico in situ
Este artículo explica la configuración de localización, la interfaz de ejecución y el envío de datos anómalos en Mega Toolbox (Mini Program). Use un archivo de máscara para comprobar la alineación del modelo con el entorno real, o cargue anotaciones para ver la colocación de contenido virtual.
Antes de comenzar
- Siga la introducción a la herramienta para preparar la base de datos de localización en la nube, la cuenta EasyAR y el teléfono, y vaya al lugar del Block objetivo.
- Para usar un archivo de máscara, la versión de mapeo del Block debe ser 9.6 o posterior. Consúltela en la página de detalles del Block.
- Para usar anotaciones, primero cree datos de anotación para la verificación in situ y confirme que el paquete pertenece a la base de datos que va a probar. Si no usa anotaciones, omita este paso.
Para un ejemplo completo, consulte Resultado del Mini Program.
Obtener la herramienta
Escanee el código del Mini Program siguiente con WeChat para abrir Mega Toolbox.
Iniciar sesión
Use una cuenta de EasyAR Developer Center con acceso a la base de datos de localización en la nube objetivo. Los números de la imagen indican el nombre de usuario, la contraseña y el botón de inicio de sesión.
- Introduzca el nombre de usuario.
- Introduzca la contraseña.
- Pulse
Iniciar sesión.
Seleccionar la base de datos y las anotaciones
Seleccione la base de datos objetivo, elija un paquete de anotación si lo necesita y pulse Iniciar. Los ajustes de la imagen se explican a continuación.
| N.º | Ajuste | Descripción |
|---|---|---|
| 1 | Base de datos de localización en la nube | Seleccione la base que contiene el Block objetivo. La lista muestra «nombre del grupo de servicios | nombre de la base». |
| 2 | Modificar dirección |
Normalmente déjelo sin marcar. Si necesita otra dirección de servicio, por ejemplo para el extranjero, configúrela según el servicio. |
| 3 | Prueba fuera del lugar |
Déjelo sin marcar al probar en el entorno real; márquelo solo para pruebas con fotografías u otros materiales fuera del lugar. |
| 4 | Prueba de arranque en frío |
Se usa para pruebas específicas de arranque en frío. Déjelo sin marcar en verificaciones in situ habituales. |
| 5 | Paquete de anotaciones | Seleccione el paquete que desea cargar. Para verificar solo la localización o mostrar un archivo de máscara, elija No usar anotaciones. |
| 6 | Mostrar nombres de anotaciones |
Al cargar anotaciones, márquelo si desea mostrar sus nombres. |
| 7 | Iniciar |
Abra la página de localización con la configuración actual. |
Al entrar por primera vez en la página de localización, conceda los permisos de cámara y ubicación solicitados por WeChat.
Entrar en la interfaz de localización
Apunte la cámara a una zona bien iluminada y con abundante textura visual, y mueva el teléfono de forma constante hasta que termine la inicialización de la detección de planos de WeChat. Mantenga activada Localización Mega y espere el resultado en la nube.
Ver resultados y controles
Active Información de depuración para consultar el dispositivo, la escena, las solicitudes y los resultados. La imagen muestra una localización correcta con anotaciones cargadas; sin anotaciones no aparece el cubo.
| N.º | Control o información | Descripción |
|---|---|---|
| 1 | Información de depuración |
Mostrar u ocultar el panel de depuración. |
| 2 | Grabar registros |
Iniciar o detener la grabación de registros. Al detenerla, elija un destinatario en WeChat para exportar el archivo. |
| 3 | Grabar datos |
Iniciar o detener la grabación de datos dump. Al detenerla, elija un destinatario en WeChat para exportar el archivo. |
| 4 | Opciones avanzadas |
Mostrar u ocultar las opciones avanzadas. |
| 5 | Localización Mega |
Iniciar o detener la localización Mega en la nube. |
| 6 | Resultado de localización en la nube | Ver status, el tiempo de respuesta y el Block localizado. |
| 7 | Historial de localización | Sequence muestra estados anteriores: N no cargado, S éxito y F fallo. El botón Status es verde en caso de éxito y blanco en caso de fallo. |
Resultados habituales y acciones:
| Resultado | Significado y acción |
|---|---|
Found |
Se ha localizado el Block objetivo. Compare la malla de máscara o las anotaciones con la escena real para comprobar la alineación. |
Not Found |
La solicitud no encontró el Block objetivo. Confirme que está in situ, que el Block se añadió a la base y que la cámara apunta a una zona con textura. Si persiste, consulte Solución de problemas de localización. |
QpsLimitExceeded |
Se superó la cuota QPS del grupo de servicios en la nube. Consulte Estimación y ampliación de QPS. |
UnKnownError |
Puede deberse a la red, la transferencia de datos o la respuesta del servicio. Consulte primero Solución de problemas de localización y grabe registros y datos si es necesario. |
Mostrar el archivo de máscara
Tras localizar correctamente un Block que admite archivos de máscara, active Archivo de máscara. El Mini Program carga y muestra su malla automáticamente, sin descargar el archivo ni crear anotaciones.
| N.º | Control | Descripción |
|---|---|---|
| 8 | Archivo de máscara |
Mostrar u ocultar la malla de máscara. |
| 9 | Control de opacidad | Ajustar la opacidad de la malla entre el 0% y el 100% para compararla con la imagen real de la cámara. |
El suelo y las superficies verticales se muestran en colores distintos y la malla se ocluye a sí misma. Compruebe paredes, suelos, juntas y esquinas, y observe temblores o deriva al mover el teléfono. Consulte Archivo de máscara.
Si la malla no aparece, compruebe que se localizó el Block objetivo, que su versión de mapeo cumple el requisito, que el interruptor está activado y la opacidad supera el 0%. Después, espere a que se cargue el recurso.
Ver las anotaciones
Si seleccionó un paquete antes de iniciar, su contenido aparece en la escena real tras la localización. Los cubos muestran una textura MEGA blanca cuando tiene éxito y gris cuando falla.
Compare las anotaciones con las posiciones reales elegidas al crearlas. Distinga entre un fallo de localización y temblores o deriva posteriores; para estos últimos, consulte Problemas de seguimiento.
Comunicar datos de localización anómalos
Si la localización falla, tiene un desfase, tiembla o deriva, grabe registros y datos dump mientras reproduce el problema. Debe elegir manualmente un destinatario al compartir los archivos.
En la página de localización, active
Grabar registrosyGrabar datos. Confirme que comenzó la grabación y reproduzca el problema.Después de reproducirlo, desactive
Grabar datospara detener la grabación.
En la interfaz para compartir de WeChat, seleccione
File Transfer Assistanty guarde el archivo de datos.
Vuelva a la página y desactive
Grabar registros. Guarde también el archivo de registros mediante WeChat. Termine las grabaciones y exportaciones antes de salir.Entregue al soporte técnico de EasyAR los archivos y una descripción del problema. Incluya la base de datos y el Block, la hora de prueba, el modelo de teléfono, las versiones del sistema y WeChat, los síntomas y los pasos para reproducirlo. Puede adjuntar capturas o vídeos.
Para grabar y exportar datos dump, consulte Grabar archivos dump con Mega Toolbox.