For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Saltar al contenido

Subida de ficheros y gestión de QR

Introducción

La captura de documentos y la lectura y generación de QRs se realizan con el CaptureComponent.

Este componente permitirá la subida de documentos realizando una foto con la cámara del dispositivo o desde galeria.


Dependencia

La dependencia específica del componente es:

implementation "com.facephi.androidsdk:capture_component:$version"

Controladores disponibles

Controlador

Descripción

FileUploaderController

Controlador para la captura de documentos


Recepción de errores

Los errores se devolverán como un objeto 'CaptureError'.

Listado de errores:

  • CAP_ACTIVITY_RESULT_MSG_ERROR: El resultado devuelto por la actividad es incorrecto o no contiene la información necesaria para continuar.

  • CAP_APPLICATION_CONTEXT_ERROR: El contexto de aplicación requerido es nulo o no válido, impidiendo inicializar correctamente el módulo de captura.

  • CAP_CAMERA_ERROR: Ha ocurrido un error interno relacionado con la cámara del dispositivo (fallo de apertura, inicialización o captura).

  • CAP_CAMERA_PERMISSION_DENIED: El usuario ha denegado los permisos necesarios para acceder a la cámara.

  • CAP_CANCEL_BY_USER: El usuario ha cancelado manualmente el proceso de captura.

  • CAP_CANCEL_LAUNCH: El proceso ha sido cancelado de forma general por el SDK o por una acción externa.

  • CAP_COMPONENT_LICENSE_ERROR: La licencia del componente no es válida, ha expirado o no coincide con la configuración requerida.

  • CAP_EMPTY_LICENSE: La cadena de licencia está vacía o no se ha proporcionado.

  • CAP_FETCH_DATA_ERROR: Se ha producido un error al obtener o procesar los datos necesarios para ejecutar el flujo. (Incluye información adicional en el campo error.)

  • CAP_FLOW_ERROR: Se ha producido un error interno durante la ejecución del flujo de captura. (Incluye información adicional en el campo error.)

  • CAP_INITIALIZATION_ERROR: Error al inicializar los componentes necesarios del SDK. (Incluye información detallada en el campo error.)

  • CAP_FILE_UPLOADER_CAPTURE_ERROR: Error durante el proceso de subida de los archivos generados en la captura.

  • CAP_IMAGE_TOO_LARGE: La imagen seleccionada desde galería supera el tamaño máximo configurado en maxGalleryImageSizeKb.

  • CAP_MANAGER_NOT_INITIALIZED: Los managers necesarios para ejecutar el proceso no han sido inicializados correctamente.

  • CAP_NO_DATA_ERROR: Los datos de entrada requeridos son nulos, inexistentes o insuficientes para continuar el proceso.

  • CAP_OPERATION_NOT_CREATED: No se ha podido crear o recuperar una operación activa necesaria para continuar. (Incluye información detallada en el campo error.)

  • CAP_QR_CAPTURE_ERROR: Error durante la captura o lectura del código QR.

  • CAP_QR_GENERATION_ERROR: Error al generar el código QR solicitado.

  • CAP_TIMEOUT: Se ha alcanzado el tiempo máximo permitido en alguna de las fases del proceso.

  • CAP_FLOW_VIDEO_RECORDING_ERROR: Error durante la grabación de vídeo dentro del flujo establecido.

  • CAP_FLOW_TRACKING_ERROR: Error al realizar el tracking necesario para completar el flujo de captura.

Configuración de la captura de documentos

En FileUploaderConfigurationData, junto a parámetros como allowGallery y maxScannedDocs, se puede ajustar el comportamiento de la selección desde galería:

  • onlyGalleryMode: Abre el flujo directamente en modo galería, sin mostrar la captura con cámara. Por defecto true.

  • maxGalleryImageSizeKb: Tamaño máximo permitido para imágenes seleccionadas desde galería, en KB. Por defecto 2048. Si una imagen supera este límite, el componente devuelve CAP_IMAGE_TOO_LARGE.

Última actualización