简介
本文档提供关于身份证识别的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
支持中国大陆居民二代身份证正反面所有字段的识别，包括姓名、性别、民族、出生日期、住址、公民身份证号、签发机关、有效期限；具备身份证照片、人像照片的裁剪功能和翻拍、PS、复印件告警功能，以及边框和框内遮挡告警、临时身份证告警和身份证有效期不合法告警等扩展功能。 |
SDK API 参考
身份证识别
功能说明
支持中国大陆居民二代身份证正反面所有字段的识别，包括姓名、性别、民族、出生日期、住址、公民身份证号、签发机关、有效期限；具备身份证照片、人像照片的裁剪功能和翻拍、PS、复印件告警功能，以及边框和框内遮挡告警、临时身份证告警和身份证有效期不合法告警等扩展功能。
说明：
COS iOS SDK 版本需要大于等于 v6.2.9。
示例代码
Objective-C
QCloudAIIDCardOCRRequest * request = [QCloudAIIDCardOCRRequest new];request.bucket = @"sample-1250000000";request.regionName = @"COS_REGIONNAME";// 设置：ObjectKey;request.ObjectKey = @"";// 数据万象处理能力，身份证识别固定为 IDCardOCR;是否必传：true；request.ciProcess = @"IDCardOCR";// FRONT：身份证有照片的一面（人像面）BACK：身份证有国徽的一面（国徽面）该参数如果不填，将为您自动判断身份证正反面;是否必传：false；request.CardSide = @"";// 以下可选字段均为 bool 类型，默认 false：CropIdCard，身份证照片裁剪（去掉证件外多余的边缘、自动矫正拍摄角度）CropPortrait，人像照片裁剪（自动抠取身份证头像区域）CopyWarn，复印件告警BorderCheckWarn，边框和框内遮挡告警ReshootWarn，翻拍告警DetectPsWarn，PS 检测告警TempIdWarn，临时身份证告警InvalidDateWarn，身份证有效日期不合法告警Quality，图片质量分数（评价图片的模糊程度）MultiCardDetect，是否开启多卡证检测参数设置方式参考：Config = {"CropIdCard":true,"CropPortrait":true};是否必传：false；request.Config = @"";[request setFinishBlock:^(QCloudAIIDCardOCRResponse * outputObject, NSError *error) {// result：QCloudAIIDCardOCRResponse 包含所有的响应；// 具体查看代码注释或api文档：https://cloud.tencent.com/document/product/460/48638}];[[QCloudCOSXMLService defaultCOSXML] AIIDCardOCR:request];
注意：
Swift
let request : QCloudAIIDCardOCRRequest = QCloudAIIDCardOCRRequest();// 设置：objectKey;request.objectKey = "objectKey";request.bucket = "sample-1250000000";request.regionName = "COS_REGIONNAME";// 数据万象处理能力，身份证识别固定为 IDCardOCR;是否必传：true；request.ciProcess = "IDCardOCR";// FRONT：身份证有照片的一面（人像面）BACK：身份证有国徽的一面（国徽面）该参数如果不填，将为您自动判断身份证正反面;是否必传：false；request.cardSide = "";// 以下可选字段均为 bool 类型，默认 false：CropIdCard，身份证照片裁剪（去掉证件外多余的边缘、自动矫正拍摄角度）CropPortrait，人像照片裁剪（自动抠取身份证头像区域）CopyWarn，复印件告警BorderCheckWarn，边框和框内遮挡告警ReshootWarn，翻拍告警DetectPsWarn，PS 检测告警TempIdWarn，临时身份证告警InvalidDateWarn，身份证有效日期不合法告警Quality，图片质量分数（评价图片的模糊程度）MultiCardDetect，是否开启多卡证检测参数设置方式参考：Config = {"CropIdCard":true,"CropPortrait":true};是否必传：false；request.config = "";request.finishBlock = { result, error in// result：QCloudAIIDCardOCRResponse 包含所有的响应；// 具体查看代码注释或api文档：https://cloud.tencent.com/document/product/460/48638};QCloudCOSXMLService.defaultCOSXML().aiIDCardOCR(request);
注意：
