指紋のスキャン

指紋認証を使用するための Xamarin.Android アプリケーションの準備方法がわかったので、次に、FingerprintManager.Authenticate メソッドに戻り、Android 6.0 の指紋認証でのその場所について説明します。 次の一覧では、指紋認証のワークフローの概要を説明します。

  1. FingerprintManager.Authenticate を呼び出し、CryptoObject と FingerprintManager.AuthenticationCallback のインスタンスを渡します。 CryptoObject を使用して、指紋認証の結果が改ざんされていないことを確認します。
  2. FingerprintManager.AuthenticationCallback クラスをサブクラス化します。 指紋認証を開始するときに、このクラスのインスタンスを FingerprintManager に提供します。 指紋スキャナーが終了すると、このクラスのコールバック メソッドの 1 つが呼び出されます。
  3. デバイスで指紋スキャナーが開始され、ユーザーの操作を待機していることをユーザーに通知するように、UI を更新するコードを記述します。
  4. 指紋スキャナーが完了すると、前のステップで提供した FingerprintManager.AuthenticationCallback インスタンスのメソッドを呼び出すことにより、結果がアプリケーションに返されます。
  5. アプリケーションで、指紋認証の結果をユーザーに通知し、必要に応じて結果に対応します。

次のコード スニペットは、指紋のスキャンを開始するアクティビティ内のメソッドの例です。

protected void FingerPrintAuthenticationExample()
{
    const int flags = 0; /* always zero (0) */

    // CryptoObjectHelper is described in the previous section.
    CryptoObjectHelper cryptoHelper = new CryptoObjectHelper();    
    
    // cancellationSignal can be used to manually stop the fingerprint scanner. 
    cancellationSignal = new Android.Support.V4.OS.CancellationSignal();
    
    FingerprintManagerCompat fingerprintManager = FingerprintManagerCompat.From(this);
    
    // AuthenticationCallback is a base class that will be covered later on in this guide.
    FingerprintManagerCompat.AuthenticationCallback authenticationCallback = new MyAuthCallbackSample(this);

    // Start the fingerprint scanner.
    fingerprintManager.Authenticate(cryptoHelper.BuildCryptoObject(), flags, cancellationSignal, authenticationCallback, null);
}

Authenticate メソッドの各パラメーターについてもう少し詳しく説明します。

  • 最初のパラメーターは、指紋スキャンの結果を認証するために指紋スキャナーで使用される crypto オブジェクトです。 このオブジェクトが null の場合、アプリケーションでは、指紋の結果が改ざんされていないことを無条件に信頼する必要があります。 null ではなく、CryptoObject をインスタンス化して FingerprintManager に提供することをお勧めします。 「CryptObject の作成」では、Cipher に基づいて CryptoObject をインスタンス化する方法について詳しく説明します。
  • 2 番目のパラメーターは常に 0 です。 Android のドキュメントでは、これはフラグのセットと説明されており、おそらくは将来使用するために予約されています。
  • 3 番目のパラメーター cancellationSignal は、指紋スキャナーをオフにして現在の要求をキャンセルするために使用されるオブジェクトです。 これは Android の CancellationSignal であり、.NET Framework の型ではありません。
  • 4 番目のパラメーターは必須であり、AuthenticationCallback 抽象クラスをサブクラス化するクラスです。 このクラスのメソッドは、FingerprintManager が終了したこと、および結果をクライアントに通知するために呼び出されます。 AuthenticationCallback の実装については理解することがたくさんあるので、独立したセクションで説明します。
  • 5 番目のパラメーターは、省略可能な Handler インスタンスです。 Handler オブジェクトを提供すると、FingerprintManager では、指紋ハードウェアからのメッセージを処理するときに、そのオブジェクトの Looper が使用されます。 通常は、Handler を提供する必要はなく、FingerprintManager ではアプリケーションの Looper が使用されます。

指紋のスキャンを取り消す

ユーザー (またはアプリケーション) が、開始後に指紋スキャンを取り消すことが必要になる場合があります。 このような場合は、指紋スキャンを開始するための呼び出し時に FingerprintManager.Authenticate に提供された CancellationSignal で IsCancelled メソッドを呼び出します。

Authenticate メソッドの重要なパラメーターについてさらに詳しく説明します。 最初の「認証コールバックへの応答」では、FingerprintManager.AuthenticationCallback をサブクラス化し、指紋スキャナーから提供された結果に Android アプリケーションで対応できるようにする方法を説明します。

  • Last updated on