4. NFC Wallet SDK を初期化する

NFCウォレットSDKを初期化する

他のSDK APIを呼び出す前にNFCウォレットSDKを初期化してください。

推奨フロー：

1. 必要なプロパティファイルを追加する。

2. をビルドする CustomConfiguration.

3. （オプション）呼び出す SDKInitializer.INSTANCE.configure(...) アプリ起動時に。

4. 呼び出す SDKInitializer.INSTANCE.initialize(...) バックグラウンドスレッドで。

5. 呼び出す MobileGatewayManager.INSTANCE.configure(...) を構成するために Mobile Gateway (MG).

Androidのバージョンを確認する

SDKを初期化する前に、AndroidのバージョンがNFCウォレットAndroid SDKの最小要件を満たしていることを確認してください。

サポートされていないAndroidバージョンではNFCウォレット機能を非表示にしてください。

必要なプロパティファイルを追加する

Androidの次の場所にファイルを作成します デジタルウォレットアプリケーション assets フォルダ：

• mobilegateway.properties

• rages.properties

• gemcbp.properties

Thalesが提供する値を設定してください（以下で明示的に固定値と記載されている場合を除く）。

mobilegateway.properties

mobilegateway.properties の説明

キー	説明
MG_CONNECTION_URL	[String] MGサーバーのURL（Thales提供）。
MG_TRANSACTION_HISTORY_CONNECTION_URL	[String] 取引履歴を取得するためのURL（Thales提供）。
WALLET_PROVIDER_ID	[String] ウォレットプロバイダID。
WALLET_APPLICATION_ID	[String] ウォレットプロバイダのアプリケーションID（任意）。ウォレットプロバイダが複数のウォレットアプリケーションをサポートする場合に必要。
MG_CONNECTION_TIMEOUT	[Integer] 接続タイムアウト（ミリ秒）。推奨値：30000。
MG_CONNECTION_READ_TIMEOUT	[Integer] 読み取りタイムアウト（ミリ秒）。推奨値：30000。
MG_RETRY_COUNTER	[Integer] 再試行回数。推奨値：3。
MG_RETRY_INTERVAL	[Integer] 再試行間の間隔（ミリ秒）。推奨値：10000。

rages.properties

rages.properties の説明

キー	説明
REALM	[String] 固定値： CBP.
OAUTH_CONSUMER_KEY	[String] OAuthコンシューマーキー（Thales提供）。
RAGES_GATEWAY_URL	[String] RAGESゲートウェイのURL（Thales提供）。
RAGES_CONNECTION_TIMEOUT	[Integer] 接続タイムアウト（ミリ秒）。推奨値：30000。
CSR_DOMAIN	[String] HTTPS用の証明書署名要求（CSR）で使用されるドメイン。値についてはThalesのデリバリーチームに問い合わせてください。
CSR_EMAIL	[String] 会社のメールアドレス。

gemcbp.properties

gemcbp.properties の説明

キー	説明
CPS_URL	[String] CPSのURL（Thales提供）。
CPS_CONNECTION_TIMEOUT	[Integer] 接続タイムアウト（ミリ秒）。推奨値：30000。
CPS_READ_TIMEOUT	[Integer] 読み取りタイムアウト（ミリ秒）。推奨値：30000。

支払い動作を構成する

CustomConfiguration は支払い動作を定義します：

• keyValidityPeriod：エンドユーザー認証とPOS端末でのタップの間の時間（秒）。範囲：0–300。デフォルト：45。

• domesticCurrencyCode: ISO 4217 数値通貨コード はLVT（低額取引）支払い時のCDCVMに使用されます。デフォルト：978（EUR）。

CustomConfiguration は追加のリスク管理およびCDCVMパラメータをサポートします。詳細は リスク管理を定義する.

コンタクトレス支払いを実装する際にはこれらのパラメータを確認することを推奨します。

SDKは初期化中に CustomConfiguration を使用します。

/* デフォルトとは異なる値でSDKを初期化する */
CustomConfiguration customConfig = new CustomConfiguration.Builder()
                .domesticCurrencyCode(978)
                .keyValidityPeriod(60)
                .build();

変更しないでください keyValidityPeriod および domesticCurrencyCode 最初の初期化後は。

変更は認証とPOS端末での最終タップの間に遅延や断続的な問題を引き起こす可能性があります。

SDKのクイック構成を実行する（オプション）

を使用して SDKInitializer.INSTANCE.configure(...) Androidの Context, CustomConfigurationとネイティブライブラリを事前読み込みします。

が完了した後、 configure(...) ローカルのSDKストレージを読み取るだけのAPIを呼び出すことができます。

参照してください SDK APIの要件 詳細については。

configure() はSDKのマイグレーションを実行しません。マイグレーションが必要な場合は、 initialize().

MyApp.java

public class MyApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        try {
            // 1. CustomConfigurationを構築します（上記参照）。
            ...

            // 2. SDKがAndroid Contextを持つようにクイック構成を実行します。
            SDKInitializer.INSTANCE.configure(this, customConfig);
        } catch (InternalComponentException e) {
            // ログを記録してinitialize()を続行できます。
        } catch (Exception e) {
            // アプリケーション起動時のクラッシュを防止します。
            // ログを記録してinitialize()を続行できます。
        } catch (Throwable e) {
            // これは起こりにくいです。
            // 万が一発生した場合は、initialize()を呼び出さないでください。
            return;
        }

        // 3. Applicationの起動がブロックされないように、SDKを非同期で初期化します。
        // 下の「SDKを初期化する（支払い）」を参照してください。
    }
}

SDKを初期化する（支払い）

次を使用してSDKの状態を確認してください SDKController.getInstance().getSDKServiceState() 必要な場合にのみ初期化してください。

を使用して SDKInitializer.INSTANCE.initialize(...) 支払いコンポーネントを初期化するには：

• を入力パラメータとして提供してください。 CustomConfiguration このAPIは同期的です。バックグラウンドスレッドから呼び出してください。

• NFCウォレットSDKを初期化する（Java）

final Context appContext = getApplicationContext();

if (SDKController.getInstance().getSDKServiceState() != SDKServiceState.STATE_INITIALIZED) {

Thread sdkInit = new Thread(new Runnable() {
    public void run() {
        @Override
        SDKInitializer.INSTANCE.initialize(appContext, customConfig);
            sdkInit.start();
        }
    });
    初期化APIは冪等です。安全に何度でも呼び出せます。
}

Mobile Gateway (MG) を構成する

SDKの初期化が完了したら、次を呼び出して

を有効にします：トークン化、デジタルカードのLCM、および取引履歴。 MobileGatewayManager.INSTANCE.configure(...) MobileGatewayManager.INSTANCE.getConfigurationState()

を使用して で構成状態を確認します。 Mobile Gateway を構成する（Java）

protected void initMgSdk(@NonNull final Context context) {

final MobileGatewayManager mgManager = MobileGatewayManager.INSTANCE;
    // 複数回の初期化を避ける。

    try {
        if (mgManager.getConfigurationState() == MGSDKConfigurationState.NOT_CONFIGURED) {
        mgManager.configure(context);
            } catch (final MGConfigurationException exception) {
        }
    // エラーをログに記録。
        ウォレットIDを取得する
    }
}

getWalletId()

を使用して から MGCardEnrollmentService を使用してウォレット識別子を取得します。 ウォレットIDを取得する（Java）

MGCardEnrollmentService enrollService = MobileGatewayManager.INSTANCE.getCardEnrollmentService();

String walletId = enrollService.getWalletId();
ウォレットIDの取得中にエラーが発生した場合は

MGSDKException がスローされます。

トラブルシューティングやサポートのためにウォレットIDを使用してください。

SDKはSDKを初めて初期化したときにウォレットIDを生成します：

• ウォレットIDはアプリケーションの再起動間でも安定して保持されます。

• SDKをリセットした場合、ウォレットIDは再生成されます。