ガイドに戻る

Android Application Record(AAR):NFCタグでアプリを起動させる方法

Android Application Record(AAR)は、アプリのパッケージ名をNDEFレコードに保存する仕組みです。タグをスキャンするとAndroidがそのアプリを起動し、未インストールならGoogle Playに移動します。

公開日

Android Application Recordとは

Android Application Record(AAR)は、アプリのパッケージ名を保持するNDEFレコードです。タグのメッセージにAARを入れておくと、タグをスキャンしたときにAndroidがそのアプリを起動します。アプリがなければ、インストールのためにGoogle Playへ案内されます。

AARはAndroid 4.0(APIレベル14)で導入されました。Android NFCガイドでは、AARを「NFCタグがスキャンされたときにアプリが起動することをより確実にする」ための手段として説明しています。AARは NdefRecord.createApplicationRecord(packageName) で作成でき、APIリファレンスによると、メッセージ内のどこにでも埋め込めます。

val message = NdefMessage(
    arrayOf(
        NdefRecord.createUri("https://example.com/start"),
        NdefRecord.createApplicationRecord("com.example.myapp")
    )
)

AndroidはNDEFメッセージ全体からAARを探すため、特別な位置に置く必要はありません。必要なのは、Google Playのアプリページに表示されているものと同じ、正確なパッケージ名だけです。

Androidはどのアプリを開くか決めるしくみ

AARがない場合は、一致するインテントフィルターを持つアプリであれば、どれでもそのタグを処理できます。AARがある場合、Androidは次の3つのステップを順番に実行します。

  1. 一致するインテントフィルターを持つアクティビティを探します。そのアクティビティがAARで指定されたアプリのものであれば、そのアプリが起動します。
  2. 一致したアクティビティがAARのアプリのものでない場合、インテントを処理できるアクティビティが複数ある場合、または処理できるものがない場合は、AARで指定されたアプリを起動します。
  3. AARからアプリを起動できない場合、AndroidはダウンロードのためGoogle Playに移動します。

AARはインテントフィルターを飛ばすものではありません。アプリ同士が競合したときに、どれを優先するかを決めるものです。Androidガイドには、AARは「他のアプリが同じインテントをフィルタリングして、配布したタグを意図せず処理してしまうのを防ぐ」のに役立つと書かれています。お客様に配布するタグに、他のNFCアプリが入っている端末で使われる可能性がある場合に重要です。

AARはアプリ単位でのみ機能します。特定の画面を指定することはできません。特定のアクティビティを開きたい場合は、代わりにURIレコードやMIMEレコードのインテントフィルターを使います。

アプリが未インストールの場合

Androidは、AARに指定されたパッケージのGoogle Playページを開きます。リファレンスページでは、最初に挙げられたアプリのマーケットリンクが開く、と説明されています。これにより、タグがインストールへの入り口になり、商品シールやポスターに便利です。アプリがまったく不要なタグについては、アプリなしでタグを読み取るものをご覧ください。

メッセージに複数のAARがある場合、リファレンスによると、アプリは「メッセージ内に現れる順序」で優先されます。

メッセージ内でのAARの置き場所

AARが唯一のレコードである場合を除き、先頭には置かないでください。理由はガイドに説明があります。Androidは最初のレコードを読んで、インテントの作成に使うMIMEタイプまたはURIを判断します。AARが1番目にあると、インテントフィルターが照合する対象がなくなってしまいます。

上の例のように、URIまたはMIMEレコードを先頭に、AARを最後に置いてください。また、AARはAndroid 4.0以降に固有の仕組みのため、より幅広い端末に対応するには、AARをMIMEタイプやURIと組み合わせることがガイドでも推奨されています。Androidのドキュメントには、他のプラットフォームがAARをどう扱うかは書かれていないため、iPhoneでの動作は期待しないでください。URLレコードを入れておけば、iPhoneにも開けるものができます。iPhone用のURLフォールバックを追加するでは、Wi-Fiタグでこの考え方を紹介しています。

AARでは対応できないケース

  • フォアグラウンドディスパッチが優先されます。 AARは、enableForegroundDispatch を呼び出しているアプリには優先されません。Advanced NFCのページによると、この仕組みによってアクティビティは「同じインテントを処理する他のアクティビティよりも優先権を主張」できます。
  • 新しいAndroidでは、ユーザーによる制御が追加されています。 Android 16から、アプリが最初のNFCインテントを受け取ったときにユーザーへ通知され、「NFCによる起動」からブロックできるようになりました。Android 17では、新しいSDKを対象とするアプリに DISPATCH_NFC_MESSAGE 権限が必要になり、停止中のアプリにはNFCインテントが送られなくなります。これらがAARによる起動にどう影響するかはAndroidガイドに書かれていないため、最新のスマートフォンで必ずテストしてください。
  • スマホケースや書き込みの不具合でも、同じ症状が出ることがあります。 No supported app for this NFC tagと表示された場合は、AARのせいと決めつける前に、タグの内容を確認してください。

タグに本当にAARが入っているか確認するには、タグリーダーでレコードを読み戻します。NFCoreならタグに保存された内容を確認できます。Android版もあります。

まとめ

AARは、タグで特定のAndroidアプリを開きたいとき、またはインストールへ誘導したいときに使います。パッケージ名は正確に入力し、AARはURIまたはMIMEレコードの後ろに置いてください。フォアグラウンドのアプリや、新しいAndroidのプライバシー制御が優先される場合があることも想定しておきましょう。完成したタグは、必ず実機でテストしてください。

よくある質問

AARはiPhoneで使えますか?

Androidのドキュメントでは、AARはAndroid 4.0以降の機能として紹介されており、他のプラットフォームでの扱いについては触れられていません。他の環境でもタグが役立つように、AARにURLレコードまたはMIMEレコードを組み合わせ、対象にしたい端末でテストしてください。

アプリがインストールされていない場合はどうなりますか?

AndroidはGoogle Playを開き、AARに指定されたアプリをダウンロードできるようにします。

AARでアプリ内の特定の画面を開けますか?

いいえ。AARはアクティビティ単位ではなく、アプリ単位で機能します。特定のアクティビティを開きたい場合は、メッセージ内の他のレコードにインテントフィルターを使ってください。