ガイドに戻る

Android HCEのAIDルーティング:タップに応答するアプリはどう決まるのか

リーダーがSELECT AIDを送ると、Android は応答するHCEサービスを1つ選びます。ルーティングテーブル、AIDグループ、カテゴリ、競合ルールがどのように結果を決めるのかを解説します。

公開日
Android HCEのAIDルーティング:タップに応答するアプリはどう決まるのか

はじめに

AndroidスマホをリーダーにタップしたときCardをエミュレートできるアプリが複数あっても、応答するアプリはちょうど1つです。Android は、リーダーが要求するApplication ID(AID)、NFCコントローラー内のルーティングテーブル、そして少数の競合ルールを使って決定します。このガイドでは、Androidがバージョン4.4からサポートしているホストカードエミュレーションについて、その流れを順に見ていきます。

リーダーが実際に送るもの

リーダーが最初に送るのは、通常 SELECT AID コマンドです。これはISO-DEP上でやり取りされるAPDUで、リーダーが使いたいアプリケーションを示す最大16バイトのAIDが含まれています。Android HCEガイドによると、AndroidはそのAIDを取り出してHCEサービスに解決し、APDUをそのサービスへ転送します。

以降、サービスはリーダーからのすべてのAPDUを受け取ります。これは、リーダーが別のサービスに解決される SELECT AID を送るか、NFC接続が切れるまで続きます。どちらの場合も、サービスの onDeactivated() コールバックが実行されます。

2つの層:コントローラーのテーブル、そしてAndroid

ルーティングは2回行われます。まず、NFCコントローラーがルールのルーティングテーブルを保持しています。各ルールはAIDと送信先(ホストCPUまたはセキュアエレメント)を対応付けたものです。SELECT AID が届くと、コントローラーはこのテーブルを確認します。一致すれば、そのAPDUと以降のAPDUはすべて該当する送信先に送られます。

AIDがテーブルにない場合、コントローラーはデフォルトルートを使います。Androidデバイスは、アプリが登録したAIDがホストに届くようにすることが求められています。このテーブルを自分で作る必要はありません。Androidが、インストールされているサービスとユーザーの設定から構成します。また、AndroidはHCEデバイスで、ISO 7816-4の部分一致(パーシャルマッチ)の考え方をサポートしていません。

次に、APDUがホストに届くと、AndroidがAIDをサービスに解決します。カード情報をセキュアエレメントに保持するアプリは、代わりにオフホストサービスを宣言します。取引はセキュアエレメントが処理するため、Androidがそれらを起動したりバインドしたりすることはありません。

AIDグループとカテゴリ

サービスはAIDをグループ単位で登録します。グループ内のすべてのAIDについて、Androidは次のどちらかの結果を保証します。すべてがあなたのサービスにルーティングされるか、1つもルーティングされないかです。グループの一部だけが別のアプリに渡ることはありません。

各グループにはカテゴリもあり、payment か other のどちらかです。payment カテゴリのグループを同時に有効にできるのは1つだけです。特定の1店舗だけで使えるプリペイドカードのようなクローズドループのカードは other に入れます。other ではグループを常に有効にしておけます。payment カテゴリのアプリがタップを処理できるのは、ユーザーがそのアプリをデフォルトの決済アプリ(Android 15以降ではWalletロール)に設定している場合、またはフォアグラウンドにあって setPreferredService を呼び出している場合に限られます。

競合したときの優先順位

複数のサービスが同じAIDを登録することがあります。Androidは次の順序で解決します。

  1. ユーザーのデフォルトのウォレットアプリがそのAIDを登録していれば、そのアプリが呼び出されます。
  2. そうでなければ、そのAIDを登録したサービスが呼び出されます。
  3. 複数のサービスが登録していた場合、Androidはユーザーに選択を求めます。

フォアグラウンドのアプリは、これらをすべて上書きできます。CardEmulationリファレンスには setPreferredService が記載されています。OSは設定を保持しないため、onResume() で呼び出し、onPause() で unsetPreferredService を呼び出します。ユーザーがフォアグラウンドアプリによるデフォルト決済サービスの上書きを禁止している場合、この呼び出しは失敗することがあります。

AIDは通常、マニフェストの apduservice.xml から取得されます。16進数で、偶数桁の文字列として記述します。アプリは registerAidsForService を呼び出すこともでき、その場合はそのカテゴリの以前のリストが置き換えられます。一部のデバイスでは A000000004* のようなAIDプレフィックスを受け付けます。お使いの端末が対応しているかどうかは supportsAidPrefixRegistration() で確認できます。

意図しないアプリが応答するとき

タップが意図しないアプリに届いてしまう場合は、次のリストを順に確認してください。

  • AIDグループが分割されていませんか? 一緒に扱うべきAIDは1つのグループにまとめましょう。
  • 別のアプリがデフォルトのウォレットになっていませんか? そのアプリが登録したAIDについては、あなたのサービスより優先されます。
  • 本来 other にすべきグループが payment になっていませんか?
  • プレフィックスマッチに対応していないデバイスで、それに頼っていませんか?
  • アクティビティの再開後に setPreferredService を再度呼び出し忘れていませんか?

NFCoreは、iOSとAndroidでNFCタグの読み取り、書き込み、検査ができるアプリです。HCEのルーティングを追跡するためのツールではないため、これらの確認には2台目のリーダーを使い、どのサービスが SELECT AID をログに記録するかを見てください。

まとめ

Androidは2段階でタップに応答します。まずNFCコントローラーのルーティングテーブルがAIDをホストまたはセキュアエレメントに振り分け、次にAndroidがデフォルトのウォレット、唯一の登録者、ユーザーの選択のいずれかでサービスを1つ選びます。フォアグラウンドのアプリはこれを上書きできます。関連するAIDは1つのグループにまとめ、適切なカテゴリを選び、再開のたびに優先サービスを設定しましょう。

よくある質問

Androidはどのようにしてタップに応答するHCEアプリを決めるのですか?

リーダーが SELECT AID を送ります。AndroidはそのAIDをサービスに解決します。デフォルトのウォレットアプリがそのAIDを登録していればそのアプリ、次にそのAIDを登録した唯一のサービスの順です。複数ある場合はユーザーに尋ねます。setPreferredService を使うフォアグラウンドのアプリは、これを上書きします。

2つのアプリが同じAIDを登録できますか?

はい。Androidはこれを許可しており、タップ時に上記の順序で競合を解決します。複数のサービスがAIDを登録していて、優先サービスがない場合は、ユーザーに選択を求めます。

AndroidはAIDのプレフィックスマッチに対応していますか?

ISO 7816-4の部分一致は、AndroidのHCEデバイスではサポートされていません。ただし、一部のデバイスではアプリがAIDプレフィックスを登録できます。確認するには supportsAidPrefixRegistration() を呼び出してください。

AIDグループを2つのアプリに分割できますか?

いいえ。グループ内のすべてのAIDがそのサービスにルーティングされるか、1つもルーティングされないかのどちらかです。