Android平台名片开发手册

Android平台 名片识别开发手册

文档版本：2.2.0.3 起草时间：2015年10月

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

文档修改记录： 日期 2015-10 2016-01 2016-01 2016-06 2016-10 修改说明 初稿 追加扫描功能集成 优化开发手册 更改识别动画 文件上传138=1056=5132 变更人 张志朋 薛尚 黄震 邹旭黄 审核人 地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

1

目录

1 演示程序安装与激活 ........................................................................................................... 2

1.1 安装............................................................................................................................ 2 1.2 Android版本 ............................................................................................................... 2 1.3 激活方式介绍 ............................................................................................................ 2 2 拍摄注意事项 ....................................................................................................................... 3

2.1 一般要求 .................................................................................................................... 3 2.2 对拍摄图像的要求 .................................................................................................... 3 3 接口概述与集成说明 ........................................................................................................... 3 4 调用识别Activity ................................................................................................................. 4

4.1 识别参数说明 ............................................................................................................ 4 4.2 识别返回值说明 ........................................................................................................ 5 4.3示例代码 ..................................................................................................................... 6

4.3.1识别调用代码 ................................................................................................ 6 4.3.2接收返回值代码 ............................................................................................ 8

5、序列号在线激活方式集成步骤 ......................................................................................... 9

5.1 将assets文件夹、lib文件夹、libs文件夹全部按照下图的目录结构复制到集成的项目中： ............................................................................................................... 9 5.3 授权服务的代码集成(具体变量的定义请详见ImageChooser.java，该代码需在识别之前调用) ........................................................................................................... 12 5.4进入拍照识别界面代码： ...................................................................................... 13 5.5结果解析代码 .......................................................................................................... 13 5.6 结束 ......................................................................................................................... 13 6. 项目授权方式的集成步骤 ................................................................................................ 14

6.1用户向北京文通科技有限公司的销售提供需要绑定的一些参数，然后销售会给用户一个项目授权文件（authmode.lsc）；然后将assets文件夹、lib文件夹、libs文件夹全部按照下图的目录结构复制到集成的项目中并将新得到的authmode.lsc复制进集成项目中的assets文件夹内： ................................................................... 14 6.2打开要集成的项目的AndroidManifest.xml文件，将以下权限、相应的service和activity加入其中： ............................................................................................... 15 6.3进入拍照识别界面代码： ...................................................................................... 17 6.4更改开发码和对应的authmode.lsc文件 .............................................................. 17 6.5结果解析代码 .......................................................................................................... 18 6.6结束 .......................................................................................................................... 18

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

2

1 演示程序安装与激活

1.1 安装

安装中安名片演示程序BuCard_sample_sdk.apk。 1.2 Android版本

支持Android2.3 – 6.0

1.3 激活方式介绍

在首次调用时提供序列号或激活文件进行激活。 1、在线序列号激活方式。

由北京文通科技有限公司提供含有序列号的Excel文件，用户在调用程序中指定sn参数即用于该设备的某序列号，首次调用识别时设备须联网。可指定绑定设备deviceid或绑定SIM卡序号。默认绑定deviceid。

2、离线文件激活方式。

用户先提供北京文通科技有限公司含有deviceid或androidid的Excel文件（第一列为deviceid，第二列为androidid），然后北京文通科技有限公司提供对应设备的激活文件压缩包，压缩包中激活文件的 数目与设备数目一致，以[deviceid]_cp.txt命名，用户在调用程序中指定authfile参数即激活文件的路径和名称，首次调用时设备无需联网。如authfile参数为null或等于””时，默认激活文件路径为根目录下的[deviceid]_cp.txt，当激活文件存在时做此激活操作。

3、项目授权方式。

项目授权文件中限制如下内容：开发码参数、用户程序包名、识别核心版本号、使用截止时间、用户程序名称、用户公司名称；

开发码与调用识别时传递的devcode参数比对，开发码由北京文通科技有限公司与项目授权文件一并提供；

程序包名与AndroidMenifest.xml中package比对；

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

3

使用截止时间与当前系统时间比对；

授权文件中核心版本号与底层核心版本号比对， 默认限制前两位； 项目名称与strings.xml中app_name比对； 公司名称与strings.xml中company_name比对； 项目授权文件需放入项目assets文件夹中。

注意：如果使用1或2 所列的激活方式，请选择指定sn参数或authfile参数 ，不要同时指定sn参数和authfile参数，否则将只按1的方式进行激活，设置此两个参数请参见下文代码示例。 **采用项目授权无需调用验证授权服务

2 拍摄注意事项

目前支持的JPEG图像的分辨率为2048*1536像素及以下,1600*1200及以上。 2.1 一般要求

图像文字清晰，人眼可辨别； 对比度、亮度适中； 2.2 对拍摄图像的要求

拍摄时做好聚焦，以免图像模糊不清；

尽量不要使拍摄角度倾斜过大，以免造成图像变形成梯形；

3 接口概述与集成说明

用户可以调用Activity方式集成识别功能，识别Activity只支持JPG图片格式，用户可以通过调用函数的方式设置识别参数，详情见后面章节。

注意将“BuCard_sample_sdk集成所需文件”文件夹下的所有内容放到Android项目的根目录下；注意拷贝assets、lib、libs及res的内容到您的项目中；

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

9

5、序列号在线激活方式集成步骤

5.1 将assets文件夹、lib文件夹、libs文件夹全部按照下图的目录结构复制到集成的项目中：

先选中所有的jar包，然后add Path,右键lib文件夹点击Buid Path选项并选择config buid Path选项，点击Order and Export选项,ksoap2-android-assembly-2.4-jar-with-dependencies.jar、pki.jarandroid_auth.jar、bcprov-ext-jdk15-146.jar、android_auth.jar、bucard_sdk.jar、等全部勾选并点击“确定”按钮，如图:

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

10

将res的内容合并到您的项目中；注意将AndroidManifest.xml里面的内容和res/values/strings.xml的内容合并到项目相关文件中

5.2 打开要集成的项目的AndroidManifest.xml文件，将以下权限、相应的service和activity加入其中：

android:name=\

android:name=\

android:name=\

android:name=\

android:name=\

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

11

android:name=\

android:name=\

android:name=\ android:label=\

android:screenOrientation=\

android:name=\

android:name=\ android:configChanges=\ android:label=\

android:name=\

android:name=\

android:configChanges=\ android:screenOrientation=\

android:name=\

android:enabled=\

android:name=\

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

12

android:name=\

android:enabled=\

android:name=\

注册时请注意更换包名！！

5.3 授权服务的代码集成(具体变量的定义请详见ImageChooser.java，该代码需在识别之前调用)

授权服务的定义:（用户需将从销售手中获得的25位序列号替换sn,

ReturnAuthority变量为授权服务成功与否的标志，如果为0则证明授权成功）

public ServiceConnection authConn = new ServiceConnection() { @Override

public void onServiceDisconnected(ComponentName name) { authBinder = null; }

@Override public void onServiceConnected(ComponentName name, IBinder service) {

authBinder = (AuthService.authBinder) service; try {

AuthParameterMessage apm = new AuthParameterMessage();

// apm.datefile = \预留

apm.devcode =NameCardAuthParamters.DEVCODE;//5YYX5LQS5PAH6YC apm.sn = \

// apm.isCheckDevType=true;//强制验证设备型号开关

ReturnAuthority = authBinder.getBuCardAuth(apm); } catch (Exception e) {

Toast.makeText(getApplicationContext(), getString(R.string.license_verification_failed),

Toast.LENGTH_LONG).show(); } finally {

if (authBinder != null) { unbindService(authConn); }

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

13

} } };

授权服务的调用：（在Activity的onResume()中调用，必须在进入拍照界面前进行调用）

Intent authIntent = new Intent(ImageChooser.this,

AuthService.class);

bindService(authIntent, authConn, Service.BIND_AUTO_CREATE);

5.4进入拍照识别界面代码：

5.4.1手动拍照识别

请注意将CameraActivity添加到您的项目中

Intent intent = new Intent(); Intent intent = new Intent();

intent.setClass(ImageChooser.this, CameraActivity.class); intent.putExtra(\ImageChooser.this.finish(); startActivity(intent);

overridePendingTransition(R.anim.zoomin, R.anim.zoomout);

5.4.2扫描自动识别

Intent intent = new Intent();

intent.setClass(ImageChooser.this, CameraActivity.class); intent.putExtra(\ImageChooser.this.finish(); startActivity(intent);

overridePendingTransition(R.anim.zoomin, R.anim.zoomout);

5.5结果解析代码

结果解析识别代码请详见此方法：readRecogResult() 此方法位于BucardRunner.java中

5.6 结束

如果通过以上步骤进行集成，并出现相应的集成问题，请及时联系技术开发人员

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

14

6.项目授权方式的集成步骤

6.1用户向北京文通科技有限公司的销售提供需要绑定的一些参数，然后销售会给用户一个项目授权文件（authmode.lsc）；然后将assets文件夹、lib文件夹、libs文件夹全部按照下图的目录结构复制到集成的项目中并将新得到的authmode.lsc复制进集成项目中的assets文件夹内：

先选中所有的jar包，然后add Path,右键lib文件夹点击Buid Path选项并选择config buid Path选项，点击Order and Export选项,将android_auth.jar、bucard_sdk.jar、pki.jar等全部勾选并点击“确定”按钮，如图:

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

15

6.2打开要集成的项目的AndroidManifest.xml文件，将以下权限、相应的service和activity加入其中：

android:name=\

android:name=\

android:name=\

android:name=\

android:name=\

android:name=\

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

16

android:name=\

android:name=\ android:label=\

android:screenOrientation=\

android:name=\

android:name=\ android:configChanges=\ android:label=\

android:name=\

android:name=\

android:configChanges=\ android:screenOrientation=\

android:name=\

android:name=\

android:enabled=\

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

17

android:name=\

android:enabled=\

注册时请注意更换包名！！

6.3进入拍照识别界面代码：

6.3.1手动拍照识别

请注意将CameraActivity添加到您的项目中

Intent intent = new Intent(); Intent intent = new Intent();

intent.setClass(ImageChooser.this, CameraActivity.class); intent.putExtra(\ImageChooser.this.finish(); startActivity(intent);

overridePendingTransition(R.anim.zoomin, R.anim.zoomout);

6.3.2扫描自动识别

Intent intent = new Intent(); Intent intent = new Intent();

intent.setClass(ImageChooser.this, CameraActivity.class); intent.putExtra(\ImageChooser.this.finish(); startActivity(intent);

overridePendingTransition(R.anim.zoomin, R.anim.zoomout);

6.4更改开发码和对应的authmode.lsc文件

然后再打开res/values/strings.xml，将以下内容复制进去,其中的内容要改成用户提供的相应信息:

中安名片识别

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

18

北京文通科技有限公司 正在识别中...... 正在裁剪中......

6.5结果解析代码

结果解析识别代码请详见此方法：readRecogResult() 此方法位于BucardRunner.java中

6.6结束

如果通过以上步骤进行集成，并出现相应的集成问题，请及时联系技术开发人员。

地址：北京市海淀区北四环西路9号银谷大厦16层1609室

电话：（010）62800286/62800250 网址：www.wintone.com.cn

本文来源：https://www.bwwdw.com/article/jgwf.html