Faceplugin-ltd/FaceRecognition-Android

FacePlugin 얼굴 인식 SDK – Android 데모

개요

• FacePlugin의 온디바이스 얼굴 인식 SDK를 보여주는 샘플 Android 앱입니다. 핵심 처리는 별도로 다운로드하여 프로젝트에 추가하는 바이너리 AAR(facerecognitionsdk.aar)에 포함되어 있습니다.

주요 기능

기능	데모 동작
등록	갤러리에서 얼굴 이미지 하나를 가져와 로컬 JSON 데이터베이스에 템플릿을 저장합니다.
식별	전면 카메라를 사용한 라이브 1:N 매칭(2D 라이브니스/안티스푸핑 감지 포함)을 수행합니다.
캡처	가이드 타원 코치 캡처로 얼굴 이미지와 속성을 반환하고, 선택적으로 사용자를 등록할 수 있습니다.
속성	갤러리 사진에서 랜드마크, 포즈, 품질, 나이, 성별, 감정, 라이브니스 등을 분석합니다.
설정	카메라 렌즈 선택과 라이브니스, 포즈, 눈 감김 등의 임계값을 조정할 수 있습니다.
정보	SDK 및 오프라인 라이선스 모델에 대한 정보를 표시합니다.

실행 방법

1. 리포지토리를 클론합니다.
2. 연결된 Google Drive 폴더에서 facerecognitionsdk.aar를 다운로드하여 libfacesdk/에 넣습니다.
3. Android Studio에서 프로젝트를 열고 실제 Android 폰에서 실행합니다(네이티브 SDK 로딩이 완료될 때까지 UI가 비활성화됩니다).
4. 앱에는 데모 패키지 ID용 유효한 라이선스 키가 포함되어 있습니다. 자체 앱에서는 새 키를 요청해야 합니다.

자체 프로젝트에 SDK 통합

• libfacesdk 모듈과 AAR을 Gradle 빌드에 추가합니다.
• FaceRecognitionSDK.setActivation(context, licenseKey)를 호출한 다음, 백그라운드 스레드에서 init(context)를 한 번만 호출합니다.
• 공개 API에는 다음이 포함됩니다.
  • faceDetection – 감지 박스, 랜드마크 및 요청된 속성을 반환합니다.
  • templateExtraction – 얼굴 이미지를 바이트 배열 템플릿으로 변환하여 직접 저장합니다.
  • similarityCalculation – 두 템플릿을 비교(1:1)하거나 반복하여 1:N 검색을 수행합니다.
  • VideoWorker – 연속 카메라 프레임을 처리하고 라이브 라이브니스 및 증분 매칭을 처리하는 헬퍼입니다.
• 리포지토리에는 스레딩 및 CameraX 파이프라인 작성 없이 복사하여 사용할 수 있는 준비된 Kotlin 헬퍼(FaceRecognitionClient, FaceDatabase, 카메라 유틸리티 등)를 포함하는 데모 키트(app/src/main/java/.../kit/)도 제공됩니다.

중요한 이유

• 온디바이스 전용: 이미지나 생체 데이터가 기기를 벗어나지 않습니다. 은행 KYC, 출입 통제, 데이터 보호 규정을 준수해야 하는 앱 등 프라이버시가 중요한 사용 사례에 필수적입니다.
• 오프라인 라이선스: 앱 패키지 이름에 바인딩된 라이선스로 활성화한 후 인터넷 연결 없이 SDK가 작동합니다.
• 멀티플랫폼 에코시스템: FacePlugin은 iOS, React-Native, Flutter, Ionic, Windows, Docker용 SDK를 제공하며 모두 동일한 기본 모델을 사용합니다.

지원 받기

• 문서: https://doc.faceplugin.com
• 지원: 이메일 info@faceplugin.com, Telegram @FacePluginSupport, WhatsApp +1 469-278-4822.

결론 Android용 턴키 방식의 프라이버시 우선 얼굴 인식 솔루션이 필요하다면, 이 리포지토리는 상용 FacePlugin SDK를 자체 앱에 통합하기 위한 작동 데모와 복사하여 사용할 수 있는 Kotlin 헬퍼 세트를 제공합니다.