身份证识别文档

身份证识别接口文档

文档创建时间：2016-03-15

文档最后修改时间：2016-04-05

All rights reserved by Tianrui Workroom

? 1 Introduction

天瑞身份证识别适用于二代身份证上的文字识别（为了让更多初创企业使用该技术，本开发包免授权费）；开发包具有快速准确得到识别结果，占用手机资源少等特点，目前已与各大银行金融机构展开合作。

? 2 API Description

本SDK共有4个API接口，分别是：

初始化引擎接口"int openIdrEngine(String strDatFilePath);"；

识别接口"int recognizeIdrImage(int []imagePixels, int w, int h);"；

关闭引擎接口"int closeIdrEngine();"。

注意识别文本成功后，以下接口返回识别结果，否则返回null。

得到文本行的识别结果"String[] getWholeTextLineResult();"

2.1 打开引擎

int openIdrEngine(String strDatFilePath);

函数功能：打开引擎，完成引擎初始化工作，程序运行时调用一次即可

输入参数：strDatFilePath，dat文件的路径；

返回值：1，表示初始化成功

-1，表示初始化失败

2.2 识别文字

int recognizeIdrImage(int []imagePixels, int w, int h);

函数功能：定位并识别图像上的文字，并进行条目分类

输入参数：imagePixels，图像像素数据，格式为ARGB；

w，图像宽度

h，图像高度

返回值：1，表示识别成功

-1，表示失败

2.3 关闭引擎

int closeIdrEngine();

函数功能：关闭引擎，释放引擎申请的资源，程序退出时候执行一次

返回值：1，表示初始化成功，可忽略返回值

2.4 得到文本行字符串结果

String[] getWholeTextLineResult();

函数功能：得到所有文本词结果

返回值：文本词的识别结果字符串，返回null,表明识别结果为空，或者图像识别失败 3 Sample

int rlt = Native.openIdrEngine("/storage/emulated/0/ocr");//例如”TianruiWorkroomOCR.dat”文件保存到手机目录“/storage/emulated/0/ocr/TianruiWorkroomOCR.dat”

if (rlt != 1)

return;

Bitmap mBmppp = BitmapFactory.decodeFile(mImgFilePath); //得到Bitmap，mImgFilePath 为图像路径

int picw = mBmppp.getWidth();//得到图像宽

int pich = mBmppp.getHeight();//得到图像高

int[] pix = new int[picw * pich];//申请内存来保存图像的像素信息

mBmppp.getPixels(pix, 0, picw, 0, 0, picw, pich);//得到图像的像素信息，pix 保存ARGB 格式的pixels信息

rlt = Native.recognizeIdrImage(pix, picw, pich);

if (rlt != 1)

return;

String[] wholeTextLine = Native.getWholeTextLineResult(); Native.closeIdrEngine();