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