# face-java-sdk

**Repository Path**: dbin0123/face-java-sdk

## Basic Information

- **Project Name**: face-java-sdk
- **Description**: Face++ and FaceID Java SDK
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 4
- **Created**: 2020-03-14
- **Last Updated**: 2023-07-19

## Categories & Tags

**Categories**: cv

**Tags**: None

## README

# 旷视人工智能开放平台API SDK

## 介绍

Face++ and FaceID Java SDK

## API文档 

- [Face++](https://console.faceplusplus.com.cn/documents/4887579)
- [FaceID](https://faceid.com/pages/documents)

## 安装使用
### Maven
在项目的pom.xml的dependencies中加入以下内容:

```
<dependency>
  <groupId>com.aiwiown.face</groupId>
  <artifactId>face-java-sdk</artifactId>
  <version>${latest.version}</version>
</dependency>
```

### Gradle
```
compile 'com.aiwiown.face:face-java-sdk:${latest.version}'
```
### 非Maven项目

点击以下任一链接，下载最新版本`face-java-sdk-X.X.X.jar`即可：

- [Maven中央库1](https://repo1.maven.org/maven2/com/aiwiown/face/face-java-sdk/)
- [Maven中央库2](https://search.maven.org/artifact/com.aiwiown.face/face-java-sdk/)

### 编译安装

访问face-java-sdk的码云主页：[https://gitee.com/dbin0123/face-java-sdk](https://gitee.com/dbin0123/face-java-sdk) 下载整个项目源码然后进入face-java-sdk项目目录执行：
- master:已发布版本到中央仓库
- develop: 最新功能和fixbug分支

```
mvn clean install -DskipTests
```

然后就可以使用Maven引入了。

## 项目中使用

#### 以其中一个接口为例,其他类似(参数相关根据自有项目业务自定义即可)

```java

    public static void main(String[] args) throws Exception {
        PcTokenResponse response = pcToken();
    }

    /**
     * 封装请求client-第一种方式
     *
     * @return DefaultApiClient
     */
    private static DefaultApiClient defaultApiClient() {
        String serverUrl = "https://api.megvii.com/faceid";
        //获取方式:官网控制台获取
        String appId = "faceId或face++的应用id";
        String appSecret = "faceId或face++的应用秘钥";
        return new DefaultApiClient(serverUrl, appId, appSecret);
    }

    /**
     * 获取pc端请求token
     *
     * @return PcTokenResponse
     * @throws Exception
     */
    public static PcTokenResponse pcToken() throws Exception {
        PcTokenModel pcTokenModel = new PcTokenModel();
        pcTokenModel.setComparisonType(ComparisonType.KYC);
        pcTokenModel.setIdCardName("xxx");
        pcTokenModel.setIdCardNumber("xxx");
        pcTokenModel.setBizNo("xxx");
        String url = "https://www.baidu.com/";
        pcTokenModel.setReturnUrl(url);
        pcTokenModel.setNotifyUrl(url);
        
        PcTokenRequest pcTokenRequest = new PcTokenRequest();
        pcTokenRequest.setBizModel(pcTokenModel);
        
        return defaultApiClient().execute(pcTokenRequest);
    }
```


## 捐赠

如果你觉得face-java-sdk不错，可以捐赠请作者吃包辣条~，在此表示感谢^_^。

点击以下链接，将页面拉到最下方点击“捐赠”即可。

[前往捐赠](https://gitee.com/dbin0123/face-java-sdk)