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

結果の受け取り

SDKはopen()に渡されたcallbackオブジェクトを通じてキャプチャ結果を返します。successerrorの両方のハンドラは必須です。

セルフィーキャプチャ
success(セルフィー)

画像が正常にキャプチャされたときに呼び出されます。以下を含むオブジェクトを受け取ります:

  • base64 — キャプチャされた画像。アプリケーションでプレビュー表示に使用できます。
  • encrypted — REST APIを介した生体認証検証を完了するためにバックエンドに送信する必要があるJWTペイロード。
const callback = {
on: {
success: (obj) => {
const base64 = obj.base64;
const encrypted = obj.encrypted; // JWT to send to your backend
},
error: (error) => {
console.error(error);
}
}
};
encryptedの使用
  • encrypted属性は、クライアントAPIを通じて画像を送信することのみを目的としています。開いたりシリアライズしたりしてはなりません — その特性は事前の通知なしに変更される場合があります。Unicoは不適切な取り扱いによる損害について責任を負いません。
  • base64/encryptedファイルは、デバイスの品質、生成された写真のサイズ、およびUnicoのビジネスルールに応じてサイズが異なる場合があります。プログラミングロジックまたはインフラストラクチャでSDKが生成する文字列のサイズを制限しないでください
error(セルフィー)

キャプチャ中にエラーが発生したときに呼び出されます。getCode()getDescription()を持つErrorBioオブジェクトを受け取ります。エラーコードの完全なリストについては、エラー処理を参照してください。

error: (error) => {
const code = error.getCode();
const description = error.getDescription();
}
ドキュメントキャプチャ
success(ドキュメント)

ドキュメント画像が正常にキャプチャされたときに呼び出されます。以下を含むオブジェクトを受け取ります:

  • base64 — キャプチャされた画像。プレビュー表示に使用できます。
  • encrypted10分以内にバックエンドに送信する必要があり、変更またはデシリアライズしてはならないJWTペイロード。
const callback = {
on: {
success: (obj) => {
const base64 = obj.base64;
const encrypted = obj.encrypted;
},
error: (error) => { /* ... */ }
}
};
error(ドキュメント)

ドキュメントキャプチャ中にエラーが発生したときに呼び出されます。ErrorBioオブジェクトを受け取ります。エラーコードの完全なリストについては、エラー処理を参照してください。