SDK接口调用

相机接口

具体返回格式见 数据接口

操作步骤：

1. 身份验证：调用 [[AipOcrService shardService] authWithAK:SK 或其他验证方法；

2. 初始化对应的ViewController，设置对应的block。 如 身份证本地扫描识别：

   UIViewController vc = [AipCaptureCardVC ViewControllerWithCardType:CardTypeLocalIdCardFont andImageHandler:^(UIImage image) { // 成功扫描出身份证 [[AipOcrService shardService] detectIdCardFrontFromImage:image withOptions:nil successHandler:^(id result){ // 在成功回调中，保存图片到系统相册 UIImageWriteToSavedPhotosAlbum(image, nil, nil, (__bridge void *)self); // 打印出识别结果 NSLog(@"%@", result); } failHandler:_failHandler]; }]; // 展示ViewController [self presentViewController:vc animated:YES completion:nil];

3. 在合适的地方启动ViewController: 如[self presentViewController:vc animated:YES completion:nil]

数据接口

该调用方法传入需要识别的UIImage，异步识别，识别完成之后，回调返回识别结果。

主要类为AipOcrService类，使用单例[AipOcrService sharedService]来调用相关接口即可。

操作步骤：

1. 身份验证：调用 [[AipOcrService shardService] authWithAK:SK 或其他验证方法；
2. 调用相应接口

• 通用文字识别（基础版、不含位置信息） detectTextBasicFromImage
• 通用文字识别（含位置信息） detectTextFromImage
• 通用文字识别（高精度、不含位置信息）detectTextAccurateBasicFromImage
• 通用文字识别（高精度、含位置信息）detectTextAccurateFromImage
• 通用文字识别 （含生僻字）detectTextEnhancedFromImage
• 网图识别 detectWebImageFromImage
• 身份证正面识别detectIdCardFrontFromImage
• 身份证背面识别detectIdCardBackFromImage
• 银行卡识别detectBankCardFromImage
• 驾驶证识别 detectDrivingLicenseFromImage
• 行驶证识别 detectVehicleLicenseFromImage
• 车牌识别 detectPlateNumberFromImage
• 营业执照识别 detectBusinessLicenseFromImage
• 通用票据识别 detectReceiptFromImage
• 增值税发票识别 detectValueAddedTaxImage
• 出租车票识别 detectTaxiReceiptImage
• VIN码识别 detectVinCodeImage
• 火车票识别 detectTrainTicketImage
• 数字识别 detectNumbersImage

所有回调函数均在后台线程中被调用，如需在主线程中操作，请使用[[NSOperationQueue mainQueue] addOperationWithBlock]patch到主线程中，示例参考demo工程。

以下以通用文字识别调用为例，其他接口的参数与返回可参考API文档

NSDictionary *options = @{@"language_type": @"CHN_ENG", @"detect_direction": @"true"};
[[AipOcrService shardService] detectTextFromImage:finalImage withOptions:options successHandler:^(id result) {
	// 成功识别的后续逻辑
} failHandler:^(NSError *err) {
	// 失败的后续逻辑
}];

options参数详情

• 结果返回

// 示例
{
    direction : 2,
    log_id : 676709620,
    words_result : [ {
            location : {
                height : 20;
                left : 86;
                top : 387;
                width : 22;
            };
            words : "N";
        },
    ],
    words_result_num : 1;
}

身份证质量控制

身份证本地质量控制已包含在[AipCaptureCardVC ViewControllerWithCardType:CardTypeLocalIdCardFont ....]之中。

相关的使用方法已在AipOcrSdk工程中开源，用户可根据自己的需要自行修改。

• 初始化

  [[AipOcrService shardService]getTokenSuccessHandler:^(NSString token) { //获取到身份证质量控制token// } failHandler:^(NSError error) {

  }]; // 利用获取到的token 完成 IdcardQualityAdaptor的初始化 IdcardQualityAdaptor *idcard = [[IdcardQualityAdaptor alloc]init];

  [idcard initWithToken:token];

• 检测图片

  • (IdcardQualityModel )process:(UIImage )image width:(int)width height:(int)height channel:(int)channel cardType:(idcard_quality::IdCardType)type;

options参数

• 释放资源

  • (void)releaseIdcardQuality;

特殊配置

截图分辨率系数

该系数影响到拍摄照片之后截取的图片大小

在AipOcrSdk/AipOcrSdk/View/AipCutImageView.m 中

//截图的分辨率系数 开发者可自行配置
static CGFloat const scale = 1.0;

图片放大/缩小系数

在AipOcrSdk/AipOcrSdk/View/AipCutImageView.m 中

//捏合操作最大/最小系数
static CGFloat const pinchMaxscale = 10.0;
static CGFloat const pinchMinscale = 0.5;