Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.

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 サービスが無効化されたときに再開されます。

サービスを登録する場所: AndroidManifest.xml

HCE サービス(を拡張したクラス)をとして登録します AsyncHCEService) として HOST_APDU_SERVICE マニフェスト内に。

作成 apduservice.xmlres/xml でサポートする AID を宣言します。

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

作成 apduservice.xmlres/xml.

PPSE AID とサポートする決済ネットワークの AID を宣言してください。

上記の例では:

  • 必須の PPSE AID は:

    • 325041592E5359532E4444463031

  • Mastercard の AID は:

    • A0000000041010

    • A0000000043060

    • A0000000042010

  • Visa の AID は:

    • A0000000031010

    • A0000000980840

    • A0000000032020

    • A0000000032010

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

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

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

確認するには:

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

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

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

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

最終更新

役に立ちましたか?