北京文通Android端名片识别开发手册解析.doc

Android平台 识别开发手册 文档修改记录： 日期 变更人 审核人 201 初稿 张志朋 2016-01 追加扫描功能集成薛尚 2016-01 优化开发手册 黄震 2016-06 更改识别动画 邹旭黄 目录 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 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比对； 使用截止时间与当前系统时间比对； 授权文件中核心版本号与底层核心版本号比对， 默认限制前两位； 项目名称与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项目的根目录下；注意拷贝