メインコンテンツへスキップ

結果を受け取る

SDKは、キャプチャセッション中に使用したリスナーインターフェースに定義されたコールバックを通じてキャプチャ結果を返します。

UnicoSelfie
onSuccessSelfie

画像のキャプチャが成功したときに呼び出されます。以下のフィールドを持つ ResultCamera オブジェクトを返します:

  • base64 — キャプチャされた画像。アプリケーションでプレビューを表示するために使用できます。
  • encrypted — REST APIを経由した生体認証検証を完了するためにバックエンドに送信する必要があるJWTペイロード。
@override
void onSuccessSelfie(ResultCamera result) {
  final base64 = result.base64;
  final encrypted = result.encrypted; // JWT to send to your backend
}
encrypted の使用について
  • encrypted 属性は、クライアントAPIを通じて画像を送信する目的のみに使用してください。開いたりシリアライズしたりしてはいけません — その特性は事前通知なく変更される場合があります。不適切な取り扱いによる損害についてUnicoは責任を負いません。
  • base64/encrypted ファイルのサイズは、デバイスの品質、生成される写真のサイズ、およびUnicoのビジネスルールによって異なる場合があります。プログラムロジックやインフラストラクチャでSDKが生成する文字列のサイズを制限しないでください。
Base64からビットマップへの変換（Android）

base64 をビットマップに変換する必要がある場合、標準的な方法はAndroidでは直接機能しません — まずカンマ (,) で文字列を分割してください。How to convert a Base64 string into a Bitmap image to show it in an ImageView? を参照してください。

onErrorSelfie

キャプチャ中にエラーが発生したときに呼び出されます。getCode() と getDescription() を持つ UnicoError オブジェクトを返します。エラーコードの全一覧は エラーハンドリング を参照してください。

@override
void onErrorSelfie(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
}
UnicoDocument
onSuccessDocument

ドキュメント画像のキャプチャが成功したときに呼び出されます。以下のフィールドを持つ ResultCamera オブジェクトを返します:

  • base64 — キャプチャされた画像。プレビューの表示に使用できます。
  • encrypted — 10分以内にバックエンドに送信する必要があるJWTペイロード。変更またはデシリアライズしてはいけません。
@override
void onSuccessDocument(ResultCamera result) {
  final base64 = result.base64;
  final encrypted = result.encrypted; // JWT to send to your backend
}
onErrorDocument

ドキュメントキャプチャ中にエラーが発生したときに呼び出されます。UnicoError オブジェクトを返します。エラーコードの全一覧は エラーハンドリング を参照してください。

@override
void onErrorDocument(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
}
最終更新 に