Tratamento de erros
Todo o tratamento de erros do SDK iOS está centralizado nesta seção. O callback onErrorAcessoBioManager recebe um objeto ErrorBio que expõe getCode() e getDescription().
Códigos de erro
| Código | Descrição |
|---|---|
73000 | A sessão foi cancelada por um erro desconhecido e inesperado. O Unico Check SDK utiliza diversas APIs do iOS, incluindo câmera, armazenamento, segurança, rede e outras — este é um erro genérico para situações não previstas. |
73001 | Contexto inválido |
73003 | A versão da API precisa ser 13 ou superior |
73006 | Não foi possível abrir a câmera em emuladores |
73100 | Sem conexão com a internet |
73200 | Arquivo JSON unico_sdk não encontrado |
73202 | Não foi possível carregar o arquivo JSON unico_sdk |
73203 | Não foi possível carregar AcessoBioConfigDataSource |
73204 | Não foi possível inicializar o SDK — configure o ambiente via setEnvironment no build |
73300 | Não foi possível obter o objeto de autenticação unico |
73301 | Não foi possível interpretar o objeto de autenticação unico |
73302 | Token unico não encontrado |
73701 | Importação de liveness ativo não encontrada |
73702 | Não foi possível inicializar o liveness ativo em modo de produção |
73703 | Não foi possível obter a sessão de liveness ativo |
73704 | O usuário pressionou o botão de cancelamento e não concluiu a sessão |
73705 | A sessão não foi concluída com sucesso e um FaceScan não foi gerado |
73706 | Acesso à câmera negado — o usuário negou explicitamente a permissão ou a política do dispositivo bloqueia o acesso |
73707 | A sessão foi cancelada porque o app foi encerrado, entrou em modo de espera, recebeu uma notificação do sistema operacional ou foi enviado para segundo plano |
73708 | A sessão foi cancelada porque o dispositivo está no modo paisagem |
73709 | A sessão foi cancelada porque o dispositivo está no modo retrato invertido |
73710 | A sessão foi cancelada porque o usuário não conseguiu concluí-la dentro do tempo limite configurado |
73711 | A sessão foi cancelada devido a pressão de memória |
73712 | A sessão foi cancelada porque seu app não está em produção e requer uma conexão de rede |
73713 | A sessão foi cancelada porque sua chave precisa ser validada novamente |
73714 | A sessão foi cancelada porque a chave de criptografia configurada pelo desenvolvedor não era válida |
73715 | A sessão foi cancelada porque nem todas as imagens de orientação foram configuradas |
73716 | A sessão foi cancelada porque o SDK não conseguiu iniciar a câmera neste dispositivo |
73717 | A sessão foi cancelada porque o usuário estava em estado de bloqueio |
73718 | Erro desconhecido e inesperado durante o uso normal das APIs do iOS |
73719 | A sessão foi cancelada porque o usuário pressionou o texto de subtítulo da tela de preparação |
73720 | A sessão não foi processada |
73721 | A sessão não pode ser realizada: limite de tentativas excedido |
73722 | A sessão não pode ser realizada: timeout de alinhamento facial |
73730 | Não foi possível inicializar uma sessão de liveness ativo — erro de licença desconhecido |
73731 | Não foi possível inicializar uma sessão de liveness ativo — licença expirada |
73800 | Não foi possível construir a chave criptografada |
Catálogo oficial de erros
Os códigos acima refletem o catálogo do SDK iOS. O catálogo oficial de códigos de erro multiplataforma está disponível em Referência da API > Códigos de erro.
Callbacks do ciclo de vida
Além de onErrorAcessoBioManager, o SDK também dispara:
onUserClosedCameraManually()— o usuário fechou a câmera manualmente.onSystemClosedCameraTimeoutSession()— a sessão expirou por timeout (padrão 40 s, mínimo 40 s).onSystemChangedTypeCameraTimeoutFaceInference()— a detecção facial excedeu o limite de 13 s; a captura muda para o modo manual.