Troubleshooting

Errores de licencia

"Monolook license key required"

• Debes proporcionar una licenseKey en el constructor

"License validation failed"

• Comprueba que la license key es correcta
• Verifica que tu dominio está autorizado para esta licencia
• Comprueba tu conexión a internet

"BUILD_ID mismatch"

• Estás usando un build del SDK que no corresponde a tu licencia
• Contacta con soporte para una licencia actualizada

"Token expired"

• El SDK refresca tokens automáticamente
• Si persiste, comprueba que el reloj del sistema es correcto

Vídeo no se muestra

• Asegúrate de usar colorSpace = THREE.SRGBColorSpace en la textura
• Usa toneMapped = false en el material
• Usa flipX: true si el vídeo aparece en espejo

Tracking pobre

• Comprueba que la imagen del marker tiene suficiente contraste
• Mejora las condiciones de iluminación
• Usa un marker impreso más grande (mínimo 10x10 cm)
• Mantén la cámara estable
• Ver Buenos markers

WASM no carga

• Asegúrate de que minitrack-wasm.js está en el mismo directorio que minitrack-core.js
• Comprueba la consola del navegador
• Verifica que el servidor sirve .wasm con MIME type application/wasm

WebXR no funciona

• WebXR requiere HTTPS
• Comprueba que el navegador soporta WebXR (Chrome 90+, Firefox 88+)
• En iOS, WebXR no está disponible: usa el bridge AppClip

La cámara no se activa

• El usuario debe dar permiso de cámara
• HTTPS es obligatorio para acceso a cámara
• Algunos navegadores bloquean cámara en iframes: usa allow="camera" en el iframe