Erweiterte NFC – Übersicht

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:

  1. 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, einen ACTION_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.
  2. 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);
  3. Rufen Sie eine Instanz von TagTechnology ab, indem Sie eine der get-Factory-Methoden der Klassen im Paket android.nfc.tech aufrufen. Sie können die unterstützten Technologien des Tags auflisten, indem Sie getTechList() aufrufen, bevor Sie eine get-Factory-Methode aufrufen. So rufen Sie beispielsweise eine Instanz von MifareUltralight aus einem Tag ab:

    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:

  1. Fügen Sie den folgenden Code in die Methode onCreate() Ihrer Aktivität ein:
    1. 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);
    2. 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 den TAG_DISCOVERED-Intent zurückgreifen. Das folgende Code-Snippet verarbeitet alle MIME-Typen für NDEF_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, };
    3. 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() } };
  2. Ü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 in onResume() erfolgt. Außerdem musst du den Callback onNewIntent implementieren, 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
    }