Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Upload de arquivos e gerenciamento de QR

Introdução

A captura de documentos e a leitura e geração de QRs são realizadas com o CaptureComponent.

Este componente permitirá o envio de documentos tirando uma foto com a câmera do dispositivo ou a partir da galeria.

Dependência

A dependência específica do componente é:

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

Controladores disponíveis

Controlador

Descrição

FileUploaderController

Controlador para a captura de documentos

Recepção de erros

Os erros serão retornados como um objeto 'CaptureError'.

Lista de erros:

  • CAP_ACTIVITY_RESULT_MSG_ERROR: O resultado retornado pela atividade está incorreto ou não contém as informações necessárias para continuar.

  • CAP_APPLICATION_CONTEXT_ERROR: O contexto de aplicação necessário está nulo ou inválido, impedindo inicializar corretamente o módulo de captura.

  • CAP_CAMERA_ERROR: Ocorreu um erro interno relacionado à câmera do dispositivo (falha na abertura, inicialização ou captura).

  • CAP_CAMERA_PERMISSION_DENIED: O usuário negou as permissões necessárias para acessar a câmera.

  • CAP_CANCEL_BY_USER: O usuário cancelou manualmente o processo de captura.

  • CAP_CANCEL_LAUNCH: O processo foi cancelado de forma geral pelo SDK ou por uma ação externa.

  • CAP_COMPONENT_LICENSE_ERROR: A licença do componente não é válida, expirou ou não corresponde à configuração necessária.

  • CAP_EMPTY_LICENSE: A cadeia de licença está vazia ou não foi fornecida.

  • CAP_FETCH_DATA_ERROR: Ocorreu um erro ao obter ou processar os dados necessários para executar o Fluxo. (Inclui informações adicionais no campo error.)

  • CAP_FLOW_ERROR: Ocorreu um erro interno durante a execução do Fluxo de captura. (Inclui informações adicionais no campo error.)

  • CAP_INITIALIZATION_ERROR: Erro ao inicializar os componentes necessários do SDK. (Inclui informações detalhadas no campo error.)

  • CAP_FILE_UPLOADER_CAPTURE_ERROR: Erro durante o processo de envio dos arquivos gerados na captura.

  • CAP_IMAGE_TOO_LARGE: A imagem selecionada da galeria excede o tamanho máximo configurado em maxGalleryImageSizeKb.

  • CAP_MANAGER_NOT_INITIALIZED: Os managers necessários para executar o processo não foram inicializados corretamente.

  • CAP_NO_DATA_ERROR: Os dados de entrada necessários estão nulos, inexistentes ou insuficientes para continuar o processo.

  • CAP_OPERATION_NOT_CREATED: Não foi possível criar ou recuperar uma operação ativa necessária para continuar. (Inclui informações detalhadas no campo error.)

  • CAP_QR_CAPTURE_ERROR: Erro durante a captura ou leitura do Código QR.

  • CAP_QR_GENERATION_ERROR: Erro ao gerar o Código QR solicitado.

  • CAP_TIMEOUT: Foi atingido o tempo máximo permitido em alguma das fases do processo.

  • CAP_FLOW_VIDEO_RECORDING_ERROR: Erro durante a Gravação de Vídeo dentro do Fluxo estabelecido.

  • CAP_FLOW_TRACKING_ERROR: Erro ao realizar o Tracking necessário para completar o Fluxo de captura.

Configuração da captura de documentos

Em FileUploaderConfigurationData, juntamente com parâmetros como allowGallery e maxScannedDocs, é possível ajustar o comportamento da seleção na galeria:

  • onlyGalleryMode: Abre o Fluxo diretamente no modo galeria, sem exibir a captura com câmera. Por padrão true.

  • maxGalleryImageSizeKb: Tamanho máximo permitido para imagens selecionadas da galeria, em KB. Por padrão 2048. Se uma imagem exceder esse limite, o componente retorna CAP_IMAGE_TOO_LARGE.

Atualizado