Tratamento de erros

Todo o tratamento de erros do SDK Android está centralizado nesta seção. O callback onErrorAcessoBio recebe um objeto ErrorBio com code (Int) e description (String).

Tratando o callback

Kotlin

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    73002 -> { /* camera permission denied — redirect to app settings */ }
    73006 -> { /* running on emulator — physical device required */ }
    73100 -> { /* no internet connection */ }
    else -> { /* generic error handling */ }
  }
}

Java

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case 73002: /* camera permission denied — redirect to app settings */ break;
    case 73006: /* running on emulator — physical device required */ break;
    case 73100: /* no internet connection */ break;
    default: /* generic error handling */
  }
}

Callbacks de ciclo de vida

Além de onErrorAcessoBio, o SDK também dispara:

• onUserClosedCameraManually() — usuário fechou a câmera manualmente.
• onSystemClosedCameraTimeoutSession() — sessão expirada por timeout.
• onSystemChangedTypeCameraTimeoutFaceInference() — nenhum rosto detectado em 13 segundos; o SDK muda para captura manual.

Códigos de erro

Todos os códigos de erro têm origem no enum UnicoException e são entregues via ErrorBio(code, message). O campo message contém a string exata do SDK — não modifique nem localize.

Código	Mensagem	Descrição
73001	Context invalid	Contexto Android inválido passado ao SDK
73002	Did not grant permission to open camera	Permissão de câmera negada pelo usuário
73003	The lest API is 21(LOLLIPOP	Nível de API do dispositivo abaixo do mínimo exigido (API 21)
73004	Could not find implementation interface callback iAcessoBioSelfie	Interface iAcessoBioSelfie não implementada
73005	Could not find implementation interface callback iAcessoBioDocument	Interface iAcessoBioDocument não implementada
73006	Unable to open camera on emulators	O SDK não funciona em emuladores — use um dispositivo físico
73007	Unknown and unexpected error in WebApp…	Erro genérico de WebApp (câmera, armazenamento, segurança, rede)
73100	Unable to connect to internet.	Sem conexão com a internet
73200	Please inform the config object or json file name	Objeto de configuração ou arquivo JSON não fornecido
73202	Unable to parse json file	Arquivo de configuração JSON malformado
73204	Unable to initialize the SDK, please configure the environment on setEnviroment method of build	setEnvironment() não foi chamado antes da inicialização
73300	Unable to get unico authentication object	Falha ao recuperar o objeto de autenticação
73301	Unable to parse object	Falha ao fazer parse da resposta de autenticação
73302	Could not find the unico token	Token de autenticação Unico não encontrado
73303	Current host is not registered	Identificador de bundle não registrado na SDK Key
73400	Could not initialize camera	Falha na inicialização da câmera
73701	Could not find active liveness import	Módulo de liveness ativo não encontrado
73703	Unable to get active liveness session	Falha ao obter uma sessão de liveness
73718	The Session was cancelled because of an unknown and unexpected error…	Erro interno desconhecido na sessão
73721	The Session can't be performed: attempts limit exceeded.	Sessão cancelada — limite de tentativas de captura atingido
73722	The Session can't be performed: face alignment timeout.	Sessão cancelada — timeout de alinhamento facial
73726	An error happened during video recording	Erro de gravação de vídeo durante o liveness
73727	No actions found in a video	Nenhuma ação de liveness detectada no vídeo
73740	The user pressed the do not consent button and did not complete the Session.	Usuário recusou o consentimento
73800	Could not build encrypted key.	Falha ao construir o JWT criptografado
73801	The Session of SDK was cancelled because of an unknown and unexpected error.	Erro interno desconhecido na sessão do SDK
73802	The Session was cancelled because of an unknown and unexpected error…	Sessão cancelada — campos obrigatórios do JWT ausentes
73900	Erro ao analisar imagem	Erro ao analisar a imagem capturada
73901	É necessário implementar a interface AcessoBioListener	Interface AcessoBioListener não implementada
73902	É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.	O valor de setTimeoutSession deve ser maior que 40 segundos
73903	Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.	Arquivo de configuração corrompido — verifique e tente novamente
73904	Erro ao finalizar processo	Erro ao finalizar o processo de captura
73905	Unable to open document camera	A câmera de documentos não pôde ser aberta
73906	Document type uninformed	Tipo de documento não especificado
74001	onSuccess: not implemented when using open:webAppToken:	Callback onSuccess não implementado para User Journey
74100	Could not prepare SDK-S	Falha ao preparar os componentes do SDK
74101	No URL token was provided.	Nenhum token de URL fornecido para a jornada
74102	Environment type was not specified.	Ambiente (PROD/UAT) não configurado
737120	Unable to initialize liveness	A activity de liveness não pôde ser inicializada
737220	Capture could not start	O processo de captura falhou ao iniciar
737320	Transaction could not start	A transação não pôde ser iniciada
737321	The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.	Erro genérico do provedor de sessão — tente novamente

Códigos de erro da REST API

Os códigos acima são erros de callback do SDK. Os códigos de erro da REST API (famílias de status HTTP) estão documentados separadamente em Referência de API > Códigos de erro.