Este documento descreve tópicos avançados de NFC, como trabalhar com várias tecnologias de tags, gravar em tags NFC e envio em primeiro plano, que permite que um aplicativo em primeiro plano processe intents mesmo quando outros aplicativos filtram as mesmas intents.
Trabalhar com tecnologias de etiqueta compatíveis
Ao trabalhar com tags NFC e dispositivos Android, o principal formato usado para ler
e gravar dados em tags é o NDEF. Quando um dispositivo faz a leitura de uma tag com dados NDEF, o Android oferece suporte
para analisar a mensagem e entregá-la em uma NdefMessage quando
possível. No entanto, há casos em que você lê uma tag que não contém dados NDEF ou em que os dados NDEF não podem ser mapeados para um tipo MIME ou URI.
Nesses casos, é preciso abrir a comunicação diretamente com a tag e ler e gravar nela com
seu próprio protocolo (em bytes brutos). O Android oferece suporte genérico para esses casos de uso com o pacote android.nfc.tech, descrito na Tabela 1. Use o método getTechList() para determinar as tecnologias compatíveis com a tag e crie o objeto TagTechnology correspondente com uma das classes fornecidas por android.nfc.tech.
Tabela 1. Tecnologias de etiqueta compatíveis
| Turma | Descrição |
|---|---|
TagTechnology |
A interface que todas as classes de tecnologia de etiquetas precisam implementar. |
NfcA |
Fornece acesso às propriedades NFC-A (ISO 14443-3A) e operações de E/S. |
NfcB |
Fornece acesso às propriedades NFC-B (ISO 14443-3B) e operações de E/S. |
NfcF |
Fornece acesso às propriedades da NFC-F (JIS 6319-4) e operações de E/S. |
NfcV |
Fornece acesso às propriedades NFC-V (ISO 15693) e operações de E/S. |
IsoDep |
Fornece acesso às propriedades ISO-DEP (ISO 14443-4) e operações de E/S. |
Ndef |
Fornece acesso a dados e operações NDEF em tags NFC que foram formatadas como NDEF. |
NdefFormatable |
Fornece operações de formato para etiquetas que podem ser formatadas como NDEF. |
Não é obrigatório que os dispositivos com tecnologia Android sejam compatíveis com as seguintes tecnologias de tag.
Tabela 2. Tecnologias de etiqueta compatíveis opcionais
| Turma | Descrição |
|---|---|
MifareClassic |
Fornece acesso às propriedades e operações de E/S do MIFARE Classic, se o dispositivo Android for compatível com o MIFARE. |
MifareUltralight |
Fornece acesso às propriedades e operações de E/S do MIFARE Ultralight, se o dispositivo Android for compatível com o MIFARE. |
Trabalhando com tecnologias de etiqueta e com o intent ACTION_TECH_DISCOVERED
Quando um dispositivo faz a leitura de uma tag que tem dados NDEF, mas não pode ser mapeada para um MIME ou URI,
o sistema de expedição de tags tenta iniciar uma atividade com o intent
ACTION_TECH_DISCOVERED. A ACTION_TECH_DISCOVERED também é usada quando uma tag
com dados não NDEF é lida. Com esse substituto, você pode trabalhar diretamente com os dados na tag
se o sistema de envio de tags não conseguir analisá-los. As etapas básicas para trabalhar com
tecnologias de tag são as seguintes:
- Filtre uma intent
ACTION_TECH_DISCOVEREDespecificando as tecnologias de tag que você quer processar. Consulte Como filtrar intents de NFC para mais informações. Em geral, o sistema de envio de tags tenta iniciar uma intentACTION_TECH_DISCOVEREDquando uma mensagem NDEF não pode ser mapeada para um tipo MIME ou URI ou se a tag lida não contém dados NDEF. Para mais informações sobre como isso é determinado, consulte O sistema de envio de tags. - Quando o aplicativo receber a intent, extraia o objeto
Tagdela:Kotlin
var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
Java
Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
- Chame um dos métodos de fábrica
getdas classes no pacoteandroid.nfc.techpara receber uma instância de umTagTechnology. É possível enumerar as tecnologias compatíveis com a tag chamandogetTechList()antes de chamar um método de fábricaget. Por exemplo, para receber uma instância deMifareUltralightde umTag, faça o seguinte:Kotlin
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG))
Java
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG));
Ler e gravar em etiquetas
Ler e gravar em uma tag NFC envolve obter a etiqueta do intent e abrir a comunicação com a etiqueta. É necessário definir sua própria pilha de protocolos para ler e gravar dados na tag. No entanto, ainda é possível ler e gravar dados NDEF ao trabalhar diretamente com uma tag. Cabe a você decidir como quer estruturar as coisas. O exemplo a seguir mostra como trabalhar com uma tag 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; } }
Usar o sistema de expedição em primeiro plano
O sistema de envio em primeiro plano permite que uma atividade intercepte uma intent e reivindique prioridade sobre outras atividades que processam a mesma intent. O uso desse sistema envolve a criação de algumas estruturas de dados para que o sistema Android possa enviar as intents adequadas ao seu aplicativo. Para ativar o sistema de expedição em primeiro plano:
- Adicione o código abaixo ao método
onCreate()da sua atividade:- Crie um objeto
PendingIntentmutável para que o sistema Android possa preenchê-lo com os detalhes da tag quando ela for lida.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);
- Declare os filtros de intent para processar os intents que você quer interceptar. O sistema de despacho em primeiro plano verifica os filtros de intent especificados com a intent recebida quando o dispositivo lê uma tag. Se corresponderem, o aplicativo processará o intent. Se não houver
correspondência, o sistema de envio em primeiro plano vai voltar para o sistema de envio de intents.
Especificar uma matriz
nullde filtros de intent e de tecnologia indica que você quer filtrar todas as tags que usam a intentTAG_DISCOVEREDcomo substituta. O snippet de código abaixo processa todos os tipos MIME paraNDEF_DISCOVERED. Você só deve processar os que forem necessários.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, };
- Configurar uma matriz de tecnologias de etiqueta que o aplicativo quer processar. Chame o
método
Object.class.getName()para receber a classe da tecnologia que você quer usar.Kotlin
techListsArray = arrayOf(arrayOf<String>(NfcF::class.java.name))
Java
techListsArray = new String[][] { new String[] { NfcF.class.getName() } };
- Crie um objeto
- Substitua os seguintes callbacks do ciclo de vida da atividade e adicione lógica para ativar e desativar a
distribuição em primeiro plano quando a atividade perder (
onPause()) e recuperar (onResume()) o foco. OenableForegroundDispatch()precisa ser chamado na linha de execução principal e somente quando a atividade estiver em primeiro plano (chamar emonResume()garante isso). Também é necessário implementar o callbackonNewIntentpara processar os dados da tag NFC lida.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 }