3. アプリケーションの起動を考慮する

概要

アプリケーションの起動時に、NFCウォレットSDKを初期化します。

また、デジタルウォレットアプリがサポートする支払いエクスペリエンスを設定します：

• サポート シングルタップ 支払い。

• または、要求する ツータップ 支払い。

を有効にしても、 シングルタップ一部のトランザクションは ツータップをフォールバックすることがあります。参照： シングルタップはツータップにフォールバックすることがあります.

バックグラウンドでの支払いアプリケーション

デジタルウォレットアプリがデフォルトの支払いアプリケーションである場合（参照： デフォルトの支払いアプリ）、Androidはそれをバックグラウンドに保持することがあります。これにより、POS端末からの非接触支払いAPDUに対して、 アプリケーション.

一部のデバイスでは、デフォルトの支払いアプリケーションがバックグラウンドにある間に終了されることがあります。これらのデバイスでは、非接触支払いがアプリケーションのコールドスタートを引き起こす可能性があります。参照： コールドスタートを最適化する.

SDK統合

アプリケーションの起動を更新する

内の Application.onCreate()、アプリケーションは次のことを行う必要があります：

1. SDKのクイック構成を実行します。

2. 期待される支払いエクスペリエンスを設定します：

   • ONE_TAP_ENABLED を設定してサポートする シングルタップ トランザクション

   • TWO_TAP_ALWAYS を設定して、最初のタップ後に常に認証を要求する（常に ツータップ 支払い）

3. 別スレッドでSDKを初期化します。

4. オプション：初期化が成功したら、事前エントリを有効化します。参照： 事前エントリを有効化する.

ステップ1および2については、参照： NFCウォレットSDKを初期化する.

MyApp.java

public class MyApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        
        // 値を変更しないカスタム構成を構築する（最初のSDK初期化以来同じ構成）
        CustomConfiguration customConfig = new CustomConfiguration.Builder()
                .domesticCurrencyCode(978)
                .keyValidityPeriod(60)
                .build();
        
        // 1 - クイック構成を実行する
        // ... SDKが'Context'を持っていることを確認するため
        try {
            SDKInitializer.INSTANCE.configure(this,  customConfig);
        } catch (InternalComponentException e){
            // SDKの内部コンポーネント例外
            // アプリはこれを無視できます、 
            // そして実際のSDK初期化APIを続行し、例外が発生した場合にその場でエラー処理を行います
        } catch (Exception e) {
            // 一般的な例外。これはアプリケーション起動時にクラッシュを引き起こす可能性のある事象を防ぐためのセーフガードです。 
            // 
            // アプリはこれを無視できます、そして実際のSDK初期化APIを続行し、例外が発生した場合にその場でエラー処理を行います
        } catch (Throwable e) {
            // これは起こりにくいことですが、このコードがApplicationクラス内にあるため、
            // アプリケーション全体に影響を与える可能性のあるエラーの影響を最小限にするために、 
            // このエラーをキャッチすることを推奨します。 
            // このエラーが発生した場合、アプリはSDKInitializer.INSTANCE.initialize()を呼び出してはいけません
        }
    
        // 2 - 支払いエクスペリエンスを設定する。
        PaymentExperienceSettings.setPaymentExperience(this, PaymentExperience.ONE_TAP_ENABLED);
        
        // 3 - SDKを初期化する（別スレッドで）
        Thread sdkInit = new Thread(new Runnable() {
            @Override
            public void run() {
                SDKInitializer.INSTANCE.initialize(this, customConfig);
            }
        });
        sdkInit.start();
        
        // 4 - 事前エントリを有効化する（オプション）。
        activatePreEntry();
    }
    
    // 事前エントリを有効化する。
    private void activatePreEntry() {
        final DeviceCVMPreEntryReceiver receiver = new DeviceCVMPreEntryReceiver();
        receiver.init();
        final IntentFilter filter = new IntentFilter(Intent.ACTION_USER_PRESENT);
        registerReceiver(receiver, filter);
    }
    
    

}

シングルタップはツータップにフォールバックすることがあります

を有効にすると、すべてのトランザクションが ONE_TAP_ENABLEDとして実行されるわけではありません。 シングルタップ.

を最良のフローとして扱います。必要な条件が満たされない場合、NFCウォレットSDKは シングルタップ にフォールバックします。 ツータップ.

例：

• エンドユーザーが端末のロック解除後に設定された有効期間内にタップしない場合。参照： keyValidityPeriod 内の NFCウォレットSDKを初期化する.

• 認証なしのLVTトランザクションが設定されたリスク閾値に達する場合。その場合、NFCウォレットSDKは認証を要求します。参照： リスク管理を定義する.

コールドスタート時間を短縮する

一部のデバイスでは、デフォルトの支払いアプリケーションがバックグラウンドにある間に終了されることがあります。これらのデバイスでは、非接触支払いがアプリケーションの コールドスタート.

APDU処理は、 コールドスタート.

直後にすぐに開始されます。

• コールドスタートプロセスには次が含まれます：

• サービスのバインディング（約100〜200ミリ秒） Application.onCreate()

の完了 Application.onCreate()での作業を最小限にします。

NFCウォレットSDKの構成と初期化に限定してください。 Application.onCreate() が開始されてから最初の0.5秒間に他の操作を避けてください。並列処理は、AndroidがPOS端末にAPDUコマンドを送信したときにAPDU処理を遅延させる可能性があります。

必要な場合は、SDK初期化が完了してから少なくとも0.5秒間は非支払いの作業を遅延させてください。

事前エントリを有効化する

をサポートするために事前エントリを使用してください シングルタップ 支払い。

事前エントリにより、エンドユーザーは支払いフローが開始される前に認証できます。

認証は、エンドユーザーが生体認証またはデバイスのキーロック（PIN、パターン、またはパスワード）でデバイスのロックを解除したときに発生します。これにより、追加の検証ステップなしで支払いが可能になります。

このモードが有効になっている場合、デバイスのロック解除ごとに1回の支払いのみが許可されます。

private void activatePreEntry() {
    DeviceCVMPreEntryReceiver receiver = new DeviceCVMPreEntryReceiver();
    receiver.init();
    IntentFilter filter = new IntentFilter(Intent.ACTION_USER_PRESENT);
    registerReceiver(receiver, filter);
}

DeviceCVMPreEntryReceiverに追加のインテントフィルタを追加しないでください、 DeviceCVMPreEntryReceiver。このクラスは、 ACTION_USER_PRESENT インテントのみに反応するように設計されています。