# image-java-sdk-v2.0

**Repository Path**: morgan0329/image-java-sdk-v2.0

## Basic Information

- **Project Name**: image-java-sdk-v2.0
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-08-03
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 腾讯云 [智能图像服务](https://cloud.tencent.com/document/product/641/12437) SDK for JAVA


## 使用前准备​		
1. 前往注册： [腾讯云账号注册](https://cloud.tencent.com/register) （详细指引见 [注册腾讯云](https://cloud.tencent.com/document/product/378/9603)）
2. 取得存储桶名称 **BucketName**： 请前往 [创建存储桶](https://cloud.tencent.com/document/product/460/10637) 
3. 取得 **APPID**、**SecretId**、**SecretKey**：请前往 [云API密钥](https://console.cloud.tencent.com/cam/capi) ，点击“新建密钥”

## 如何集成到你的项目中
### 获得 SDK jar 文件
1. 直接使用 release/*-with-dependencies.jar
2. 或者自行编译：在工程根目录下执行命令 `mvn assembly:assembly`，编译结果见 target/*-with-dependencies.jar

### 导入 jar 到项目中
根据项目具体情况导入 *-with-dependencies.jar

## 使用简介
### 初始化

```java
ImageClient imageClient = new ImageClient(APPID, SecretId, SecretKey);
```

### 设置代理
根据实际网络环境，可能要设置代理，例如: 

```java
Proxy proxy = new Proxy(Type.HTTP, new InetSocketAddress("127.0.0.1", 8080));
imageClient.setProxy(proxy);
```

### 使用
SDK 提供功能如下：

**图像识别**：鉴黄，标签  
**文字识别(OCR)**：身份证，名片，通用，驾驶证行驶证，营业执照，银行卡，车牌号  
**人脸识别**：人脸检测，五官定位，个体信息管理，人脸验证，人脸对比及人脸检索  
**人脸核身**：照片核身（通过照片和身份证信息），获取唇语验证码（用于活体核身），活体核身（通过视频和照片），活体核身（通过视频和身份证信息）

```java
// 调用车牌识别API示例
String imageUrl = "http://youtu.qq.com/app/img/experience/char_general/icon_ocr_license_3.jpg";
String result = imageClient.ocrPlate(new OcrPlateRequest("bucketName", imageUrl));
System.out.println(result);
```

更多例子详情可参见 [Demo.java](https://github.com/tencentyun/image-java-sdk-v2.0/blob/master/src/main/java/com/qcloud/image/demo/Demo.java) 的代码。

## 如何运行这个 Demo 工程
### 使用 Intellij IEDA
1. 修改文件 src/main/java/com/qcloud/image/demo/Demo.java 的 main() 方法，填入上述申请到的 **APPID**、**SecretId**、**SecretKey**、**BucketName**

2. 导入到 IDE：这个 Demo 工程是用 Maven 构建的，以 Intellij IDEA 为例，导入方式为：Import Project -> 选择工程目录 -> 
  Import project from external model -> Maven
3. 运行：Demo.java 右键，Run Demo.main()

### 使用 Eclipse
1. Eclipse 需要先安装 maven 插件: 点击 Eclipse 菜单栏 Help -> Eclipse Marketplace, 搜索框 Find 中输入 maven, 点击右侧的 Go, 搜索到插件 `Maven Integration for Eclipse`, 安装之.
2. 导入到 Eclipse: Eclipse 菜单栏 File -> Import… -> Maven -> Existing Maven Project -> 选择工程目录 -> 点击 Finish.
3. 运行: Eclipse 菜单栏 Run -> Run.