# FaceRecognitionSDK

**Repository Path**: Ser/FaceRecognitionSDK

## Basic Information

- **Project Name**: FaceRecognitionSDK
- **Description**: FaceRecognitionSDK人脸识别android端sdk
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-08-05
- **Last Updated**: 2021-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Android人脸识别库 #

# 1.快速接入 #

## 1.1远程依赖 ##

①在项目 build.gradle 配置文件添加仓库：

    allprojects {
    	repositories {
    		// ... jcenter() 等其他仓库
    		maven { url 'https://jitpack.io' }
    	}
    }

②在子模块（app）的配置文件添加依赖：

    dependencies {
    	// 添加下面的内容
    	implementation 'com.gitee.ddgameshop:FaceRecognitionSDK:v1.0.0'
    	implementation 'com.squareup.okhttp3:okhttp:4.9.1'
    	// ... 其他依赖项
    }

## 1.2本地依赖 ##

①将 XHFaceRecognitionSDKv1.0.0.aar 包放在您的应用工程的 libs 目录下

![1619337172(1)](https://gitee.com/ddgameshop/FaceRecognitionSDK/raw/master/screenshots/locallib1.png)

②在主项目的 build.gradle 中，添加下面的内容，将 libs 目录作为依赖仓库。

![1619337337(1)](https://gitee.com/ddgameshop/FaceRecognitionSDK/raw/master/screenshots/locallib2.png)

    allprojects {
    	repositories {
    		// 添加下面的内容
    		flatDir {
    			dirs 'libs'
    		}
    		// ... jcenter() 等其他仓库
    	}
    }

③在您 App Module 的 build.gradle 中，添加下面的内容，将识别 SDK 作为项目依赖。

![1619337380(1)](https://gitee.com/ddgameshop/FaceRecognitionSDK/raw/master/screenshots/locallib3.png)

    dependencies {
    	// 添加下面的内容
    	implementation (name: 'XHFaceRecognitionSDKv1.0.0', ext: 'aar')
    	implementation 'com.squareup.okhttp3:okhttp:4.9.1'
    	// ... 其他依赖项
    }

# 2.调用示例 #

    FaceRecognition face = FaceRecognition.getInstance();  
    FaceRecognitionConfig config = new FaceRecognitionConfig.Builder()  
    	.setUrl("http://ip:port") //必填  
    	.setEnableFullUrl(false) //可选,Url是否完整接口地址,默认false  
    	.setEnableLive(true) //可选,启用活体检测,默认true  
    	.build();  
    face.setConfig(config);  
    face.start(this, new FaceRecognition.Callback() {  
    	@Override  
    	public void onSuccess(String idcard) {  
    		//人脸识别成功,返回身份证号  
    	}  
    
    	@Override  
    	public void onFailure(String errorMsg) {  
    		//人脸识别失败,返回失败信息  
    	}  
    });

# 常见问题 #

### Q：build工程，报错 Could not find :XHFaceRecognitionSDKv1.0.0 ###

A：检查项目是否在指定位置上添加flatDir {dirs
'libs'}，可参考[快速接入本地依赖②](#12本地依赖)。

### Q：build工程，报错 Theme.DeviceDefault.DayNight not found ###

A：修改App的build.gradle中compileSdkVersion 29，或以上。

### Q：识别人脸后，报错 Failed resolution of: Lokhttp3/MediaType ###

A：需要自行添加okhttp3依赖库。

### Q：调用报错 Didn't find class "androidx.appcompat.app.AppCompatActivity" ###

A：暂不支持使用support库的项目。

### Q：项目启用代码混淆，需要添加怎样的混淆规则 ###

A：无需添加任何混淆规则(内部自带混淆规则)。


# DEMO APK #
[人脸识别管理平台](http://47.113.117.152:9999)

![1619337480(1)](https://gitee.com/ddgameshop/FaceRecognitionSDK/raw/master/screenshots/demoapk_qrcode.png)
![1619337480(1)](https://www.pgyer.com/app/qrcode/HEYy)