Android HCEのAIDルーティング:タップに応答するアプリはどう決まるのか
リーダーがSELECT AIDを送ると、Android は応答するHCEサービスを1つ選びます。ルーティングテーブル、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は次の順序で解決します。
- ユーザーのデフォルトのウォレットアプリがそのAIDを登録していれば、そのアプリが呼び出されます。
- そうでなければ、そのAIDを登録したサービスが呼び出されます。
- 複数のサービスが登録していた場合、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つもルーティングされないかのどちらかです。