Pular para o conteúdo principal

Coletando os Retornos

class ViewController: UIViewController, QITechIosOcrControllerDelegate {

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

}

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

}

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

}
}

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

QITechIosOcrControllerResponse

A classe QITechIosOcrControllerResponse é utilizada para que você possa receber a resposta do 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)
DocumentTemplateQITechIosOcrDocumentTemplateEnumerador que identifica a qual foto aquela OCR Key se refere.

Os valores possíveis do enumerador QITechIosOcrDocumentTemplate podem ser:

  • QITechIosOcrDocumentTemplate.CnhFull - Identifica o resultado da validação da CNH inteira.
  • QITechIosOcrDocumentTemplate.CnhFront - Identifica o resultado da validação da frente da CNH.
  • QITechIosOcrDocumentTemplate.CnhBack - Identifica o resultado da validação do verso da CNH.
  • QITechIosOcrDocumentTemplate.RgFront - Identifica o resultado da validação da frente do RG.
  • QITechIosOcrDocumentTemplate.RgBack - Identifica o resultado da validação do verso do RG.
  • QITechIosOcrDocumentTemplate.NationalRegistryOfForeignersFront - Identifica o resultado da validação da frente do Registro Nacional de Estrangeiros.
  • QITechIosOcrDocumentTemplate.NationalRegistryOfForeignersBack - Identifica o resultado da validação do verso do Registro Nacional de Estrangeiros.

QITechIosOcrControllerError

A classe QITechIosOcrControllerError é acionada no caso de algum erro que leve ao encerramento do SDK. Quando isso ocorrer, a QI Tech retornará uma subclasse que terá um nome correspondente ao erro que levou ao encerramento do 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 o 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.