所有文档

          文字识别

          快速入门

          安装OCR Java SDK

          OCR Java SDK目录结构

          com.baidu.aip
                 ├── auth                                //签名相关类
                 ├── http                                //Http通信相关类
                 ├── client                              //公用类
                 ├── exception                           //exception类
                 ├── ocr
                 │       └── AipOcr           //AipOcr类
                 └── util                                //工具类

          支持 JAVA版本:1.7+

          查看源码 Java SDK代码现已公开,您可以查看代码、或者在License范围内修改和编译SDK以适配您的环境。 github链接:https://github.com/Baidu-AIP/java-sdk

          使用maven依赖

          添加以下依赖即可。其中版本号可在maven官网查询

          <dependency>
              <groupId>com.baidu.aip</groupId>
              <artifactId>java-sdk</artifactId>
              <version>${version}</version>
          </dependency>

          直接使用JAR包步骤如下

          1.在官方网站下载Java SDK压缩工具包。

          2.将下载的aip-java-sdk-version.zip解压后,复制到工程文件夹中。

          3.在Eclipse右键“工程 -> Properties -> Java Build Path -> Add JARs”。

          4.添加SDK工具包aip-java-sdk-version.jar和第三方依赖工具包json-20160810.jar log4j-1.2.17.jar

          其中,version为版本号,添加完成后,用户就可以在工程中使用OCR Java SDK。

          新建AipOcr

          AipOcr是Optical Character Recognition的Java客户端,为使用Optical Character Recognition的开发人员提供了一系列的交互方法。

          用户可以参考如下代码新建一个AipOcr,初始化完成后建议单例使用,避免重复获取access_token:

          public class Sample {
              //设置APPID/AK/SK
              public static final String APP_ID = "你的 App ID";
              public static final String API_KEY = "你的 Api Key";
              public static final String SECRET_KEY = "你的 Secret Key";
          
              public static void main(String[] args) {
                  // 初始化一个AipOcr
                  AipOcr client = new AipOcr(APP_ID, API_KEY, SECRET_KEY);
          
                  // 可选:设置网络连接参数
                  client.setConnectionTimeoutInMillis(2000);
                  client.setSocketTimeoutInMillis(60000);
          
                  // 可选:设置代理服务器地址, http和socket二选一,或者均不设置
                  client.setHttpProxy("proxy_host", proxy_port);  // 设置http代理
                  client.setSocketProxy("proxy_host", proxy_port);  // 设置socket代理
          
                  // 可选:设置log4j日志输出格式,若不设置,则使用默认配置
                  // 也可以直接通过jvm启动参数设置此环境变量
                  System.setProperty("aip.log4j.conf", "path/to/your/log4j.properties");
          
                  // 调用接口
                  String path = "test.jpg";
                  JSONObject res = client.basicGeneral(path, new HashMap<String, String>());
                  System.out.println(res.toString(2));
                  
              }
          }

          其中示例的log4j.properties文件内容如下:

          #可以设置级别:debug>info>error
          #debug:显示debug、info、error
          #info:显示info、error
          #error:只error
          log4j.rootLogger=debug,appender1
          #log4j.rootLogger=info,appender1
          #log4j.rootLogger=error,appender1
          
          #输出到控制台
          log4j.appender.appender1=org.apache.log4j.ConsoleAppender
          #样式为TTCCLayout
          log4j.appender.appender1.layout=org.apache.log4j.PatternLayout
          
          #自定义样式
          # %r 时间 0
          # %t 方法名 main
          # %p 优先级 DEBUG/INFO/ERROR
          # %c 所属类的全名(包括包名)
          # %l 发生的位置,在某个类的某行
          # %m 输出代码中指定的讯息,如log(message)中的message
          # %n 输出一个换行
          
          log4j.appender.appender1.layout.ConversionPattern=[%d{yy/MM/dd HH:mm:ss:SSS}][%t][%p] -%l %m%n

          在上面代码中,常量APP_ID在百度智能云控制台中创建,常量API_KEYSECRET_KEY是在创建完毕应用后,系统分配给用户的,均为字符串,用于标识用户,为访问做签名验证,可在AI服务控制台中的应用列表中查看。

          注意:如您以前是百度智能云的老用户,其中API_KEY对应百度智能云的“Access Key ID”,SECRET_KEY对应百度智能云的“Access Key Secret”。

          配置AipOcr

          如果用户需要配置AipOcr的一些细节参数,可以在构造AipOcr之后调用接口设置参数,目前只支持以下参数:

          接口 说明
          setConnectionTimeoutInMillis 建立连接的超时时间(单位:毫秒)
          setSocketTimeoutInMillis 通过打开的连接传输数据的超时时间(单位:毫秒)
          setHttpProxy 设置http代理服务器
          setSocketProxy 设置socket代理服务器 (http和socket类型代理服务器只能二选一)
          上一篇
          简介
          下一篇
          接口说明