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

概要

NFC Wallet SDK は Android の Host Card Emulation (HCE) をサポートします。これにより 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 ウォレットプログラムによって異なります。一覧は決済ネットワークの担当者に確認してください。

タップして支払う の設定を確認する

HCE サービスを に登録した後、 AndroidManifest.xml次に表示されます タップして支払う Android の設定にて。

確認するには：

1. を開きます 設定 デバイスで。

2. に移動します タップして支払う.

3. アプリケーションが一覧に表示されていることを確認してください。

Android の設定で、アプリケーションがタップして支払うの下に一覧表示されている様子。