このドキュメントでは、さまざまなタグ技術の使用、 NFC タグへの書き込み、フォアグラウンド ディスパッチ（フォアグラウンドのアプリが 他のアプリが同じインテントをフィルタしている場合でも、インテントを処理できます。
サポートされているタグ テクノロジーを利用する
NFC タグや Android 搭載デバイスを使用する場合、読み取りに使用する主な形式は、
タグへの書き込みデータは NDEF です。デバイスが NDEF データが含まれるタグをスキャンすると、Android は以下をサポートします。
メッセージの解析と NdefMessage での配信に
考えていますただし、一部の URL が含まれていないタグをスキャンし、
NDEF データの場合、または NDEF データを MIME タイプまたは URI にマッピングできなかった場合。
そのような場合は、タグと直接通信し、
独自のプロトコル（生のバイト単位）でエンコードされます。Android は、
android.nfc.tech パッケージ（表 1 を参照）Google Chat では
getTechList() メソッドを使用して、テクノロジーを判別する
対応する TagTechnology を作成します。
android.nfc.tech で提供されるクラスのいずれかを持つオブジェクト
表 1. サポートされているタグ テクノロジー
| クラス | 説明 |
|---|---|
TagTechnology |
すべてのタグ テクノロジー クラスで実装する必要があるインターフェースです。 |
NfcA |
NFC-A（ISO 14443-3A）プロパティと I/O オペレーションへのアクセスを提供します。 |
NfcB |
NFC-B（ISO 14443-3B）プロパティと I/O オペレーションへのアクセスを提供します。 |
NfcF |
NFC-F（JIS 6319-4）プロパティと I/O オペレーションへのアクセスを提供します。 |
NfcV |
NFC-V（ISO 15693）プロパティと I/O オペレーションへのアクセスを提供します。 |
IsoDep |
ISO-DEP（ISO 14443-4）プロパティと I/O オペレーションへのアクセスを提供します。 |
Ndef |
次のようにフォーマットされた NFC タグの NDEF データとオペレーションへのアクセスを提供します。 NDEF。 |
NdefFormatable |
NDEF にフォーマット可能なタグに対するフォーマット オペレーションを提供します。 |
以下のタグ技術は、Android 搭載デバイスでサポートされている必要はありません。
表 2. サポートされているタグ テクノロジー（オプション）
| クラス | 説明 |
|---|---|
MifareClassic |
この Android デバイスの場合、MIFARE Classic プロパティと I/O オペレーションへのアクセス権を付与します MIFARE をサポートしています |
MifareUltralight |
この Android の場合、MIFARE Ultralight プロパティと I/O オペレーションへのアクセスを提供します。 MIFARE をサポートしている。 |
タグ テクノロジーと ACTION_TECH_DISCOVERED インテントを利用する
デバイスが NDEF データが含まれているタグをスキャンしたものの、MIME または URI にマッピングできなかった場合、
タグ ディスパッチ システムが ACTION_TECH_DISCOVERED でアクティビティの開始を試みます。
使用します。ACTION_TECH_DISCOVERED は、タグが
スキャンされます。この代替を使用すると、タグ上のデータを操作できるようになります。
直接渡されます。基本的な手順としては、
3 つあります
ACTION_TECH_DISCOVEREDインテントをフィルタして、 使用するタグ技術を選択しますNFC のフィルタリングをご覧ください。 インテントをご覧ください。一般に、タグ ディスパッチ システムは、NDEF メッセージを受け取ったときにACTION_TECH_DISCOVEREDインテントを開始しようとします。 MIME タイプまたは URI にマッピングできない、またはスキャンされたタグに NDEF データが含まれていない場合。対象 この決定方法の詳細については、タグ ディスパッチ システムをご覧ください。- アプリがインテントを受け取ったら、
Tagオブジェクトを取得します。 使用します。Kotlin
var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
Java
Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
- 次のいずれかを呼び出して、
TagTechnologyのインスタンスを取得します。android.nfc.techパッケージ内のクラスのgetファクトリ メソッド。Google Chat ではgetファクトリ メソッドを呼び出す前にgetTechList()を呼び出して、タグでサポートされている技術を列挙するたとえば、インスタンスを取得するには、MifareUltralightをTagから作成する場合は、次の操作を行います。Kotlin
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG))
Java
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG));
タグを読み書きする
NFC タグの読み取りと書き込みでは、インテントからタグを取得し、 タグとの通信を開始しますデータを読み書きするには、独自のプロトコル スタックを定義する必要がある 追加します。ただし、作業中は NDEF データの読み取りと書き込みを行うことは可能です。 直接渡されます。どのように構築するかはユーザー次第です。「 次の例は、MIFARE Ultralight タグの操作方法を示しています。
Kotlin
package com.example.android.nfc import android.nfc.Tag import android.nfc.tech.MifareUltralight import java.io.IOException import java.nio.charset.Charset class MifareUltralightTagTester { fun writeTag(tag: Tag, tagText: String) { MifareUltralight.get(tag)?.use { ultralight -> ultralight.connect() Charset.forName("US-ASCII").also { usAscii -> ultralight.writePage(4, "abcd".toByteArray(usAscii)) ultralight.writePage(5, "efgh".toByteArray(usAscii)) ultralight.writePage(6, "ijkl".toByteArray(usAscii)) ultralight.writePage(7, "mnop".toByteArray(usAscii)) } } } fun readTag(tag: Tag): String? { return MifareUltralight.get(tag)?.use { mifare -> mifare.connect() val payload = mifare.readPages(4) String(payload, Charset.forName("US-ASCII")) } } }
Java
package com.example.android.nfc; import android.nfc.Tag; import android.nfc.tech.MifareUltralight; import android.util.Log; import java.io.IOException; import java.nio.charset.Charset; public class MifareUltralightTagTester { private static final String TAG = MifareUltralightTagTester.class.getSimpleName(); public void writeTag(Tag tag, String tagText) { MifareUltralight ultralight = MifareUltralight.get(tag); try { ultralight.connect(); ultralight.writePage(4, "abcd".getBytes(Charset.forName("US-ASCII"))); ultralight.writePage(5, "efgh".getBytes(Charset.forName("US-ASCII"))); ultralight.writePage(6, "ijkl".getBytes(Charset.forName("US-ASCII"))); ultralight.writePage(7, "mnop".getBytes(Charset.forName("US-ASCII"))); } catch (IOException e) { Log.e(TAG, "IOException while writing MifareUltralight...", e); } finally { try { ultralight.close(); } catch (IOException e) { Log.e(TAG, "IOException while closing MifareUltralight...", e); } } } public String readTag(Tag tag) { MifareUltralight mifare = MifareUltralight.get(tag); try { mifare.connect(); byte[] payload = mifare.readPages(4); return new String(payload, Charset.forName("US-ASCII")); } catch (IOException e) { Log.e(TAG, "IOException while reading MifareUltralight message...", e); } finally { if (mifare != null) { try { mifare.close(); } catch (IOException e) { Log.e(TAG, "Error closing tag...", e); } } } return null; } }
フォアグラウンド ディスパッチ システムを使用する
フォアグラウンド ディスパッチ システムにより、アクティビティはインテントとクレームをインターセプトできる 同じインテントを処理する他のアクティビティよりも優先されます。このシステムを使用するには、 データ構造をいくつか作成して、Android システムが 追加できます。フォアグラウンド ディスパッチ システムを有効にするには:
- アクティビティの
onCreate()メソッドに次のコードを追加します。 <ph type="x-smartling-placeholder">- </ph>
- Android システムが入力できるように、可変の
PendingIntentオブジェクトを作成する タグの詳細が表示されます。Kotlin
val intent = Intent(this, javaClass).apply { addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP) } var pendingIntent: PendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_MUTABLE)
Java
PendingIntent pendingIntent = PendingIntent.getActivity( this, 0, new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), PendingIntent.FLAG_MUTABLE);
- インターセプトするインテントを処理するインテント フィルタを宣言します。前景
ディスパッチ システムは、受け取ったインテントを使用して、指定されたインテント フィルタをチェックします。
デバイスがタグをスキャンします一致した場合、アプリはそのインテントを処理します。発生した場合
一致しない場合、フォアグラウンド ディスパッチ システムはインテント ディスパッチ システムにフォールバックします。
インテント フィルタとテクノロジー フィルタの
null配列を指定すると、TAG_DISCOVEREDにフォールバックするすべてのタグを表示するフィルタ 使用します。以下のコード スニペットは、NDEF_DISCOVEREDの MIME タイプをすべて処理します。マイページ 必要な処理のみを処理すべきですKotlin
val ndef = IntentFilter(NfcAdapter.ACTION_NDEF_DISCOVERED).apply { try { addDataType("*/*") /* Handles all MIME based dispatches. You should specify only the ones that you need. */ } catch (e: IntentFilter.MalformedMimeTypeException) { throw RuntimeException("fail", e) } } intentFiltersArray = arrayOf(ndef)
Java
IntentFilter ndef = new IntentFilter(NfcAdapter.ACTION_NDEF_DISCOVERED); try { ndef.addDataType("*/*"); /* Handles all MIME based dispatches. You should specify only the ones that you need. */ } catch (MalformedMimeTypeException e) { throw new RuntimeException("fail", e); } intentFiltersArray = new IntentFilter[] {ndef, };
- アプリケーションで処理するタグ テクノロジーの配列を設定します。呼び出し
Object.class.getName()メソッドを使用して、目的のテクノロジーのクラスを取得します。 提供しますKotlin
techListsArray = arrayOf(arrayOf<String>(NfcF::class.java.name))
Java
techListsArray = new String[][] { new String[] { NfcF.class.getName() } };
- Android システムが入力できるように、可変の
- 次のアクティビティのライフサイクル コールバックをオーバーライドし、
アクティビティが失われたときのフォアグラウンド ディスパッチ（
onPause()） （onResume()）フォーカスを取り戻します。enableForegroundDispatch()は、 アクティビティがフォアグラウンドにある場合にのみ、メインスレッドで実行します（onResume()を呼び出すとこれが保証されます）。また、スキャンされた NFC からのデータを処理するためにonNewIntentコールバックを実装する必要もあります。 できます。
Kotlin
public override fun onPause() { super.onPause() adapter.disableForegroundDispatch(this) } public override fun onResume() { super.onResume() adapter.enableForegroundDispatch(this, pendingIntent, intentFiltersArray, techListsArray) } public override fun onNewIntent(intent: Intent) { val tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG) // do something with tagFromIntent }
Java
public void onPause() { super.onPause(); adapter.disableForegroundDispatch(this); } public void onResume() { super.onResume(); adapter.enableForegroundDispatch(this, pendingIntent, intentFiltersArray, techListsArray); } public void onNewIntent(Intent intent) { Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG); // do something with tagFromIntent }