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:
- 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. - 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);
- Uzyskaj instancję
TagTechnology, wywołując jedną z metod fabrycznychgetklas w pakiecieandroid.nfc.tech. Możesz wyliczyć obsługiwane technologie tagu, wywołując metodęgetTechList()przed wywołaniem metody fabrycznejget. Aby na przykład uzyskać instancjęMifareUltralightzTag, 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:
- Dodaj ten kod w metodzie
onCreate()aktywności:- 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);
- 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
nullfiltrów intencji i filtrów technologii oznacza, że chcesz filtrować wszystkie tagi, które korzystają z intencjiTAG_DISCOVEREDjako zastępczej. Poniższy fragment kodu obsługuje wszystkie typy MIME dlaNDEF_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, };
- 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() } };
- Utwórz zmienny obiekt
- 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 wonResume()to gwarantuje). Musisz też zaimplementować wywołanie zwrotneonNewIntent, 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 }