Faceplugin-ltd/FaceRecognition-Android

FacePlugin 顔認識SDK – Androidデモ

概要

• FacePluginのオンデバイス顔認識SDKを紹介するサンプルAndroidアプリです。処理の中核は、別途ダウンロードしてプロジェクトに追加するバイナリAAR（facerecognitionsdk.aar）に含まれています。

主な機能

機能	デモの動作
登録	ギャラリーから顔画像を1枚取得し、テンプレートをローカル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)を1回だけ呼び出します。
• 公開APIには以下が含まれます。
  • faceDetection – 検出ボックス、ランドマーク、要求された属性を返します。
  • templateExtraction – 顔画像をバイト配列のテンプレートに変換し、自分で保存します。
  • similarityCalculation – 2つのテンプレートを比較（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ヘルパー一式を提供します。