1. HCEサービスを実装する

概要

NFC Wallet SDKはAndroid Host Card Emulation（HCE）をサポートしています。これにより、NFCカードのエミュレーションと、NFCを介したPOS端末とのAPDU交換が可能になります。

詳細については、Androidのドキュメントを参照してください： ホストベースのカードエミュレーションの概要.

続行するには、まずこのセクションで説明されているとおりにHCEサービスを実装します。

サービスを登録したら、次の項目の下に表示されることを確認します タップ＆ペイ Androidの設定で。

SDKの統合

継承する AsyncHCEService

非接触決済を処理するには、次を継承してAPDU処理を有効にします AsyncHCEService.

どのメソッドもオーバーライドする必要はありません。

APDU処理をログ出力またはカスタマイズしたい場合にのみ、オーバーライドを使用してください。

public class MyHCEService extends AsyncHCEService {

    // 'processCommandApdu' のオーバーライドは任意です
    // デジタルウォレットアプリケーションはAPDU処理時間を取得できます。
    @Override
    public byte[] processCommandApdu(byte[] inputApdu, Bundle bundle) {
        // SDKの値（常に 'null'）を返します。
        // APDU処理は非同期です。
        // SDKは応答APDUを自動的にPOS端末へ送信します。
        return super.processCommandApdu(inputApdu, bundle);
    }

    // 'onApduResponse' のオーバーライドは任意です
    // デジタルウォレットアプリケーションは応答APDUを確認またはオーバーライドできます。
    @Override
    public boolean onApduResponse(final byte[] inputApdu, final Bundle extras, final byte[] responseApdu){
        // デジタルウォレットアプリケーションは responseApdu をログ出力できます。

        // 応答を上書きしてPOS端末に返信したい場合：
        // 1. responseAPDUを変更する
        // 2. sendResponseApdu(modifiedResponseApdu);
        // 3. true を返します。これにより、応答がすでに送信済みであることをSDKに伝えます。

        // それ以外の場合は false を返し、SDKに responseApdu を送信させます。
        return false;
    }
}

認証が必要な場合、NFC Wallet SDKはAPDU処理を一時停止します。

APDU処理は、認証が成功した、中止された、またはHCEサービスが無効化された後に再開されます。

一部のデバイスでは、次のバックグラウンド起動がブロックされます Activity ステップアップ認証プロンプト用の。これにより、次を呼び出すまで非接触決済がブロックされることがあります deactivate().

デジタルウォレットアプリケーションでタイムアウトを実装し、次を呼び出して deactivate() 非接触決済のフローのブロックを解除できます。

サービスを次に登録します AndroidManifest.xml

HCEサービス（次を継承するクラス）を登録します AsyncHCEServiceを次のように HOST_APDU_SERVICE マニフェストに記述します。

<!-- サービス名はパッケージ構成と一致している必要があります。 -->
<service android:name="com.mycompany.myapplication.myservices.MyHCEService"
  android:exported="true"
  android:label="@string/app_name"
  android:permission="android.permission.BIND_NFC_SERVICE">
  <intent-filter>
    <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
  </intent-filter>
  <meta-data
    android:name="android.nfc.cardemulation.host_apdu_service"
    android:resource="@xml/apduservice"/>
</service>

作成する apduservice.xml 次に res/xml サポートされるAIDを宣言します。

サポートされるAIDを宣言する

作成する apduservice.xml 次に res/xml.

サポートするPPSE AIDと決済ネットワークのAIDを宣言します。

 <?xml version="1.0" encoding="utf-8"?>
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
  android:description="@string/hce_service_description"
  android:requireDeviceUnlock="false"
  android:apduServiceBanner="@drawable/hce_banner">
  <aid-group
    android:description="@string/aid_description"
    android:category="payment">
    <!-- 必須のPPSE AID -->
    <aid-filter android:name="325041592E5359532E4444463031"/>
    <!-- MastercardのAID -->
    <aid-filter android:name="A0000000041010"/>
    <aid-filter android:name="A0000000043060"/>
    <aid-filter android:name="A0000000042010"/>
    <!-- VisaのAID -->
    <aid-filter android:name="A0000000031010"/>
    <aid-filter android:name="A0000000980840"/>
    <aid-filter android:name="A0000000032020"/>
    <aid-filter android:name="A0000000032010"/>
    
  </aid-group>
</host-apdu-service>

上の例では：

• 必須のPPSE AIDは次のとおりです：

  • 325041592E5359532E4444463031
• MastercardのAIDは次のとおりです：

  • A0000000041010
  • A0000000043060
  • A0000000042010
• VisaのAIDは次のとおりです：

  • A0000000031010
  • A0000000980840
  • A0000000032020
  • A0000000032010

AIDの一覧はNFC Walletプログラムによって異なります。決済ネットワークの担当者に一覧を確認してください。

タップ＆ペイの設定を確認する

HCEサービスを次に登録したら AndroidManifest.xml、次の項目の下に表示されます タップ＆ペイ Androidの設定で。

確認するには：

1. 開く 設定 をデバイスで。
2. 次へ移動する タップ＆ペイ.
3. アプリケーションが一覧に表示されていることを確認します。

Androidの設定で、アプリケーションがTap and Payの下に一覧表示されている画面。