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

• デバイス認証情報（キーガード）: CHVerificationMethod.DEVICE_KEYGUARD

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

実装例

// CDCVMのデバイス有効性を確認
DeviceCVMEligibilityResult result =
        DeviceCVMEligibilityChecker.checkDeviceEligibility(getApplicationContext());

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