CDCVM方式を設定する

概要

デジタルカードプロファイルは、CDCVM をサポートするかどうかを定義します。

特定のウォレットインスタンスでは、 CDCVM をサポートする最初にプロビジョニングされたカードが が定義する CDCVM メソッド によって使用される デジタルウォレットアプリケーション.

NFC Wallet SDK では、異なる CDCVM メソッドを持つカードを同一のウォレットインスタンス内で共存させることはできません。

で説明されているように CDCVM の処理、ほとんどの NFC Wallet プログラムでは CDCVM を使用します。

このセクションでは、デバイスの機能に基づいて CDCVM メソッドを設定します。 トークン化 CDCVM をサポートする最初のカードの

CDCVM メソッドの設定が必要です

プロファイルが CDCVM をサポートしており、CDCVM メソッドを設定しない場合:

• カード一覧の取得は次のエラーで失敗します: DigitalizedCardErrorCodes.CD_CVM_REQUIRED.
• CDCVM メソッドを設定するまで、NFC 支払いは失敗します。

SDK 連携

CDCVM がサポートされているか確認し、設定する

使用する CHVerificationManager 現在のウォレットインスタンスで CDCVM がサポートされているか、すでに構成されているかを確認します:

• CHVerificationManager.isFCDCVMSupported() CDCVM がサポートされているかを確認します。
• CHVerificationManager.isFCdCvmSet() CDCVM メソッドがすでに設定されているかを確認します。
• CHVerificationManager.getDefaultFCdCvm() デジタルウォレットアプリケーションで使用される CDCVM メソッドを返します。

CDCVM がサポートされていて未設定の場合は、で説明されているように初期化します CDCVM メソッドを設定する.

処理 CD_CVM_REQUIRED カードを一覧表示する際に

CDCVM メソッドを設定せずに、次を使用してカード一覧を取得すると DigitalizedCardManager.getAllCards()、SDK は次を返す場合があります DigitalizedCardErrorCodes.CD_CVM_REQUIRED。その場合は、で説明されているように CDCVM メソッドを初期化します CDCVM メソッドを設定する.

DigitalizedCardManager.getAllCards( new AbstractAsyncHandler<String[]> () {
    
    @Override
    public void onComplete(final AsyncResult<String[]> asyncResult) {
        if (asyncResult.isSuccessful()) {
            // カード一覧の取得に成功しました
        }
        else {
            // カード一覧の取得に失敗しました
            final int errorCode = asyncResult.getErrorCode();
            if (errorCode == DigitalizedCardErrorCodes.CD_CVM_REQUIRED) {
                // ここで CDCVM メソッドを設定します（次のセクションを参照）
                // ....
            }
        }
    }
    
});

CDCVM メソッドを設定する

使用する DeviceCVMManager.initialize(...） デバイスの機能に応じて CDCVM メソッドを設定するには:

• 生体認証: CHVerificationMethod.BIOMETRICS
• デバイス認証情報（keyguard）: CHVerificationMethod.DEVICE_KEYGUARD

CDCVM メソッドを設定した後は、エンドユーザーがデバイスのロック解除方法を変更するシナリオを考慮してください。参照: デバイスのロック解除方法の更新シナリオ.

実装例

// CDCVM に対するデバイスの有効性を確認
DeviceCVM有効性Result result =
        DeviceCVM有効性Checker.checkDeviceEligibility(getApplicationContext());

if (result.getBiometricsSupport() == BiometricsSupport.SUPPORTED) {
    // 生体認証がサポートされています
    try {
        DeviceCVMManager.INSTANCE.initialize(CHVerificationMethod.BIOMETRICS);
    } catch (DeviceCVMException e) {
        // エラーを処理する
    }
}
else if (result.getDeviceKeyguardSupport() == DeviceKeyguardSupport.SUPPORTED) {
    // 生体認証がサポートされていない場合は、デバイスの keyguard を使用します。
    try {
        DeviceCVMManager.INSTANCE.initialize(CHVerificationMethod.DEVICE_KEYGUARD);
    } catch (DeviceCVMException e) {
        // エラーを処理する
    }
}
else {
    // デバイスが CDCVM をサポートしていないか、エンドユーザーがセキュアなロック画面を有効にしていません。
    // エンドユーザーに生体認証またはデバイス認証情報を有効にするよう促します。
}