Skip to main content

Coletando os Retornos

class ViewController: UIViewController, ZaigIosOcrControllerDelegate {

// Do something if QI Tech OCR's SDK succesfully collected document picture
func zaigIosOcrController(_ ocrViewController: ZaigIosOcrController, didFinishWithResults response: ZaigIosOcrControllerResponse) {

}

// Do something if QI Tech OCR's SDK found any error when collecting document picture
func zaigIosOcrController(_ ocrViewController: ZaigIosOcrController, didFailWithError error: ZaigIosOcrControllerError) {

}

// Do something if the user canceled the picture collection on any steps
func zaigIosOcrControllerDidCancel(_ ocrViewController: ZaigIosOcrController) {

}
}

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

ZaigIosOcrControllerResponse

A classe ZaigIosOcrControllerResponse é 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:

nometipodescrição
OcrResponsesLista de OcrResponseIdentifica

Objeto OcrResponse

nometipodescrição
OcrKeystringIdentificador único da imagem na QI Tech. Você deve armazenar esse identificador para enviar na API da QI Tech que realizará a validação (ex.: API de Onboarding)
DocumentTemplateZaigIosOcrDocumentTemplateEnumerador que identifica a qual foto aquela OCR Key se refere.

Os valores possíveis do enumerador ZaigIosOcrDocumentTemplate podem ser:

  • ZaigIosOcrDocumentTemplate.CnhFull - Identifica o resultado da validação da CNH inteira.
  • ZaigIosOcrDocumentTemplate.CnhFront - Identifica o resultado da validação da frente da CNH.
  • ZaigIosOcrDocumentTemplate.CnhBack - Identifica o resultado da validação do verso da CNH.
  • ZaigIosOcrDocumentTemplate.RgFront - Identifica o resultado da validação da frente do RG.
  • ZaigIosOcrDocumentTemplate.RgBack - Identifica o resultado da validação do verso do RG.

ZaigIosOcrControllerError

A classe ZaigIosOcrControllerError é acionada no caso de algum erro que leve ao encerramento da SDK. Quando isso ocorrer, a QI Tech retornará uma subclasse que terá um nome correspondente ao erro que levou ao encerramento da SDK, conforme tabela abaixo:

classedescrição
InvalidMobileTokenMobileToken enviado nas configurações é inválido.
MissingPermissionAlguma das permissões necessárias para a validação não foi suficiente.
NetworkFailureO usuário perdeu a conexão com a internet durante a validação.
ServerFailureO servidor da QI Tech devolveu alguma resposta de erro para a SDK.
MissingStorageNão há espaço de armazenamento suficiente no dispositivo do usuário para que seja realizada a coleta da imagem.
LowImageQualityPor algum motivo a qualidade da imagem coletada não foi o suficiente para realização da validação.

Para mapear qual a subclasse, e portanto, qual o motivo do erro, utilize o método isKindOfClass() do swift.