hanvonVehicleCard

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

概述

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

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

配置方法:

  • 名称:hanvonVehicleCard
  • 参数:ios_api_key(iOS)
  • 参数:android_api_key(Android)
  • 配置示例:
  <feature name="hanvonVehicleCard">
        <param name="ios_api_key" value="f787970e-980d-4459-a793-b06966666666" />
        <param name="android_api_key" value="f787970e-980d-4459-a793-b06966666666" />
  </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对象
  • 内部字段:
{
    code : '0',            //字符串类型;返回码
                            //取值范围:
                            //0(成功)
                            //430(key illegal 没有有效的 key)
                            //431(whitelist illegal 请求不在白名单范围内)
                            //432(fingerprint illegal)
                            //433(package name illegal)
                            //434(serviceCode illegal 您没有申请相应的服务,或服务的次数已到临界值,或服务已到期)
                            //437(input is null 您的请求参数为空)
                            //438(input json format invalid 您的请求参数json 格式非法)
                            //439(image data is null 您的请求参数中图片数据为空)
                            //8101(recognize service exception 识别服务错误)
                            //8102(recognize core exception 不是有效的图片,请确保:1.图片格式为 JPEG,2. 行驶证应占图片的 1/2 或以上,3.分辨率至少为 300dpi,拍摄清晰)
    result : 'A7ADEA0C-A7AB-4697-B772-E6DB2C9248FB',       //字符串类型;消息内容
    vehicleCard : {       //JSON对象;行驶证
        plateno : '辽AAxxxx',   //字符串类型;车牌号码
        vehicletype : '重型半挂牵引车',    //字符串类型;车辆类型
        owner : '沈阳xx有限公司',        //字符串类型;所有人
        veaddress : '沈阳市xx路xx号',        //字符串类型;住址
        usecharacter : '货运',    //字符串类型;使用性质
        engineno : 'C1000000',                //字符串类型;发动机号码
        model : '东风牌',                //字符串类型;品牌型号
        vin : 'LGAG4DYxxxxxxxx',    //字符串类型;车辆识别代码
        registerdate : '2012-03-11',    //字符串类型;注册日期
        issuedate : '2012-03-12',        //字符串类型;发证日期
        cropped_image : null  //字符串类型;切割图经base64编码的字符串(仅切图版有值)
        destPath : ''            //字符串类型;切割图保存的路径,只有参数cropped和cropPath都为true时才返回,否则不返回
    }
}

示例代码

var hanvonVehicleCard = api.require('hanvonVehicleCard');
hanvonVehicleCard.vehiclecardImage({
                       path:'widget://res/vehiclecard.jpg',
                       cropped:true,
                       https:false
                   },function(ret, err) {
                       if (ret) {
                           alert(JSON.stringify(ret));
                       }
                   });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

clearCache

清除保存的切割图。

clearCache()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本