hanvonCloudTableReader

来自于:汉王立即使用

概述

hanvonCloudTableReader模块封装了汉王云文本商务版识别的sdk,可通过选择相册中的文本(包含表格)读取文本信息。

在集成此模块之前可先配置config文件,也可不配置config文件直接从前端js将androidkey或ioskey传入模块原生代码。在config里添加如下字段:

名称:HanvonCloudTable

参数:androidkey, ioskey

描述:androidkey即是从汉王云官网开发者中心 应用管理 Key管理中生成的android key, ioskey即是从汉王云官网开发者中心 应用管理 Key管理中生成的iOS key

  • 配置示例:
<feature name="hanvonCloudTableReader"> 
<param name="androidkey" value="163114c8-31b5-4424-bb85-617f81cf54d9" /> 
<param name="ioskey" value="ffa49301-d271-4ecc-8a3c-5a165eb5768d"/> 
</feature>

recognitionTable

识别文本

recognitionTable(params,callback(ret, err))

params

androidkey:

  • 类型:字符串
  • 描述:在汉王云官网申请的android key

ioskey:

  • 类型:字符串
  • 描述:在汉王云官网申请的iOS key

picpath:

  • 类型:字符串
  • 描述:文本的存放路径

type:

  • 类型: 字符串
  • 描述:返回的数据类型
  • 默认值:json
  • 取值范围:
    • text
    • json
    • superjson //text:返回纯文本;json:返回json;superjson:返回加强版json

uid:

  • 类型: 字符串 (此参数只用于iOS)
  • 描述: 服务器ip地址

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:

    {
       status: //识别文本状态值 
       result:  //识别文本结果
          {
           "code":0,                           //识别返回码
           "result":"ESC_SUCCESS",            //返回码所对应的信息
           "block_count": "2",                 //文本块的总数
           "table_count": "1",                 //表格的总数
           "block_list":                        //文本块的集合
           [    
              {
                 "order": "1",                  //在全篇文本的块顺序号
                 "line_list":                   //一个文本块里行的集合
                 [
                    {
                      "line_num": "0",         //一个文本块的行号
                      "text": "表头1表头2"    //识别出来的文字内容,第一候选
                  }
              ]
          },
          {
              "order": "3",
              "line_list": 
              [
                  {
                      "line_num": "0",
                      "text": "表尾"
                  }
              ]
          }
      ],
      "table_list":                            //表格的集合
      [
          {
              "order": "2",                   //一个表格在全篇文本的块顺序号
              "tr_count": "3",                //一个表格行数
              "td_count": "3",                //一个表格列数
              "table":                         //表示一个表格
              [
                  {
                      "tr":                    //一个表格里的一行
                      [
                          {
                              "td":              //某一行里的一列
                              {
                                  "colspan": "1",     //单元格可横跨的列数
                                  "rowspan": "1",     //单元格可纵跨的行数
                                  "line_list":         //一个单元格里行的集合
                                  [
                                  ]
                              }
                          },
                          {
                              "td": 
                              {
                                  "colspan": "1",
                                  "rowspan": "1",
                                  "line_list": 
                                  [
                                      {
                                          "line_num": "0", //一个文本块的行号
                                          "text": "第一列" //识别出来的文字内容,第一候选
                                      }
                                  ]
                              }
                          },
                          {
                              "td": 
                              {
                                  "colspan": "1",
                                  "rowspan": "1",
                                  "line_list": 
                                  [
                                      {
                                          "line_num": "0",
                                          "text": "笔一列"
                                      }
                                  ]
                              }
                          }
                      ]
                  },
                  {
                      "tr": 
                      [
                          {
                              "td": 
                              {
                                  "colspan": "1",
                                  "rowspan": "1",
                                  "line_list": 
                                  [
                                      {
                                          "line_num": "0",
                                          "text": "第一行"
                                      }
                                  ]
                              }
                          },
                          {
                              "td": 
                              {
                                  "colspan": "1",
                                  "rowspan": "1",
                                  "line_list": 
                                  [
                                      {
                                          "line_num": "0",
                                          "text": "11"
                                      }
                                  ]
                              }
                          },
                          {
                              "td": 
                              {
                                  "colspan": "1",
                                  "rowspan": "1",
                                  "line_list": 
                                  [
                                      {
                                          "line_num": "0",
                                          "text": "12"
                                      }
                                  ]
                              }
                          }
                      ]
                  },
                  {
                      "tr": 
                      [
                          {
                              "td": 
                              {
                                  "colspan": "1",
                                  "rowspan": "1",
                                  "line_list": 
                                  [
                                      {
                                          "line_num": "0",
                                          "text": "第二行"
                                      }
                                  ]
                              }
                          },
                          {
                              "td": 
                              {
                                  "colspan": "1",
                                  "rowspan": "1",
                                  "line_list": 
                                  [
                                      {
                                          "line_num": "0",
                                          "text": "21"
                                      }
                                  ]
                              }
                          },
                          {
                              "td": 
                              {
                                  "colspan": "1",
                                  "rowspan": "1",
                                  "line_list": 
                                  [
                                      {
                                          "line_num": "0",
                                          "text": "22"
                                      }
                                  ]
                              }
                          }
                      ]
                  }
              ]
          }
      ] 
    }
    }
    

    err:

  • 类型:JSON对象

  • 内部字段:
    {
    msg: //错误描述 
    }
    

示例代码

var recTable = api.require('hanvonCloudTableReader');

api.getPicture({
    sourceType : 'library',
    encodingType : 'jpg',
    mediaValue : 'pic',
    destinationType : 'url',
    allowEdit : true,
    quality : 100,
    saveToPhotoAlbum : false
}, function(ret, err) {
    if (ret) {                        
        url = ret.data;
        console.log(url);
        recTable.recognitionTable({
            androidkey : "163114c8-31b5-4424-bb85-617f81cf54d9",    
            ioskey: "ffa49301-d271-4ecc-8a3c-5a165eb5768d",
            uid: "",
            type : "json",                     
            picpath : url
        }, function(ret, err) {
            if (ret.status) {
                api.alert({
                    title : "识别结果",
                    msg : ret.result
                });
            } else {
                api.alert({
                    title : "识别结果",
                    msg : err.msg
                });
            }
        });
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

Android和iOS系统

可提供的1.0.0及更高版本