4. NFC Wallet SDKを初期化する

NFC Wallet SDK を初期化する

他の SDK API を呼び出す前に NFC Wallet SDK を初期化してください。

推奨フロー:

1. 必要なプロパティファイルを追加します。
2. 作成する CustomConfiguration.
3. （任意） SDKInitializer.INSTANCE.configure(...) をアプリ起動時に呼び出します。
4. 呼び出します SDKInitializer.INSTANCE.initialize(...) をバックグラウンドスレッドで呼び出します。
5. 呼び出します MobileGatewayManager.INSTANCE.configure(...) を設定するために Mobile Gateway（MG）.

Android バージョンを確認する

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

サポート対象外の Android バージョンでは NFC Wallet の機能を非表示にします。

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

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) {
            // Application 起動時のクラッシュを防ぎます。
            // ログを出力して initialize() を続行できます。
        } catch (Throwable e) {
            // これは起こりにくいです。
            // もし発生した場合は initialize() を呼び出さないでください。
            return;
        }

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

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

SDK の状態を SDKController.getInstance().getSDKServiceState() で確認し、必要な場合のみ初期化します。

使用する SDKInitializer.INSTANCE.initialize(...) 支払いコンポーネントを初期化するために:

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

NFC Wallet SDK を初期化する（Java）

final Context appContext = getApplicationContext();

if (SDKController.getInstance().getSDKServiceState() != SDKServiceState.STATE_INITIALIZED) {
    Thread sdkInit = new Thread(new Runnable() {
        @Override
        public void run() {
            SDKInitializer.INSTANCE.initialize(appContext, customConfig);
        }
    });
    sdkInit.start();
}

初期化 API は冪等です。複数回呼び出しても安全です。

Mobile Gateway（MG）を設定する

SDK の初期化が完了したら、 MobileGatewayManager.INSTANCE.configure(...) を呼び出して、トークナイゼーション、デジタルカード LCM、および取引履歴を有効にします。

使用する 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();

MGSDKException は、ウォレット ID の取得中にエラーが発生した場合にスローされます。

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

SDK を初めて初期化すると、SDK はウォレット ID を生成します:

• ウォレット ID はアプリケーションの再起動後も変わりません。
• SDK をリセットすると、ウォレット ID は再生成されます。