識別エンジン

人間の顔1:1 比較、ローカル1:N 識別、サーバ1:N識別、マスク検知にサポート

機能類の説明

IdentifyManager

識別エンジンを操作する入り口

メンバー関数

説明

導入バージョン

boolean setIdentifyTarget(Bitmap avatar)

個人の識別フィーチャーを設定

2.0.0

ImageConfig getImageConfig()

画像構成を取得

2.0.0

IdentifyConfig getIdentifyConfig()

識別エンジンのワークフロー構成を取得

2.0.0

ThresholdConfig getThresholdConfig()

しきい値構成を取得

2.0.0

void addFaceFilterInterceptor(IFaceFilterInterceptor faceFilterInterceptor)

顔フィルターインターセプターを追加

2.0.0

void handleRgbData(byte[] data)

RGB画像データをハンドル

2.0.0

void handleIrData(byte[] data)

IR画像データをハンドル

2.0.0

void handleTemperatureData(Bitmap temperatureBitmap,float[] temperatureValue, int width, int height, FaceOrientation temperatureOrientation)

ヒートマップと関連データをハンドル

2.0.0

void init(ImageConfig imageConfig, IIdentifyResultCallback identifyResultCallback)

初期化

2.0.0

void pause()

顔認識を中止

2.0.0

void resume()

顔認識を回復

2.0.0

void release()

リソースを解放

2.0.0

void removeFaceFilterInterceptor(IFaceFilterInterceptor faceFilterInterceptor)

顔フィルターインターセプターを削除

2.0.0

void removeIdentifyTarget()

設定した個人の識別フィーチャーを削除

2.0.0

void start()

識別を開始

2.0.0

void stop()

識別を停止

2.0.0

void setIdentifyCallback(IIdentifyResultCallback iIdentifyCallback)

識別コールバックを設定

2.0.0

void setVerifyMode(VerifyModeEnum verifyMode)

識別エンジンの検証モードを設定

2.0.0

void setThresholdConfig(ThresholdConfig thresholdConfig)

しきい値構成を設定

2.0.0

void setIdentifyConfig(IdentifyConfig identifyConfig)

識別エンジンワークフロー構成を設定

2.0.0

void setServerVerifyAction(IServerVerifyAction serverVerifyAction)

サーバの検証ロジックを設定

2.0.0

void setTemperatureSdkAction([ITemperatureSdkAction] temperatureSdkAction)

温度検知アルゴリズムSDKの動作を設定

2.0.0

メンバー関数の説明

boolean setIdentifyTarget(Bitmap avatar)

個人の識別フィーチャーを設定

パラメータ

パラメータ名

説明

備考

導入バージョン

avatar

Bitmap

個人のID写真

なし

2.0.0

戻り値

戻り値

説明

備考

導入バージョン

true

設定が成功しました

なし

2.0.0

false

設定に失敗しました

なし

2.0.0

例外

なし

ImageConfig getImageConfig()

画像構成を取得

パラメータ

なし

戻り値

ImageConfig

例外

なし

IdentifyConfig getIdentifyConfig()

識別エンジンのワークフロー構成を取得

パラメータ

なし

戻り値

IdentifyConfig

例外

なし

ThresholdConfig getThresholdConfig()

しきい値構成を取得

パラメータ

なし

戻り値

ThresholdConfig

例外

なし

void addFaceFilterInterceptor(IFaceFilterInterceptor faceFilterInterceptor)

顔フィルターインターセプターを追加

パラメータ

パラメータ名

説明

備考

導入バージョン

faceFilterInterceptor

IFaceFilterInterceptor

顔フィルターインターセプター

なし

2.0.0

戻り値

なし

例外

なし

void handleRgbData(byte[] data)

RGBデータをハンドル

パラメータ

パラメータ名

説明

備考

導入バージョン

data

byte[]

画像データ

なし

2.0.0

戻り値

なし

例外

なし

void handleIrData(byte[] data)

IRデータをハンドル

パラメータ

パラメータ名

説明

備考

導入バージョン

data

byte[]

画像データ

なし

2.0.0

戻り値

なし

例外

なし

void handleTemperatureData(Bitmap temperatureBitmap,float[] temperatureValue, int width, int height, FaceOrientation temperatureOrientation)

ヒートマップと関連データをハンドル

パラメータ

パラメータ名

説明

備考

導入バージョン

temperatureBitmap

Bitmap

ヒートマップ

なし

2.0.0

temperatureValue

float[]

温度データ

なし

2.0.0

width

int

ヒートマップの幅

なし

2.0.0

height

int

ヒートマップの高さ

なし

2.0.0

temperatureOrientation

FaceOrientation

顔の方向

なし

2.0.0

戻り値

なし

例外

なし

void init(ImageConfig imageConfig, IIdentifyResultCallback identifyResultCallback)

初期化

パラメータ

パラメータ名

説明

備考

導入バージョン

imageConfig

ImageConfig

画像構成

なし

2.0

identifyResultCallback

IIdentifyResultCallback

識別結果コールバック

なし

2.0.0

戻り値

なし

例外

なし

void pause()

顔認識を中止

パラメータ

なし

戻り値

なし

例外

なし

void resume()

顔認識を回復

パラメータ

なし

戻り値

なし

例外

なし

void release()

リソースを解放

パラメータ

なし

戻り値

なし

例外

なし

void removeFaceFilterInterceptor(IFaceFilterInterceptor faceFilterInterceptor)

顔フィルターインターセプターを削除

パラメータ

パラメータ名

説明

備考

導入バージョン

faceFilterInterceptor

IFaceFilterInterceptor

顔フィルターインターセプター

なし

2.0

戻り値

なし

例外

なし

void removeIdentifyTarget()

設定した個人の識別フィーチャーを削除

パラメータ

なし

戻り値

なし

例外

なし

void start()

識別を開始

パラメータ

なし

戻り値

なし

例外

なし

void stop()

識別を停止

パラメータ

なし

戻り値

なし

例外

なし

void setIdentifyCallback(IIdentifyResultCallback iIdentifyCallback)

識別結果コールバックを設定

パラメータ

パラメータ名

説明

備考

導入バージョン

iIdentifyCallback

IIdentifyResultCallback

識別結果コールバック

なし

2.0

戻り値

なし

例外

なし

void setVerifyMode(VerifyModeEnum verifyMode)

識別エンジンの検証モードを設定

パラメータ

パラメータ名

説明

備考

導入バージョン

verifyMode

VerifyModeEnum

検証モード

なし

2.0

戻り値

なし

例外

なし

void setThresholdConfig(ThresholdConfig thresholdConfig)

しきい値構成を設定

パラメータ

パラメータ名

説明

備考

導入バージョン

thresholdConfig

ThresholdConfig

しきい値構成

なし

2.0

戻り値

なし

例外

なし

void setIdentifyConfig(IdentifyConfig identifyConfig)

識別エンジンワークフロー構成を設定

パラメータ

パラメータ名

説明

備考

導入バージョン

identifyConfig

IdentifyConfig

識別エンジンワークフロー構成

なし

2.0

戻り値

なし

例外

なし

void setServerVerifyAction(IServerVerifyAction serverVerifyAction)

サーバの検証ロジックを設定

パラメータ

パラメータ名

説明

備考

導入バージョン

serverVerifyAction

IServerVerifyAction

サーバの検証ロジック

なし

2.0

戻り値

なし

例外

なし

void setTemperatureSdkAction(ITemperatureSdkAction temperatureSdkAction)

温度検知アルゴリズムの動作を設定

パラメータ

パラメータ名

説明

備考

導入バージョン

temperatureSdkAction

ITemperatureSdkAction

温度測定アルゴリズムの動作

なし

2.0

戻り値

なし

例外

なし

エンティティの説明

ImageConfig

プロパティの説明

Member

説明

備考

導入バージョン

int previewW

int

カメラプレビュー解像度の幅

なし

2.0.0

int previewH

int

カメラプレビュー解像度の高さ

なし

2.0.0

pixelFormat

MidPixelFormat

カメラプレビューフレームデータのフォーマット

なし

2.0.0

faceOrientation

FaceOrientation

カメラプレビューフレームデータでの顔の向き

なし

2.0.0

MidPixelFormat

プロパティの説明

Member

説明

備考

導入バージョン

GRAY8

Y 1

なし

2.0.0

YUV420P

YUV 4:2:0

なし

2.0.0

NV12

YUV 4:2:0

なし

2.0.0

NV21

YUV 4:2:0

なし

2.0.0

BGRA8888

BGRA 8:8:8:8

なし

2.0.0

BGR888

BGR 8:8:8

なし

2.0.0

RGBA8888

RGBA 8:8:8:8

なし

2.0.0

RGB888

RGB 8:8:8

なし

2.0.0

GRAY16

特殊な画像フォーマット

回転および他フォーマットへの変換を提供しません

2.0.0

RGB565

RGB 5:6:5

なし

2.0.0

ABGR8888

ABGR 8:8:8:8

なし

2.0.0

FaceOrientation

プロパティの説明

Member

説明

備考

導入バージョン

UP

顔の向きが上

なし

2.0.0

LEFT

顔の向きが左

なし

2.0.0

DOWN

顔の向きが下

なし

2.0.0

RIGHT

顔の向きが右

なし

2.0.0

IdentifyConfig

プロパティの説明

Member

説明

備考

導入バージョン

debug

boolean

デバッグのON/OFF

なし

2.0.0

imageConfig

ImageConfig

識別フレーム情報構成

なし

2.0.0

thresholdConfig

ThresholdConfig

識別しきい値構成

なし

2.0.0

hasLiveness

boolean

生体検知のON/OFF

なし

2.0.0

isAlwaysLiveness

boolean

同じTrack IDに対して常に生体検知を実行するかを判定

なし

2.0.0

isSingleLiveness

boolean

シングルカメラによる生体検知かを判定

なし

2.0.0

hasTemperatureDetection

boolean

温度検知のON/OFF

なし

2.0.0

isMultiTemperatureDetection

boolean

複数人の温度検知のON/OFF

なし

2.0.0

hackNoPassCountThreshold

int

非生体と判定するための生体検知回数

なし

2.0.0

strangerCountThreshold

int

未登録者と判定するための比較回数

なし

2.0.0

irNoFaceCountThreshold

int

連続Nフレームで非生体と判定

なし

2.0.0

irAndRgbFaceMinDist

float

RGBカメラとIRカメラの最小距離しきい値

なし

2.0.0

isContinueVerify

boolean

同じTrack IDに対し識別結果を出した後識別を継続か

なし

2.0.0

irAndRgbFaceSizeThreshold

float

RGBとIR顔の差異しきい値

なし

2.0.0

continueVerifyIntervalTime

long

同じTrack IDに対し識別結果を出した後の時間間隔

なし

2.0.0

samePersonContinuousRecognitionInterval

long

同じユーザーIDに対する連続識別の間隔

このパラメータは個体に対するもので、continueVerifyIntervalTime によるコントロールより上層に位置する

2.0.0

isServerVerify

boolean

サーバ検証かを判定

なし

2.0.0

isMultiFaceVerify

boolean

複数人の顔識別シナリオかを判定

なし

2.0.0

detectSerialMultiFace

int

Trackingの際に何回のフレームごとに検知を1回実行するか

なし

2.0.0

isSenseGateConfig

boolean

SenseGateデバイスかを判定

SenseGateBDのBaseline 距離計算はPassシリーズとは異なる

2.0.0

isCheckCameraRotate

boolean

カメラの回転をチェックするかを判定

なし

2.0.0

isDoVerify

boolean

顔認識するかを判定

なし

2.0.0

isOpenWearMaskIdentify

boolean

マスク検知をオンにするかを判定

なし

2.0.0

isInnerEyeTempDetect

boolean

目元による温度検知するかを判定

なし

2.0.0

unSuccessTimeoutTimeThreshold

int

識別が成功できていないタイムオーバーの時間。すなわち、成功時にのみすぐ結果を返し、成功しない場合、タイムオーバーになってから失敗結果を返す

デフォルトは-1とし、この機能がオフにしていることを表す

2.0.0

ThresholdConfig

プロパティの説明

Member

説明

備考

導入バージョン

verifyAreaRect

RectF

顔の枠

なし

2.0.0

faceMinWidth

int

識別できる最小の顔の幅

なし

2.0.0

faceMaxWidth

int

識別できる最大の顔の幅

なし

2.0.0

alignmentScore

float

マークされた顔のアラインメントスコア

なし

2.0.0

sharpness

float

顔の不鮮明さ

なし

2.0.0

yaw

float

横向き角度

横顔

2.0.0

pitch

float

上向き・下向きの角度

上向き、下向き

2.0.0

roll

float

傾きの角度

頭の傾き

2.0.0

livenessScore

float

生体検知のしきい値

なし

2.0.0

verifyScore

float

比較のしきい値

なし

2.0.0

maskVerifyScore

float

マスクつけた状態の比較しきい値

なし

2.0.0

IFaceFilterInterceptor

メソッドの説明

メンバー関数

説明

備考

導入バージョン

T filterFace(FaceInfo faceInfo, byte[] data, MidPixelFormat midPixelFormat, int width, int height, FaceOrientation faceOrientation)

顔フィルター

なし

2.0.0

FaceInfo

プロパティの説明

Member

説明

備考

導入バージョン

faceRect

Rect

顔の枠

なし

2.0.0

facePoints

PointF[]

顔のポイント

なし

2.0.0

occlusion

int[]

顔の遮蔽

なし

2.0.0

id

int

track id

なし

2.0.0

detectionScore

float

検知スコア

なし

2.0.0

alignmentScore

float

アラインメントスコア

なし

2.0.0

pointsCount

int

顔のポイントの数

なし

2.0.0

yaw

float

横向き角度

なし

2.0.0

pitch

float

上向き・下向き角度

なし

2.0.0

roll

float

傾きの角度

なし

2.0.0

VerifyModeEnum

プロパティの説明

Member

説明

備考

導入バージョン

MODE_1_N

1:N 比較モード

なし

2.0.0

MODE_1_1

1:1 比較モード

なし

2.0.0

MODE_SERVER_1_N

サーバ認識 1:N モード

なし

2.0.0

IIdentifyResultCallback

メソッドの説明

メンバー関数

説明

備考

導入バージョン

void onTrackResult(FaceInfo[] faces, byte[] rgbCameraData, byte[] irCameraData)

Track結果をコールバック

なし

2.0.0

void onNoFaceOverTime(byte[] rgbCameraData, byte[] irCameraData)

指定期間内に検知できた顔コールバックがない

なし

2.0.0

void onClearScreen()

顔コールバックがない

なし

2.0.0

void onDrawFaces(List<FaceInfo> faceInfoList)

スクリーンから顔を描画するコールバック

なし

2.0.0

void onUnknown(float faceW)

異常の顔をコールバック

人物が遠く立ち、生体検知が不正確の際にコールバック

void onCameraRotate(FaceOrientation forwardOrientation)

カメラローテーションのためのコールバックAPI

なし

2.0.0

void onFaceFilterResult(List<FaceFilterResult> faceFilterResults)

顔フィルターのコールバック

なし

2.0.0

void onAttributeFilterResult(List<AttributeFilterResult> attributeFilterResults)

属性フィルター結果

なし

2.0.0

void onIdentifyResult(List<FrameIdentifyResult> frameIdentifyResults)

顔識別のコールバック

なし

2.0.0

void onTrackAndTemperatureResult

(List<TrackAndTemperatureResult> results)

Trackと温度検知結果

なし

2.0.0

FaceFilterResult

プロパティの説明

Member

説明

備考

導入バージョン

code

int

結果コード

0は通過。0ではない場合フィルターされたことを意味。 フィルターされた場合、開発者はインターセプターapiでカスタマイズが必要

2.0.0

interceptorId

int

インターセプターID

なし

2.0.0

faceInfo

FaceInfo

顔情報

なし

2.0.0

AttributeFilterResult

プロパティの説明

Member

Type

説明

備考

導入バージョン

code

int

結果コード

0は通過。0ではない場合フィルターされたことを意味。 具体的には各インターセプターでカスタマイズする

2.0.0

interceptorId

int

インターセプターID

なし

2.0.0

attributeResult

AttributeResult

属性結果

なし

2.0.0

AttributeResult

プロパティの説明

Member

Type

説明

備考

導入バージョン

rgbFace

FaceInfo

顔の情報

なし

2.0.0

wearMask

boolean

マスクをつけているかを判定

なし

2.0.0

wearEyeGlass

boolean

メガネをつけているかを判定

なし

2.1.0

age

int

年齢を推測

なし

2.1.0

isMale

boolean

性別を推測

なし

2.1.0

isHasMustache

boolean

ひげがあるかを判定

なし

2.1.0

FrameIdentifyResult

プロパティの説明

Member

Type

説明

備考

導入バージョン

frameId

int

フレームID

なし

2.0.0

rgbCameraNv21Data

byte[]

認識結果に対応するRGBフレームデータ

なし

2.0.0

w

int

フレームの幅

なし

2.0.0

h

int

フレームの高さ

なし

2.0.0

orientation

FaceOrientation

顔の向き

なし

2.0.0

irCameraNv21Data

byte[]

認識結果に対応するIRフレームデータ

なし

2.0.0

temperatureValue

float[]

温度データ

なし

2.0.0

temperatureBitmap

Bitmap

温度ビットマップ

なし

2.0.0

temperatureWidth

int

温度ビットマップの幅

なし

2.0.0

temperatureHeight

int

温度ビットマップの高さ

なし

2.0.0

temperatureOrientation

FaceOrientation

温度ビットマップの顔向き

なし

2.0.0

faceIdentifyResults

List<FaceIdentifyResult>

認識結果リスト

なし

2.0.0

FaceIdentifyResult

プロパティの説明

Member

Type

説明

備考

導入バージョン

faceInfo

FaceInfo

RGB 顔の情報

なし

2.0.0

irFaceInfo

FaceInfo

IR 顔の情報

なし

2.0.0

feature

byte[]

フィーチャー

なし

2.0.0

verifyScore

float

識別スコア

なし

2.0.0

livenessScore

float

生体検知スコア

なし

2.0.0

userId

int

ユーザーID

なし

2.0.0

trackAndTemperatureResult

TrackAndTemperatureResult

温度結果

なし

2.0.0

isMask

boolean

マスクをつけているかを判定

なし

2.0.0

identifyResultTypeEnum

IdentifyResultTypeEnum

認識結果

なし

2.0.0

faceSearchResult

FaceSearchResult

検索結果

なし

2.0.0

AttributeResult

AttributeResult

顔属性の結果

なし

2.1.0

TrackAndTemperatureResult

プロパティの説明

Member

Type

説明

備考

導入バージョン

faceInfo

FaceInfo

RGB顔の情報

なし

2.0.0

irFaceInfo

FaceInfo

IR顔の情報

なし

2.0.0

temperature

float

温度値

なし

2.0.0

IdentifyResultTypeEnum

プロパティの説明

Member

説明

備考

導入バージョン

NON_LIVENESS

非生体

なし

2.0.0

LIVENESS

生体

なし

2.0.0

STRANGER

未登録者

なし

2.0.0

VERIFY_SUCCESS

認識成功

なし

2.0.0

FaceSearchResult

プロパティの説明

Member

Type

説明

備考

導入バージョン

userID

int

データベースに追加するときに定義したインデックス値

なし

2.0.0

score

float

最も似ているフィーチャー値スコア

なし

2.0.0

IServerVerifyAction

メソッドの説明

メンバー関数

説明

備考

導入バージョン

T verify( byte[] cameraData, byte[] feature,FaceInfo rgbFace, int width, int height)

顔の検索と認識

なし

2.0.0

ITemperatureSdkAction

プロパティの説明

メンバー関数

説明

備考

導入バージョン

List temperCalculateAir(MatchFace[] matchFaces, Bitmap temperatureBitmap, float[] temperatureData, int temperatureWidth, int temperatureHeight, FaceOrientation temperatureOrientation)

複数人温度検知アルゴリズム

なし

2.0.0

最終更新