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:
nome | tipo | descrição |
---|---|---|
OcrResponses | Lista de OcrResponse | Identifica |
Objeto OcrResponse
nome | tipo | descrição |
---|---|---|
OcrKey | string | Identificador ú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) |
DocumentTemplate | ZaigIosOcrDocumentTemplate | Enumerador 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.ZaigIosOcrDocumentTemplate.NationalRegistryOfForeignersFront
- Identifica o resultado da validação da frente do Registro Nacional de Estrangeiros.ZaigIosOcrDocumentTemplate.NationalRegistryOfForeignersBack
- Identifica o resultado da validação do verso do Registro Nacional de Estrangeiros.
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:
classe | descrição |
---|---|
InvalidMobileToken | MobileToken enviado nas configurações é inválido. |
MissingPermission | Alguma das permissões necessárias para a validação não foi suficiente. |
NetworkFailure | O usuário perdeu a conexão com a internet durante a validação. |
ServerFailure | O servidor da QI Tech devolveu alguma resposta de erro para a SDK. |
MissingStorage | Não há espaço de armazenamento suficiente no dispositivo do usuário para que seja realizada a coleta da imagem. |
LowImageQuality | Por 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.