Resolución de problemas

Síntoma	Causa probable y solución
La app queda “Sin conexión”.	La aplicación anfitriona no está instalada/iniciada, o se esperó un tiempo fijo demasiado corto. Verifique que el anfitrión esté en el terminal y observe el estado de forma continua.
Todas las operaciones devuelven no autorizado.	El paquete de su aplicación no está habilitado en el servicio, o la llave de acceso es incorrecta. Solicite el alta del paquete y confirme la llave.
El binder es nulo.	El servicio aún no termina de enlazar. Reintente al detectar isConnected = true.
La banda no captura la tarjeta.	Se está usando lectura puntual en vez de open() + listener. Use el modelo por evento.
La cámara escanea una vez y la segunda vez es rechazada.	No se está liberando el listener al terminar. Llame a unregisterListener al recibir el resultado (el servicio limita a un cliente por componente).
La cámara responde error de inmediato.	En el modelo A1 la captura ocurre en la pantalla de la app anfitriona; esta debe estar en ejecución con una pantalla viva. Verifique que el anfitrión esté activo.
La imagen no sale en la impresión.	El nombre de archivo no se resuelve desde una app de terceros. Envíe la imagen como base64. Verifique además que el asset esté en src/main/assets/, no en res/assets/.