函数:baiduAI 百度文字识别
函数名称: 百度文字识别
函数功能:通过百度 API 进行文件识别(仅支持通用文字识别)
TSLib 版本:仅 v1.2.8 及其以上版本支持
ts.so 版本:仅 iOS v1.4.0、Android v1.1.1 及其以上版本支持
函数方法
local code, body = baiduAI(access_token,pic_name,tab)
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | getAccessToken 函数返回的 access_token 值 |
pic_name | string | 是 | 图片路径,图片路径可以是本地图片路径:image, 也是可以网络图片:url(仅支持 v1.3.3 及其以上版本 TSLib), 具体内容详见下方参数介绍 |
tab | table | 否 | 使用语言、是否检测图像朝向、是否检测语言等, 仅支持 v1.3.3 及其以上版本 TSLib,更详细内容请点击百度 API 文档查看 |
pic_name 参数介绍
图片尺寸:最短边至少 15px,最长边最大 4096px
图片格式:支持 jpg/jpeg/png/bmp 格式
参数 | 说明 |
---|---|
image | 本地图片路径,图像数据, base64 编码后进行 urlencode, 要求 base64 编码和 urlencode 后大小不超过 4M, 当 image 字段存在时 url 字段失效 |
url | 图片完整 URL,URL 长度不超过 1024 字节, URL 对应的图片 base64 编码后大小不超过 4M, 当 image 字段存在时 url 字段失效, 不支持 https 的图片链接, 仅支持 v1.3.3 及其以上版本 TSLib |
tab 参数介绍
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
language_type | string | 否 | 识别语言类型,默认为 CHN_ENG(中英文混合), ENG:英文,其他语言请点击百度 API 文档查看 |
detect_direction | string | 否 | 是否检测图像朝向,默认为 false, 朝向是指输入图像是正常方向、 逆时针旋转 90/180/270 度, false - 不检测, true - 检测 |
detect_language | string | 否 | 是否检测语言,默认为 false, false - 不检测,true - 检测语言, 当前支持(中文、英语、日语、韩语) |
paragraph | string | 否 | 是否输出段落信息,默认为 false, false - 不输出,true - 输出 |
probability | string | 否 | 是否返回识别结果中每一行的置信度, 默认为 false,false - 不返回,true - 返回 |
ocrType | number | 否 | 1 - 4 对应 4 种识别模式,不写默认是通用文字识别, 1 - 通用文字识别 , 2 - 通用文字识别(含位置信息版), 3 - 通用文字识别(高精度版), 4 - 通用文字识别(高精度含位置版), 仅 v1.3.4 及其以上版本支持 |
返回值 | 类型 | 说明 |
---|---|---|
code | boolean | true - 识别成功,false - 识别失败 |
body | string | 识别成功识别结果、图像方向、一个段落包含的行序号等内容, 返回值中的具体内容请点击百度 API 文档查看,失败返回报错信息 |
函数用例
require "TSLib"
--示例不可直接使用
--账号、密码需要替换成在百度智能云网站创建应用后生成的账号(API Key)和密码(Secret Key)
--具体操作流程详见下方注意事项。
local m = TSVersions()
local ts = require("ts")
dialog("ts.so 版本号:"..ts.version(),5)
dialog("TSLb 版本号:"..TSVersions(),5)
local json = ts.json
local API = "GxzOQ1G6W9A"
local Secret = "Kw7pUX7Mvn7Qx63w3b6rfs"
--iOS 需要下载 v1.4.0 及其以上版本 ts.so,Android 需要下载 v1.1.1 及其以上版本 ts.so,否则无法调用成功
fwShowWnd("wid",0,0,300,300,1)
fwShowTextView("wid","textid","abc","center","ffffff","000000",20,0,0,0,300,300,1)
mSleep(1000)
x,y,x1,y1 = 0, 100, 300, 300
local pic_name = userPath() .. "/res/baiduAI.jpg"
snapshot(pic_name,x,y,x1,y1)
mSleep(1000)
--tab 参数仅支持 v1.3.3 及其以上版本 TSLib
local tab={
language_type="ENG",
detect_direction="true",
detect_language="false",
paragraph="true",
probability="true",
ocrType = 1
}
local code1,access_token = getAccessToken(API,Secret)
if code1 then
local code2, body = baiduAI(access_token,pic_name,tab)
if code2 then
dialog("识别成功\n" .. body)
else
dialog("识别失败\n" .. body)
end
else
dialog("获取 access_token 失败\n" .. access_token)
end
注意事项
获取百度 API 应用账号和密码流程:
登录百度智能云网站,如果是第一次使用需要注册账号。
点击「产品服务」->「人工智能」->「文字识别」。
点击「创建应用」。
输入应用名称 ->应用描述-> 点击「立即创建」
点击「返回应用列表」即可生成账号(API Key)和密码(Secret Key)。
请点击这里查看具体操作流程视频。