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:
| 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 | QITechIosOcrDocumentTemplate | Enumerador 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:
| 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 o 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.