---
title: ライブネス（生体認証セルフィー）
canonical: https://developer.unico.io/ja/dual-api/developers/sdks-and-tools/android/capture-flow/capture-types/liveness
locale: ja
generated_by: markdown-export
---

ライブネス検証が組み込まれた生体認証セルフィーキャプチャ。SDK は SmartFrames を通じて生体認証上有効なフレームが取得されるまでユーザーをガイドし、画像を Base64 + JWT として返します。

:::secondary[機能]
このキャプチャタイプは **Liveness** 機能を使用します。Liveness の動作に関する概念的な概要については、Liveness 機能のページを参照してください。
:::

## 動作の仕組み

SDK はキャプチャセッション全体を管理します:

1. SmartFrame オーバーレイ付きでカメラを開きます。
2. ユーザーがフレーム内に顔を配置するようにガイドします。
3. ライブネスを検証します — ユーザーが実際に存在する場合にのみセッションが完了します。
4. `base64` と `encrypted`（JWT）を含む `ResultCamera` オブジェクトを返します。

## ライブネスキャプチャの開始

****ステップ 2** — `iAcessoBioSelfie` を実装する**

`iAcessoBioSelfie` はセルフィーキャプチャ結果のコールバックを処理します:

  | メソッド | 説明 |
  |---|---|
  | `onSuccessSelfie(result)` | キャプチャ成功 — `base64`（プレビュー）と `encrypted`（API 用 JWT）を含む `ResultCamera` を返します |
  | `onErrorSelfie(errorBio)` | キャプチャ失敗 — コードと説明を含む `ErrorBio` を返します |

  :::warning[トークンの有効期限]
  `encrypted` を生成してから API に送信するまでの間隔は **10 分** を超えてはなりません。
  :::

  ### Kotlin

    ```kotlin
    val selfieListener = object : iAcessoBioSelfie {
      override fun onSuccessSelfie(result: ResultCamera?) { }
      override fun onErrorSelfie(errorBio: ErrorBio?) { }
    }
    ```

### Java

    ```java
    iAcessoBioSelfie selfieListener = new iAcessoBioSelfie() {
      @Override
      public void onSuccessSelfie(ResultCamera result) { }

      @Override
      public void onErrorSelfie(ErrorBio errorBio) { }
    };
    ```

****ステップ 3** — `prepareCamera` を呼び出す**

`unicoCheckCamera` を初期化し、両方のリスナーを実装した後、SDK 設定と `SelfieCameraListener` を渡して `prepareCamera` を呼び出します:

  - `onCameraReady` — カメラの準備完了。ステップ 2 の `selfieListener` を渡して `open` を呼び出します。
  - `onCameraFailed` — カメラの準備に失敗。エラーメッセージを処理してください。

  ### Kotlin

    ```kotlin
    unicoCheckCamera
      .prepareCamera(UnicoConfig(), object : SelfieCameraListener {
        override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Selfie?) {
          cameraOpener?.open(selfieListener)
        }
        override fun onCameraFailed(message: String?) { }
      })
    ```

### Java

    ```java
    unicoCheckCamera
      .prepareCamera(new UnicoConfig(), new SelfieCameraListener() {
        @Override
        public void onCameraReady(UnicoCheckCameraOpener.Selfie cameraOpener) {
          cameraOpener.open(selfieListener);
        }

        @Override
        public void onCameraFailed(String message) { }
      });
    ```

結果の完全な処理方法については、[結果の受け取り](/developers/sdks-and-tools/android/capture-flow/receiving-the-result)を参照してください。