目录
7.2配置AndroidManifest.xml文件, 18
10.SIM卡授权方式的集成步骤(请参照序列号集成步骤) 35
1 演示程序安装与激活
1.1 安装
安装文通车牌演示程序plate_id_sample_service.apk。
1.2 Android版本
支持Android2.3 – 5.1
1.3 激活方式介绍
在首次调用时提供序列号或激活文件进行激活。
1、 在线序列号激活方式。
由文通公司提供含有序列号的Excel文件,用户在调用程序中指定sn参数即用于该设备的某序列号,首次调用识别时设备须联网。可指定绑定设备deviceid或绑定SIM卡序号。默认绑定deviceid。
2、 离线文件激活方式。
用户先提供文通公司含有deviceid或androidid的Excel文件(第一列为deviceid,第二列为androidid),然后文通公司提供对应设备的激活文件压缩包,压缩包中激活文件的数目与设备数目一致,以[deviceid]_cp.txt命名,用户在调用程序中指定authfile参数即激活文件的路径和名称,首次调用时设备无需联网。如authfile参数为null或等于””时,默认激活文件路径为根目录下的[deviceid]_cp.txt,当激活文件存在时做此激活操作。
3、 TF卡模式。
需使用文通公司授权的TF卡。
4、 项目授权方式。
项目授权文件中限制如下内容:开发码参数、用户程序包名、识别核心版本号、使用截止时间、用户程序名称、用户公司名称;
开发码与调用识别时传递的devcode参数比对,开发码由文通公司与项目授权文件一并提供;
程序包名与AndroidMenifest.xml中package比对;
使用截止时间与当前系统时间比对;
授权文件中核心版本号与底层核心版本号比对, 默认限制前两位;
项目名称与strings.xml中app_name比对;
公司名称与strings.xml中company_name比对;
项目授权文件需放入项目assets文件夹中。
注意:如果使用1或2 所列的激活方式,请选择指定sn参数或authfile参数 ,不要同时指定sn参数和authfile参数,否则将只按1的方式进行激活,设置此两个参数请参见下文代码示例。
**采用项目授权无需调用验证授权服务
2 拍摄注意事项
目前支持的JPEG图像的分辨率为2048*1536像素及以下,支持图像中车牌的默认实际宽度为80-400像素。
2.1 一般要求
图像文字清晰,人眼可辨别;
对比度、亮度适中;
2.2 对拍摄图像的要求
拍摄时做好聚焦,以免图像模糊不清;
拍摄时不要使车牌过度倾斜;
尽量不要使拍摄角度倾斜过大,以免造成图像变形成梯形;
3 接口概述与集成说明
用户可以调用Activity或Service的方式集成识别功能,识别Activity只支持JPG图片格式,识别Service也支持JPG图片格式,推荐使用Service方式集成;用户可以通过调用函数的方式设置识别参数,详情见后面章节。
注意将“plate_id_sdk集成所需文件”文件夹下的所有内容放到Android项目的根目录下;注意拷贝assets、lib、libs及res的内容到您的项目中;注意将AndroidManifest.xml里面的内容和res/values/strings.xml的内容合并到项目相关文件中;如果采用TF卡授权方式,请将 “TF”文件夹中的相关文件替换到项目中;如果采用序列号激活方式绑定设备,请将“序列号” 文件夹中的相关文件替换到项目中;
注意当与文通Android证件识别集成到一个项目中时,请删除lib文件夹下的misc_crypto.jar(如果有的话),否则会引起冲突。
4 调用识别Activity(V1.3.0.5不再使用)
4.1 识别参数说明
识别Activity具有如下参数:
类型 |
名称 |
说明 |
示例 |
String |
cls |
接收识别返回值的包名类名 |
com.wintone.demo.PlateIDRunner |
String |
pic |
图片路径 |
|
int |
imageformat |
图像格式 |
1 |
int |
width |
图像宽度 |
420 |
int |
height |
图像高度 |
232 |
int |
bVertFlip |
|
0 |
int |
bDwordAligned |
|
1 |
boolean |
GetVersion |
是否需要获取开发包的版本信息 |
true |
String |
sn |
序列号,第一次调用时激活,如不设置此项需通过自动激活或手动激活页面输入序列号。 |
请输入大写序列号 |
String |
authfile |
激活文件路径,激活文件中保存了用于该设备的序列号和激活码,不用时可设置为”” |
|
String |
userdata |
用户想在识别后和识别结果一起传回的字符串 |
|
String |
returntype |
接收识别结果的方式 |
默认值””,代表用第一种方式接收识别结果;值”withvalue”代表用第二种方式。详见示例程序章节。 |
4.2 识别返回值说明
识别Activity具有如下返回值:
类型 |
名称 |
说明 |
备注 |
int |
nRet |
识别结果标志 |
0成功; 1 FindPlate(没有找到车牌) 2 车牌评价值(0分) 3 车牌评价值(不及格) 4 车牌识别分数(0分) 5 车牌识别分数(不及格) -1001 读jpg图片错误,可能是图片超过2048*1536分辨率 -10001 未调用初始化函数 -10003 没有激活或激活码校验失败 -10004 指定序列号为null或"" -10005 未连接到服务器 -10006 获取激活码失败或未连接到服务器 -10007 授权服务器无此序列号 -10008 序列号已使用 -10009 无法创建授权文件 -10010 校验激活码失败 -10011 其他错误 -10012 未激活 |