# FaceAISDK_iOS

**Repository Path**: onDeviceAI/FaceAISDK_iOS

## Basic Information

- **Project Name**: FaceAISDK_iOS
- **Description**: iOS FaceAISDK is on_device Offline Face Detection 、Recognition 、Liveness Detection Anti Spoofing SDK
FaceAISDK是iOS 设备端可离线不需联网的人脸识别、动作活体检测、人脸录入SDK，快速集成后实现相关功能。
- **Primary Language**: Swift
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 7
- **Created**: 2025-06-04
- **Last Updated**: 2025-10-30

## Categories & Tags

**Categories**: cv, ios-modules

**Tags**: None

## README

<img src="https://badgen.net/badge/FaceAI%20SDK/%20%E5%BF%AB%E9%80%9F%E5%AE%9E%E7%8E%B0%E4%BA%BA%E8%84%B8%E8%AF%86%E5%88%AB%E5%8A%9F%E8%83%BD" />
<br>


<div align=center>
<img src="https://github.com/user-attachments/assets/b1e0a9c4-8b43-4eb8-bf7a-7632901cfb2c" width = 20% />
</div>


## FaceAISDK 介绍
iOS FaceAISDK is on_device Offline Face Detection 、Recognition 、Liveness Detection Anti Spoofing SDK.  
FaceAISDK_iOS SDK是设备端可离线不需联网的人脸录入、动作活体检测、人脸识别SDK，集成后可快速实现相关功能。  


## 更新说明 V2025.10.30
- SDK 内部流程优化
- 信息保护规则说明

[更多历史版本介绍见](/Doc/历史版本SDK更新记录.md)  

## 集成步骤

SDK默认的开发环境为Xcode 16.2 ,Swift 6.0；UI全部使用SwiftUI实现，支持iOS[16,26]

**集成运行本SDK 示范工程，你的电脑需要能科学上网翻墙同步依赖，因为部分资源托管在GitHub，否则无法编译成功**


### 1. 确认电脑能科学上网翻墙后，使用Pod命令安装FaceAISDK和相关依赖库
一般pod install 命令能完整的下载同步安装好所有依赖，也可以pod update FaceAISDK_Core仅更新人脸识别SDK
不同开发设备和网络环境，**首次**集成到主项目翻墙安装依赖**耗时25分钟左右**，建议此时去喝杯水活动一下颈椎😭

**Install TensorFlowLiteSwift (2.17.0) 这是最耗时的基础依赖安装**
你也可以在浏览器中看看当前网络环境下载TensorFlowLiteSwift情况：  
https://github.com/tensorflow/tensorflow/archive/refs/heads/master.zip

```
「没有翻墙的错误提示」
Updating local specs repositories
Downloading dependencies
Installing FaceAISDK_Core 2025.10.17 

[!] Error installing FaceAISDK_Core
[!] /usr/bin/git clone https://github.com/FaceAISDK/FaceAISDK_Core.git /var/folders/gh/p4wv4ytj4tn5xrhgq0n_jnbm0000gn/T/d20251020-8626-c57agm --template= --single-branch --depth 1 --branch 2025.10.17

Cloning into '/var/folders/gh/p4wv4ytj4tn5xrhgq0n_jnbm0000gn/T/d20251020-8626-c57agm'...
fatal: unable to access 'https://github.com/FaceAISDK/FaceAISDK_Core.git/': Error in the HTTP2 framing layer
```
 **经过漫长的等待，编译完成后 就可以在手机体验效果了**

### 2. 安装Demo运行的ToastUI 依赖库
运行本Demo还需要安装 Swift ToastUI。 参考 https://github.com/quanshousio/ToastUI


### 3. 升级FaceAISDK问题
 如果运行出现以下错误
  
 ```
 Swift/Integers.swift:3564: Fatal error: Not enough bits to represent the passed value  
 ```
 
 请在Xcode菜单Product执行clean all Issues后 再次执行pod命令升级FaceAISDK就可以了。
 ```
  pod update FaceAISDK_Core 
 ```

## 其他说明 
  本SDK 需要摄像头实时获取预览数据，目前只支持真机调试。
  
  微信：FaceAISDK  
  Email: FaceAISDK.Service@gmail.com   
  iOS SDK： https://github.com/FaceAISDK/FaceAISDK_iOS  
  Android： https://github.com/FaceAISDK/FaceAISDK_Android     
  
  
  ![FaceAISDK](/Doc/FaceAISDK.jpg)  
  
## Android体验Demo APK下载如下  
  
<div align=center>
<img src="https://user-images.githubusercontent.com/15169396/210045090-60c073df-ddbd-4747-8e24-f0dce1eccb58.png" width = 22% />
</div>  

.