In diesem Dokument werden erweiterte NFC-Themen beschrieben, z. B. die Arbeit mit verschiedenen Tag-Technologien, das Schreiben auf NFC-Tags und die Weiterleitung im Vordergrund, die es einer Anwendung im Vordergrund ermöglicht, Intents zu verarbeiten, auch wenn andere Anwendungen nach denselben Intents filtern.
Mit unterstützten Tag-Technologien arbeiten
Bei der Arbeit mit NFC-Tags und Android-Geräten ist NDEF das Hauptformat, das Sie zum Lesen und Schreiben von Daten auf Tags verwenden. Wenn ein Gerät ein Tag mit NDEF-Daten scannt, unterstützt Android das Parsen der Nachricht und die Bereitstellung in einem NdefMessage, sofern möglich. Es kann jedoch vorkommen, dass ein Tag gescannt wird, der keine NDEF-Daten enthält, oder dass die NDEF-Daten keinem MIME-Typ oder URI zugeordnet werden können.
In diesen Fällen müssen Sie die Kommunikation direkt mit dem Tag öffnen und mit Ihrem eigenen Protokoll (in Rohbyte) darauf lesen und schreiben. Android bietet allgemeine Unterstützung für diese Anwendungsfälle mit dem Paket android.nfc.tech, das in Tabelle 1 beschrieben wird. Mit der Methode getTechList() können Sie die vom Tag unterstützten Technologien ermitteln und das entsprechende TagTechnology-Objekt mit einer der von android.nfc.tech bereitgestellten Klassen erstellen.
Tabelle 1. Unterstützte Tag-Technologien
| Klasse | Beschreibung |
|---|---|
TagTechnology |
Die Schnittstelle, die alle Tag-Technologieklassen implementieren müssen. |
NfcA |
Bietet Zugriff auf NFC-A-Eigenschaften (ISO 14443-3A) und E/A-Vorgänge. |
NfcB |
Bietet Zugriff auf NFC-B-Eigenschaften (ISO 14443-3B) und E/A-Vorgänge. |
NfcF |
Ermöglicht den Zugriff auf NFC-F-Eigenschaften (JIS 6319-4) und E/A-Vorgänge. |
NfcV |
Bietet Zugriff auf NFC-V-Eigenschaften (ISO 15693) und E/A-Vorgänge. |
IsoDep |
Bietet Zugriff auf ISO-DEP-Eigenschaften (ISO 14443-4) und E/A-Vorgänge. |
Ndef |
Ermöglicht den Zugriff auf NDEF-Daten und -Vorgänge auf NFC-Tags, die als NDEF formatiert wurden. |
NdefFormatable |
Stellt Formatierungsvorgänge für Tags bereit, die möglicherweise NDEF-formatierbar sind. |
Die folgenden Tag-Technologien müssen von Android-Geräten nicht unterstützt werden.
Tabelle 2. Optional unterstützte Tag-Technologien
| Klasse | Beschreibung |
|---|---|
MifareClassic |
Ermöglicht den Zugriff auf MIFARE Classic-Eigenschaften und ‑E/A-Vorgänge, wenn dieses Android-Gerät MIFARE unterstützt. |
MifareUltralight |
Bietet Zugriff auf MIFARE Ultralight-Eigenschaften und E/A-Vorgänge, wenn dieses Android-Gerät MIFARE unterstützt. |
Mit Tag-Technologien und dem Intent „ACTION_TECH_DISCOVERED“ arbeiten
Wenn ein Gerät ein Tag scannt, das NDEF-Daten enthält, aber nicht einem MIME-Typ oder URI zugeordnet werden konnte, versucht das Tag-Versandsystem, eine Aktivität mit dem Intent ACTION_TECH_DISCOVERED zu starten. Die ACTION_TECH_DISCOVERED wird auch verwendet, wenn ein Tag mit Nicht-NDEF-Daten gescannt wird. Mit diesem Fallback können Sie direkt mit den Daten im Tag arbeiten, wenn das Tag-Versandsystem sie nicht für Sie parsen konnte. Die grundlegenden Schritte bei der Arbeit mit Tag-Technologien sind:
- Filtern Sie nach einem
ACTION_TECH_DISCOVERED-Intent, der die Tag-Technologien angibt, die Sie verarbeiten möchten. Weitere Informationen findest du unter Nach NFC-Intents filtern. Im Allgemeinen versucht das Tag-Versandsystem, einenACTION_TECH_DISCOVERED-Intent zu starten, wenn eine NDEF-Nachricht keinem MIME-Typ oder URI zugeordnet werden kann oder wenn das gescannte Tag keine NDEF-Daten enthält. Weitere Informationen dazu, wie dies bestimmt wird, finden Sie unter Das Tag-Versandsystem. - Wenn Ihre Anwendung den Intent empfängt, rufen Sie das
Tag-Objekt aus dem Intent ab:Kotlin
var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
Java
Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
- Rufen Sie eine Instanz von
TagTechnologyab, indem Sie eine derget-Factory-Methoden der Klassen im Paketandroid.nfc.techaufrufen. Sie können die unterstützten Technologien des Tags auflisten, indem SiegetTechList()aufrufen, bevor Sie eineget-Factory-Methode aufrufen. So rufen Sie beispielsweise eine Instanz vonMifareUltralightaus einemTagab:Kotlin
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG))
Java
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG));
Tags lesen und schreiben
Zum Lesen und Schreiben eines NFC-Tags muss das Tag aus dem Intent abgerufen und die Kommunikation mit dem Tag geöffnet werden. Sie müssen einen eigenen Protokollstack definieren, um Daten auf dem Tag zu lesen und zu schreiben. Beachte jedoch, dass du NDEF-Daten weiterhin lesen und schreiben kannst, wenn du direkt mit einem Tag arbeitest. Wie Sie die Dinge strukturieren, bleibt Ihnen überlassen. Das folgende Beispiel zeigt, wie Sie mit einem MIFARE Ultralight-Tag arbeiten.
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; } }
Vordergrund-Dispatch-System verwenden
Das System zur Weiterleitung im Vordergrund ermöglicht es einer Aktivität, einen Intent abzufangen und Priorität gegenüber anderen Aktivitäten zu beanspruchen, die denselben Intent verarbeiten. Dazu müssen einige Datenstrukturen erstellt werden, damit das Android-System die entsprechenden Intents an deine Anwendung senden kann. So aktivieren Sie das Vordergrund-Versandsystem:
- Fügen Sie den folgenden Code in die Methode
onCreate()Ihrer Aktivität ein:- Erstelle ein änderbares
PendingIntent-Objekt, damit das Android-System es beim Scannen mit den Details des Tags füllen kann.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);
- Deklarieren Sie Intent-Filter, um die Intents zu verarbeiten, die Sie abfangen möchten. Das System zur Weiterleitung im Vordergrund vergleicht die angegebenen Intent-Filter mit dem Intent, der empfangen wird, wenn das Gerät ein Tag scannt. Wenn sie übereinstimmt, verarbeitet Ihre Anwendung den Intent. Wenn es nicht übereinstimmt, greift das Vordergrund-Versandsystem auf das Intent-Versandsystem zurück.
Wenn Sie ein
null-Array von Intent- und Technologiefiltern angeben, werden alle Tags gefiltert, die auf denTAG_DISCOVERED-Intent zurückgreifen. Das folgende Code-Snippet verarbeitet alle MIME-Typen fürNDEF_DISCOVERED. Sie sollten nur die verarbeiten, die Sie benötigen.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, };
- Richten Sie ein Array von Tag-Technologien ein, die Ihre Anwendung verarbeiten soll. Rufen Sie die Methode
Object.class.getName()auf, um die Klasse der Technologie abzurufen, die Sie unterstützen möchten.Kotlin
techListsArray = arrayOf(arrayOf<String>(NfcF::class.java.name))
Java
techListsArray = new String[][] { new String[] { NfcF.class.getName() } };
- Erstelle ein änderbares
- Überschreiben Sie die folgenden Lebenszyklus-Callbacks für Aktivitäten und fügen Sie Logik hinzu, um die Weiterleitung im Vordergrund zu aktivieren und zu deaktivieren, wenn die Aktivität den Fokus verliert (
onPause()) und wiedererlangt (onResume()).enableForegroundDispatch()muss aus dem Hauptthread aufgerufen werden und nur, wenn die Aktivität im Vordergrund ist. Das ist der Fall, wenn der Aufruf inonResume()erfolgt. Außerdem musst du den CallbackonNewIntentimplementieren, um die Daten vom gescannten NFC-Tag zu verarbeiten.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 }