收集返回值

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) {

    }
}

要获取 SDK 的响应，您需要在 controller 中实现 ZaigIosOcrControllerDelegate 委托，如旁边示例所示。

ZaigIosOcrControllerResponse

ZaigIosOcrControllerResponse 类用于接收 QI Tech SDK 的响应。

下表详细列出了此类的所有属性：

名称	类型	描述
OcrResponses	OcrResponse 列表	标识

OcrResponse 对象

名称	类型	描述
OcrKey	string	QI Tech 中图片的唯一标识符。您必须存储此标识符，以便在执行验证的 QI Tech API 中发送（例如：Onboarding API）
DocumentTemplate	ZaigIosOcrDocumentTemplate	标识该 OCR Key 对应照片的枚举值。

ZaigIosOcrDocumentTemplate 枚举的可能值为：

• ZaigIosOcrDocumentTemplate.CnhFull - 标识完整 CNH 验证的结果。
• ZaigIosOcrDocumentTemplate.CnhFront - 标识 CNH 正面验证的结果。
• ZaigIosOcrDocumentTemplate.CnhBack - 标识 CNH 背面验证的结果。
• ZaigIosOcrDocumentTemplate.RgFront - 标识 RG 正面验证的结果。
• ZaigIosOcrDocumentTemplate.RgBack - 标识 RG 背面验证的结果。
• ZaigIosOcrDocumentTemplate.NationalRegistryOfForeignersFront - 标识外国人国家登记证正面验证的结果。
• ZaigIosOcrDocumentTemplate.NationalRegistryOfForeignersBack - 标识外国人国家登记证背面验证的结果。

ZaigIosOcrControllerError

ZaigIosOcrControllerError 类在出现导致 SDK 终止的错误时触发。发生此情况时，QI Tech 将返回一个子类，其名称对应于导致 SDK 终止的错误，如下表所示：

类	描述
InvalidMobileToken	配置中发送的 MobileToken 无效。
MissingPermission	验证所需的某些权限不足。
NetworkFailure	用户在验证过程中失去了互联网连接。
ServerFailure	QI Tech 服务器向 SDK 返回了错误响应。
MissingStorage	用户设备没有足够的存储空间进行图片采集。
LowImageQuality	由于某种原因，采集的图片质量不足以进行验证。

要确定是哪个子类（即错误原因），请使用 Swift 的 isKindOfClass() 方法。