Omówienie zaawansowanych funkcji NFC

W tym dokumencie opisano zaawansowane zagadnienia dotyczące NFC, takie jak praca z różnymi technologiami tagów, zapisywanie tagów NFC i wysyłanie na pierwszym planie, co umożliwia aplikacji na pierwszym planie obsługę intencji, nawet gdy inne aplikacje filtrują te same intencje.

Obsługa obsługiwanych technologii tagów

Podczas pracy z tagami NFC i urządzeniami z Androidem głównym formatem używanym do odczytu i zapisu danych na tagach jest NDEF. Gdy urządzenie skanuje tag z danymi NDEF, Android pomaga w analizowaniu wiadomości i w miarę możliwości dostarcza ją w obiekcie NdefMessage. Zdarzają się jednak przypadki, gdy skanujesz tag, który nie zawiera danych NDEF, lub gdy danych NDEF nie można zmapować na typ MIME lub identyfikator URI. W takich przypadkach musisz nawiązać komunikację bezpośrednio z tagiem i odczytywać go oraz zapisywać za pomocą własnego protokołu (w nieprzetworzonych bajtach). Android zapewnia ogólną obsługę tych przypadków użycia za pomocą pakietu android.nfc.tech, który opisano w tabeli 1. Możesz użyć metody getTechList(), aby określić technologie obsługiwane przez tag, i utworzyć odpowiedni obiekt TagTechnology za pomocą jednej z klas udostępnianych przez android.nfc.tech.

Tabela 1. Obsługiwane technologie tagów

Klasa Opis
TagTechnology Interfejs, który muszą implementować wszystkie klasy technologii tagów.
NfcA Zapewnia dostęp do właściwości NFC-A (ISO 14443-3A) i operacji wejścia/wyjścia.
NfcB Zapewnia dostęp do właściwości NFC-B (ISO 14443-3B) i operacji wejścia/wyjścia.
NfcF Zapewnia dostęp do właściwości NFC-F (JIS 6319-4) i operacji wejścia/wyjścia.
NfcV Zapewnia dostęp do właściwości NFC-V (ISO 15693) i operacji wejścia/wyjścia.
IsoDep Zapewnia dostęp do właściwości ISO-DEP (ISO 14443-4) i operacji wejścia/wyjścia.
Ndef Zapewnia dostęp do danych NDEF i operacji na tagach NFC sformatowanych jako NDEF.
NdefFormatable Udostępnia operacje formatowania tagów, które mogą być sformatowane jako NDEF.

Urządzenia z Androidem nie muszą obsługiwać tych technologii tagów.

Tabela 2. Opcjonalne obsługiwane technologie tagów

Klasa Opis
MifareClassic Zapewnia dostęp do właściwości MIFARE Classic i operacji wejścia/wyjścia, jeśli urządzenie z Androidem obsługuje MIFARE.
MifareUltralight Zapewnia dostęp do właściwości MIFARE Ultralight i operacji wejścia/wyjścia, jeśli urządzenie z Androidem obsługuje MIFARE.

Praca z technologiami tagów i intencją ACTION_TECH_DISCOVERED

Gdy urządzenie skanuje tag, który zawiera dane NDEF, ale nie można go zmapować na MIME ani URI, system wysyłania tagów próbuje rozpocząć aktywność z intencją ACTION_TECH_DISCOVERED. ACTION_TECH_DISCOVERED jest też używana, gdy skanowany jest tag z danymi innymi niż NDEF. Dzięki temu możesz pracować bezpośrednio z danymi w tagu, jeśli system wysyłania tagów nie mógł ich przeanalizować. Podstawowe czynności związane z technologiami tagów:

  1. Filtruj pod kątem intencji ACTION_TECH_DISCOVERED, określając technologie tagów, które chcesz obsługiwać. Więcej informacji znajdziesz w artykule Filtrowanie intencji NFC. Ogólnie rzecz biorąc, system wysyłania tagów próbuje uruchomić intencję ACTION_TECH_DISCOVERED, gdy nie można zmapować wiadomości NDEF na typ MIME lub identyfikator URI albo gdy zeskanowany tag nie zawiera danych NDEF. Więcej informacji o tym, jak to jest określane, znajdziesz w artykule System wysyłania tagów.
  2. Gdy aplikacja otrzyma intencję, pobierz z niej obiekt Tag:

    Kotlin

    var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)

    Java

    Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
  3. Uzyskaj instancję TagTechnology, wywołując jedną z metod fabrycznych get klas w pakiecie android.nfc.tech. Możesz wyliczyć obsługiwane technologie tagu, wywołując metodę getTechList() przed wywołaniem metody fabrycznej get. Aby na przykład uzyskać instancję MifareUltralight z Tag, wykonaj te czynności:

    Kotlin

    MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG))

    Java

    MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG));

odczytywać i zapisywać tagi,

Odczytywanie i zapisywanie tagu NFC obejmuje uzyskanie tagu z intencji i otwarcie komunikacji z tagiem. Aby odczytywać i zapisywać dane w tagu, musisz zdefiniować własny stos protokołów. Pamiętaj jednak, że nadal możesz odczytywać i zapisywać dane NDEF, gdy pracujesz bezpośrednio z tagiem. To od Ciebie zależy, jak chcesz uporządkować te elementy. Poniższy przykład pokazuje, jak pracować z tagiem 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;
    }
}

Korzystanie z systemu wysyłania na pierwszym planie

System wysyłania na pierwszym planie umożliwia działaniu przechwycenie intencji i uzyskanie priorytetu nad innymi działaniami, które obsługują tę samą intencję. Korzystanie z tego systemu wymaga utworzenia kilku struktur danych, aby system Android mógł wysyłać do aplikacji odpowiednie intencje. Aby włączyć system wysyłania na pierwszym planie:

  1. Dodaj ten kod w metodzie onCreate() aktywności:
    1. Utwórz zmienny obiekt PendingIntent, aby system Android mógł go wypełnić szczegółami tagu po jego zeskanowaniu.

      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. Zadeklaruj filtry intencji, aby obsługiwać intencje, które chcesz przechwytywać. System wysyłania na pierwszym planie sprawdza określone filtry intencji z intencją otrzymaną, gdy urządzenie skanuje tag. Jeśli pasuje, aplikacja obsługuje intencję. Jeśli nie pasuje, system wysyłania na pierwszym planie powraca do systemu wysyłania intencji. Określenie tablicy null filtrów intencji i filtrów technologii oznacza, że chcesz filtrować wszystkie tagi, które korzystają z intencji TAG_DISCOVERED jako zastępczej. Poniższy fragment kodu obsługuje wszystkie typy MIME dla NDEF_DISCOVERED. Powinieneś obsługiwać tylko te, których potrzebujesz.

      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. Skonfiguruj tablicę technologii tagów, które ma obsługiwać Twoja aplikacja. Wywołaj metodę Object.class.getName(), aby uzyskać klasę technologii, którą chcesz obsługiwać.

      Kotlin

      techListsArray = arrayOf(arrayOf<String>(NfcF::class.java.name))

      Java

      techListsArray = new String[][] { new String[] { NfcF.class.getName() } };
  2. Zastąp te wywołania zwrotne cyklu życia działania i dodaj logikę, aby włączać i wyłączać wysyłanie na pierwszym planie, gdy działanie traci (onPause()) i odzyskuje (onResume()) zaznaczenie. Metodę enableForegroundDispatch() należy wywoływać z głównego wątku i tylko wtedy, gdy aktywność jest na pierwszym planie (wywołanie w onResume() to gwarantuje). Musisz też zaimplementować wywołanie zwrotne onNewIntent, aby przetworzyć dane ze zeskanowanego tagu NFC.

    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
    }