OCR iOS SDK 接入

├── OCR_private_pod
│   ├── LICENSE
│   ├── Libs
│   └── WBOCRService.podspec
├── README
├── WBOCRDemo
│   ├── Podfile
│   ├── Podfile.lock  
│   ├── Pods
│   ├── WBOCRDemo
│   ├── WBOCRDemo.xcodeproj
│   └── WBOCRDemo.xcworkspace
└── 接入指引.md


target 'WBOCRDemo' do
      pod 'WBOCRService',:path => '../OCR_private_pod'
end

├── Headers
│   ├── WBBankCardInfoModel.h
│   ├── WBIDCardInfoModel.h
│   ├── WBOCRConfig.h
│   ├── WBOCRService.h

• idcard 公民身份号码
• name 姓名
• sex 性别
• nation 民族
• address 住址
• birth 出生
• authority 签发机关
• validDate 有效期限
• frontFullImg 国徽面截图
• backFullImg 人像面截图
• orderNo 每次OCR识别请求的唯一订单号: 建议为32位字符串(不超过32位)
• sign 签名信息
• warning 识别结果警告信息
• multiWarning 多重告警码，人像面是 frontMultiWarning，国徽面对应 backMultiWarning
• clarity  图片清晰度，人像面是 frontClarity，国徽面对应 backClarity
• frontCode 人像面识别结果码 
• frontMsg  人像面识别结果描述
• backCode 国徽面识别结果码
• backMsg 国徽面识别结果描述

/// default NO, 设置成 YES 之后, 识别结果没有告警才判定为识别成功.
@property (nonatomic, assign) BOOL checkWarnings;
/**
 * @brief 设置识别超时时间，默认是20.0s
 */
@property (nonatomic) NSTimeInterval timeoutInterval;
/**
 * @brief 是否需要录制视频。此功能目前仅适用于身份证识别，默认为NO，即不录制；设置为 YES，识别成功之后，会返回长度不超过 3s 的视频地址
 */
@property (nonatomic) BOOL needRecordVideo ;
/**
 * @brief 控制身份证识别是否返回切边图, BOOL类型，默认值为 NO
 * 当这个值设置为 YES 的时候,进行身份证人像面识别时, 切边图会在 frontCrop 字段返回; 进行身份证国徽面识别时,切边图会在 backCrop 字段返回
 * 当这个值设置为 NO  的时候,进行身份证识别的时候, frontCrop 和 backCrop 返回 nil
 */
@property (nonatomic) BOOL retCrop;

/**
 * @brief WBOCRService 单例方法，通过调用该方法实例化 WBOCRService对象
 *
 * @return WBOCRService对象
 */
 + (nonnull instancetype) sharedService;

SDK支持身份证证件识别，提供 3 种识别模式，通过 WBOCRCardType 来定义。
/// * @brief  OCR SDK 提供证件的识别能力：身份证识别
///
/// WBOCRCardType 定义 SDK 不同的识别模式，下面描述这些模式：
/// 1. 身份证识别（识别身份证人像面和国徽面）
///     - WBOCRSDKTypeIDCardFrontSide: 身份证人像面识别模式，在 SDK 中完成人像面识别，识别完成之后，将本次识别结果返回第三方APP
///     - WBOCRSDKTypeIDCardBackSide: 身份证国徽面识别模式，在 SDK 中完成国徽面识别，识别完成之后，将本次识别结果返回第三方APP
///     - WBOCRSDKTypeIDCardContinuous:  身份证识别连拍模式，在 SDK 中完成人像面 + 国徽面识别，识别完成之后，将本次识别结果返回第三方APP

typedef NS_ENUM(NSInteger, WBOCRCardType) {
    WBOCRSDKTypeIDCardFrontSide = 1,
    WBOCRSDKTypeIDCardBackSide = 2,
    WBOCRSDKTypeIDCardContinuous = 7,
    WBOCRSDKTypeIDCardNormal NS_ENUM_DEPRECATED_IOS(9_0, 12_0,"User WBOCRSDKTypeIDCardContinuous") = 0,
};

/// 标准版本 SDK 登录接口, 这个接口完成 SDK 登录
/// @param sdkType     本次识别的卡证类型,详细参考 `WBOCRCardType`
/// @param appId       人脸核身控制台内申请的 WBappid
/// @param nonce       每次请求需要的一次性nonce，一次有效
/// @param userId      每个用户唯一的标识
/// @param sign        签名信息，由接入方后台提供，一次有效
/// @param orderNo     每次OCR识别请求的唯一订单号: 建议为32位字符串(不超过32位)
/// @param version     openAPI接口版本号,默认为1.0.0
/// @param license     由腾讯服务分配的,和 bundle id 关联****
/// @param succeed      SDK 登录成功
/// @param failed        SDK 登录失败
- (void)initSDKWithSDKType:(WBOCRCardType)sdkType
                     appId:(nonnull NSString *)appId
                     nonce:(nonnull NSString *)nonce
                    userId:(nonnull NSString *)userId
                      sign:(nonnull NSString *)sign
                   orderNo:(nonnull NSString *)orderNo
                   version:(nonnull NSString *)version
                   license:(nonnull NSString *)license
                   succeed:(nonnull WBOCRServiceInitSucceedBlock)succeed
                    failed:(nonnull WBOCRServiceFailedBlock)failed;
startService 接口如下, 通过 recognizeSucceed 接收识别成功回调，通过 failed 接收识别失败回调。
/// 标准版本 SDK 识别接口
/// @warning 调用这个接口前, 需要完成 SDK 登录, 即需要调用 initSDK 接口,并收到 succeed 回调
/// @param recognizeSucceed 识别成功回调
/// @param failed           识别失败回调
- (void) startOCRService:(nonnull WBOCRServiceRecognizeSuccessBlock)recognizeSucceed
                  failed:(nonnull WBOCRServiceFailedBlock)failed;