Coletando os Retornos da SDK

Para obter as respostas da SDK , você deve implementar o delegate ZaigIosFaceRecognitionControllerDelegate em seu controller, conforme exemplo ao lado.

class ViewController: UIViewController, ZaigIosFaceRecognitionControllerDelegate {
    
    // Do something if QI Tech FaceRecognition's SDK succesfully collected document picture
    func zaigIosFaceRecognitionController(_ faceRecognitionViewController: ZaigIosFaceRecognitionController, didFinishWithResults response: ZaigIosFaceRecognitionControllerResponse) {
    
    }
    
    // Do something if QI Tech FaceRecognition's SDK found any error when collecting document picture
    func zaigIosFaceRecognitionController(_ faceRecognitionViewController: ZaigIosFaceRecognitionController, didFailWithError error: ZaigIosFaceRecognitionControllerError) {
        
    }
    
    // Do something if the user canceled the picture collection on any steps
    func zaigIosFaceRecognitionControllerDidCancel(_ faceRecognitionViewController: ZaigIosFaceRecognitionController) {

    }
}

ZaigIosFaceRecognitionControllerResponse

A classe ZaigIosFaceRecognitionControllerResponse é utilizada para que você possa receber a resposta da SDK da QI Tech.

Na tabela abaixo você encontra o detalhe de todas as propriedades desta classe:

Propriedades

Nome	Tipo	Descrição
FaceRecognitionKey	String	Identificador único da foto do rosto armazenado na QI Tech. Importante: Armazene este valor para enviar nas APIs de validação (ex.: API de Onboarding).

ZaigIosFaceRecognitionControllerError

A classe ZaigIosFaceRecognitionControllerError é acionada quando ocorre um erro que leva ao encerramento da SDK.

Aviso Importante!

A partir da versão 5.0.0, a estrutura de erros foi reformulada para fornecer informações mais detalhadas e diagnósticas.

Principais mudanças:

1. Novos tipos de erro: InvalidToken (substitui InvalidMobileToken)
2. Novas propriedades disponíveis:
   • status_code: Código HTTP do erro
   • reason: Identificador do motivo do erro
   • description: Descrição detalhada do erro

Estrutura de Erro (SDK 5.0.0+)

Exemplo: InvalidToken

{
    status_code: 401,
    reason: "INVALID_TOKEN",
    description: "Authentication token expired or invalid"
}

Tipos de Erro

SDK 5.0.0 e posteriores

Erro	Status Code	Descrição
InvalidToken	401	Token de autenticação expirado ou inválido (substitui InvalidMobileToken)

Versões anteriores à 5.0.0

Classe de Erro	Descrição
InvalidMobileToken	MobileToken enviado nas configurações é inválido (substituído por InvalidToken na v5.0.0+)
MissingPermission	Alguma das permissões necessárias não foi concedida
NetworkFailure	Perda de conexão com a internet durante a validação
ServerFailure	Resposta de erro do servidor da QI Tech
MissingStorage	Espaço de armazenamento insuficiente
LowImageQuality	Qualidade da imagem insuficiente para validação