2 ユーザーガイド
Last updated
Last updated
テスト用のサンプルプロジェクトは、AndroidStudioで提供されています。インポートするには、次の手順を参照してください。
File > New > Import Projectをクリックし、Sampleを選択してAndroidStudioにインポートしてください。
アカウント情報API_KEY
と API_SECRET
を入力してください。
ライセンスファイルの名前を変更し、指定したディレクトリに配置してください。(にご参照ください)
File > New > Import Module ...
から../Sample/common-silent
を選択し、 Import common-silentをインポートモジュールとしてプロジェクトにインポートし、アプリケーションプロジェクトのbuild.gradleに依存関係を追加します。
プロジェクト(アプリプロジェクトと同じレベル)の下にリポジトリを作成し、liveness-silent-online-cn-release.aarをこのディレクトリにコピーしてください。ルートディレクトリのbuild.gradleを変更し、次のようにリポジトリに構成を追加してください。
次の例のように、AndroidManifest.xmlに権限ステートメントを追加してください。
次の例のように、AndroidManifest.xmlにActivityステートメントを追加してください。
静的生体検知は、SilentLivenessActivity
を呼び出すことで使用できます。詳細については、サンプルのStartPageFragment
のstartDetectionActivity()
メソッドを参照してください。
該当するアプリモジュールの下に新しいlibs
フォルダーを作成し(libs
フォルダーが既に存在する場合は不要)、liveness-silent-online-cn-release.aar
をlibs
にコピーしてください。 アプリケーションモジュールの下にあるbuild.gradleに次の構成を追加してください。
そうすると、SDKを直接呼び出して開発することができます。
コードの難読化後にクラッシュが発生する可能性があるため、最初に難読化の構成によってコードの難読化の問題を解決することを推奨します。
具体的には、次のコードがproguardファイルに追加されることで、この問題を解決します。
ライセンスファイルとモデルファイルは、事前に端末にコピーする必要があります。
FileUtil.copyAssetsToFile
を呼び出すか、他のメソッドを使用してサンプルを参照してください。その後、SilentLivenessApi
でinit
メソッドを呼び出してください。
品質検出の設定
SilentLivenessApi
の中から、次のメソッドを呼び出して設定します。
生体検知パスの条件を設定します。setPassCondition(final int minDuration, final int minFrames)
タイムアウト時間を秒単位で設定します。デフォルトのタイムアウト時間は10秒です。setDetectTimeout(int timeout)
顔との距離の判定条件を設定します。 パラメータ値の範囲内にない場合また、closeRate
は0ではない、かつfarRate
はcloseRate
より大きい場合は、STID_E_FARCLOSE_INVALID
のエラーが発生します:setFaceDistanceRate(float farRate, float closeRate)
眉毛の遮蔽検知機能が必要かどうかを設定します。デフォルトはfalseです。:setBrowOcclusionEnable(final boolean enable)
顔の遮蔽検知機能が必要かどうかを設定します。デフォルトはfalseです。:
setOcclusionEnable(final boolean enable)
生体検知のしきい値を設定します。setThreshold(final float threshold)
目の開き状態のしきい値を設定します。setEyeOpenThreshold(final float threshold)
ぼやけさ検知機能が必要かどうかとそのしきい値を設定します。setBlurryFilterEnable(final boolean enable, final float threshold)
照明条件検知機能が必要かどうかとそのしきい値を設定します。
setIlluminationFilterEnable(final boolean enable, final float lowLightThreshold, final float brightThreshold)
SilentLivenessApi start()
メソッドを呼び出して、テストを開始する準備をします。
メソッドの説明:テストを開始する準備をします。
SilentLivenessApi inputData
メソッドを呼び出して、検出用の画像データやその他のパラメーターを入力します。
メソッドの説明:検出用画像の入力。
OnLivenessListener
にメソッドを実装して、検出結果を取得します。
メソッドの説明:完全な初期化。
メソッドの説明:照準ステータスを更新します。
メソッドの説明:生体検知が失敗しました。
メソッドの説明:生体検知が成功しました。
SilentLivenessApistop
メソッドを呼び出します。
メソッドの説明:現在の検出を停止し、検出ステータスをリセットします。 このメソッドは、失敗後に再試行するために使用されます。 init
が成功した後、release
が呼び出される前に呼び出す必要があります。 呼び出された後、start
を使用してdetection.silentlivenessapi.md
を再開できます)
SilentLivenessApi
リリースメソッドを呼び出します。
メソッドの説明:検出をキャンセルし、リソースを解放します。
生体検知が成功すると、SDKは対応する顔画像と暗号化されたバイナリファイルを返します。戻り値は、顔を比較するためのプライベートクラウドインターフェイスのパラメーターとして使用できます。
生体検知にパスできる最小検出時間と最小検出フレーム数を設定する必要がある場合は、init
メソッドを調整してからsetPassCondition
メソッドを呼び出すことで設定できます。メソッドの説明については、を参照してください。
詳細については、のライブラリを参照してください。
詳細については、のライブラリを参照してください。
プライベートクラウドインターフェースの具体的な説明については、を参照してください。