# 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**: 7
- **Forks**: 8
- **Created**: 2025-06-04
- **Last Updated**: 2026-03-26

## 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" />


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


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


![FaceAISDK](/Doc/SDK_WORK_FLOW.jpg)  


## 更新说明 V2026.03.25
- 静默活体检测Beta4,不同光线环境优化
- 默认识别通过阈值调整为0.83
- 解决SDK内部问题
- 优化人脸检测和识别精度

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

## 集成步骤

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

**集成运行本SDK示范工程，你的电脑需要能科学上网翻墙同步依赖，因为部分资源托管在GitHub，否则无法编译成功**  
首次跑起来本工程还是有点挑战的，但一定难不倒厉害的你。

### 1.首次运行/更新版本发生闪退异常
  TensorFlowLiteSwift首次运行或更新版本后发生闪退并报错
  ```
    X Thread 1: EXC BAD ACCESS (code=1, address=0x800008)
  ```
  在Xcode菜单Product执行clean all Issues后
  再次执行pod命令升级FaceAISDK:  **pod update FaceAISDK_Core**

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

 你也可以在浏览器中看看当前网络环境下载TensorFlowLiteSwift情况：  
 https://github.com/tensorflow/tensorflow/archive/refs/heads/master.zip

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

  [!] Error installing FaceAISDK_Core

  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
 ```
 
### 3. 下载依赖TensorFlowLiteSwift出错了
   ```
    [!] Error installing TensorFlowLiteSwift
    
    Cloning into '/var/folders/ft/7cxjq5ss2094sj67mbhnzjrc0000gn/T/d20260113-17932-1xwealt'...
    error: RPC failed; curl 18 transfer closed with outstanding read data remaining
    error: 3926 bytes of body are still expected
    fetch-pack: unexpected disconnect while reading sideband packet
    fatal: early EOF
   ```
    这表明：
    1. 仓库过大：TensorFlowLiteSwift 的源仓库（TensorFlow）比较大
    2. 网络中断：编译环境连接 GitHub 的速度不够快或者发生了超时，导致在下载完成前连接被切断。
    增加 Git 缓存大小）：
    Bash
    git config --global http.postBuffer 1048576000
    git config --global https.postBuffer 1048576000

## 其他说明 
  
  iOS SDK： https://github.com/FaceAISDK/FaceAISDK_iOS  
  Android： https://github.com/FaceAISDK/FaceAISDK_Android     
  **其他实现**  
  **uniApp UTS插件：**  https://github.com/FaceAISDK/FaceAISDK_uniapp_UTS  
  **React native** https://github.com/zkteco-home/react-native-face-ai  
  
  微信：FaceAISDK  
  Email: FaceAISDK.Service@gmail.com   
  
  ![FaceAISDK](/Doc/FaceAISDK.png)  
  
## Android体验Demo APK下载如下  
  
<div align=center>
<img src="https://user-images.githubusercontent.com/15169396/210045090-60c073df-ddbd-4747-8e24-f0dce1eccb58.png" width = 22% />
</div>  

.