hanvonVehicleCard

来自于：AC模块工作室立即使用

vehiclecardImage clearCache

概述

hanvonVehicleCard 封装了汉王行驶证云识别SDK。采用标准https 方式进行所有请求的发送，您也可以选择使用http。用户首先需要访问汉王开发者中心进行用户注册，通过邮箱激活您的用户名后，进行云识别相关服务申请，在Key 管理页面处，创建您的 iOS Key,接下来即可开始您的云识别开发。详情请参考网站帮助。

使用此模块之前需先配置 config.xml 文件，方法如下

配置方法：

  • 名称：hanvonVehicleCard

  • 参数：ios_api_key(iOS)

  • 参数：android_api_key(Android)

  • 配置示例:

  1.   <feature name="hanvonVehicleCard">
  2.         <param name="ios_api_key" value="f787970e-980d-4459-a793-b06966666666" />
  3.         <param name="android_api_key" value="f787970e-980d-4459-a793-b06966666666" />
  4.   </feature>

  • 字段描述:

    ios_api_key：在汉王云开发者中心申请的iOS 端 key android_api_key：在汉王云开发者中心申请的Android 端 key

使用此模块如果采用http 方式进行请求的发送

iOS端需要配置ATS（App Transport Security），具体配置方法参考[APP开发技巧] 【官方】iOS修改Info.plist 中“三.3. 配置ATS（App Transport Security）”

vehiclecardImage

对行驶证图片进行识别。

vehiclecardImage({params}, callback(ret, err))

params

path：

  • 类型：字符串
  • 描述：源图片路径，支持fs://、widget://等文件路径协议。
  • 默认：无

cropped：

  • 类型：布尔
  • 描述：（可选）切图版：true； 普通版：false。
  • 默认：false

https：

  • 类型：布尔
  • 描述：（可选）https：true； http：false。
  • 默认：true

cropPath：

  • 类型：布尔
  • 描述：（可选）在cropped为true时才有效。为true返回切割图路径和切割图经base64编码的字符串，为false只返回切割图经base64编码的字符串

  • 默认：true

    callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     code : '0',            //字符串类型；返回码
  3.                             //取值范围：
  4.                             //0(成功)
  5.                             //430(key illegal 没有有效的 key)
  6.                             //431(whitelist illegal 请求不在白名单范围内)
  7.                             //432(fingerprint illegal)
  8.                             //433(package name illegal)
  9.                             //434(serviceCode illegal 您没有申请相应的服务，或服务的次数已到临界值，或服务已到期)
  10.                             //437(input is null 您的请求参数为空)
  11.                             //438(input json format invalid 您的请求参数json 格式非法)
  12.                             //439(image data is null 您的请求参数中图片数据为空)
  13.                             //8101(recognize service exception 识别服务错误)
  14.                             //8102(recognize core exception 不是有效的图片，请确保：1.图片格式为 JPEG，2. 行驶证应占图片的 1/2 或以上，3.分辨率至少为 300dpi，拍摄清晰)
  15.     result : 'A7ADEA0C-A7AB-4697-B772-E6DB2C9248FB',       //字符串类型；消息内容
  16.     vehicleCard : {       //JSON对象；行驶证
  17.         plateno : '辽AAxxxx',   //字符串类型；车牌号码
  18.         vehicletype : '重型半挂牵引车',    //字符串类型；车辆类型
  19.         owner : '沈阳xx有限公司',        //字符串类型；所有人
  20.         veaddress : '沈阳市xx路xx号',        //字符串类型；住址
  21.         usecharacter : '货运',    //字符串类型；使用性质
  22.         engineno : 'C1000000',                //字符串类型；发动机号码
  23.         model : '东风牌',                //字符串类型；品牌型号
  24.         vin : 'LGAG4DYxxxxxxxx',    //字符串类型；车辆识别代码
  25.         registerdate : '2012-03-11',    //字符串类型；注册日期
  26.         issuedate : '2012-03-12',        //字符串类型；发证日期
  27.         cropped_image : null  //字符串类型；切割图经base64编码的字符串（仅切图版有值）
  28.         destPath : ''            //字符串类型；切割图保存的路径,只有参数cropped和cropPath都为true时才返回，否则不返回
  29.     }
  30. }

示例代码

  1. var hanvonVehicleCard = api.require('hanvonVehicleCard');
  2. hanvonVehicleCard.vehiclecardImage({
  3.                        path:'widget://res/vehiclecard.jpg',
  4.                        cropped:true,
  5.                        https:false
  6.                    },function(ret, err) {
  7.                        if (ret) {
  8.                            alert(JSON.stringify(ret));
  9.                        }
  10.                    });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

clearCache

清除保存的切割图。

clearCache()

示例代码

  1. var hanvonVehicleCard = api.require('hanvonVehicleCard');
  2. hanvonVehicleCard.clearCache();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本