hanvonVehicleCard

vehiclecardImage clearCache

概述

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) {
                           api.alert({msg: JSON.stringify(ret)});
                       }
                   });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

clearCache

清除保存的切割图。

clearCache()

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18