Voltar aos guias

NDEF explicado: o formato universal que permite a qualquer celular ler sua tag

NDEF é o formato de camada de aplicação padrão do NFC Forum, o "envelope" que toda tag NFC de consumo usa para que qualquer celular compatível leia os mesmos bytes do mesmo jeito. Veja como mensagens, registros e valores TNF se encaixam.

Publicado

O que é NDEF: a resposta em um parágrafo

NDEF é o NFC Data Exchange Format, definido pelo NFC Forum como o contêiner universal de camada de aplicação para tags NFC. Ele fica sobre todos os tipos de tag do NFC Forum (NTAG, MIFARE Ultralight, FeliCa, ICODE), então a mesma mensagem codificada é lida de forma idêntica no iPhone, no Android e em um leitor dedicado. Já gravou uma URL em uma tag e viu ela abrir nas duas plataformas sem nenhum trabalho extra? Isso é o NDEF fazendo o trabalho dele. A camada de rádio resolve a conversa; o NDEF dá forma aos bytes. Para o lado do rádio, veja como o NFC realmente funciona; para o contexto mais amplo, NFC vs RFID e Bluetooth.

Como uma mensagem NDEF é organizada

Uma mensagem NDEF é formada por um ou mais registros concatenados. Segundo a especificação do NFC Forum e a referência Android NdefMessage, o primeiro registro carrega um flag Message Begin (MB) e o último carrega um flag Message End (ME). A maioria das tags de consumo guarda uma mensagem de um único registro, mas você pode agrupar vários quando necessário.

O cabeçalho de cada registro traz um TNF (Type Name Format, 3 bits), flags de controle (MB, ME, CF, SR, IL), campos de tamanho do tipo e do payload, uma string curta de tipo, um ID opcional e o próprio payload.

A cola do TNF:

TNFSignificado
0x00Registro vazio
0x01Tipo well-known do NFC Forum: U, T, Sp, Sig
0x02Tipo de mídia MIME, conforme a RFC 2046
0x03URI absoluta, conforme a RFC 3986
0x04Tipo externo do NFC Forum, por exemplo android.com:pkg
0x05Desconhecido
0x06Inalterado (registros fragmentados)

Em teoria, o payload de um registro pode chegar a 2^32 − 1 octetos. Na prática, o chip limita você muito antes disso: uma NTAG213 vem com 144 bytes de memória para o usuário.

Os tipos de registro que você vai encontrar de verdade

Alguns tipos well-known fazem quase todo o trabalho.

O registro URI (TNF 0x01, tipo U) é de longe o mais comum. Sua Record Type Definition usa um identificador de prefixo de um byte para abreviar o esquema: 0x04 para https://, 0x05 para tel:, 0x06 para mailto:. Assim, o esquema não é armazenado como texto literal. Codificar https://nfcore.app custa um byte de prefixo mais onze para nfcore.app: doze bytes em vez de dezenove. Em uma tag de 144 bytes, isso faz diferença.

O registro Text (tipo T) carrega UTF-8 mais um cabeçalho curto com o código do idioma. O Smart Poster (tipo Sp) é, ele próprio, um único registro NDEF cujo payload é uma mensagem NDEF aninhada: um sub-registro URI mais sub-registros opcionais de Título (Text), Ícone (imagem MIME), Ação e Tamanho. O Smart Poster RTD é o formato por trás das tags de "encoste para abrir o cardápio"; leitores que não o entendem usam como alternativa a URI interna. Os registros MIME (TNF 0x02) carregam payloads tipados, como image/png ou application/vnd.bluetooth.ep.oob para handover de Bluetooth. Os registros de tipo externo (TNF 0x04) direcionam para o app de um fornecedor específico.

Como o celular decide o que fazer com a aproximação

As duas plataformas olham o tipo do primeiro registro para escolher um tratador. No Android, o framework NFC dispara uma intent ACTION_NDEF_DISCOVERED e a compara com os filtros de intent registrados; tags sem NDEF disparam ACTION_TAG_DISCOVERED. No iPhone XS e mais recentes, o Background Tag Reading interpreta o NDEF automaticamente e envia um registro de URL para o navegador padrão ou para o app que registrou um Associated Domain para aquele host. Dica prática: coloque primeiro o registro mais específico. Se você combina um registro URI com um registro Text para que uma pessoa veja o destino, a URI precisa vir primeiro, ou o sistema não vai direcionar a aproximação automaticamente.

O que o NFCore mostra para você

O fluxo Write Data do NFCore permite criar registros NDEF de URL, Text, vCard, Wi-Fi e personalizados sem encostar em hexadecimal. Depois da gravação, a visualização Memory Dump mostra os bytes (índice do byte, hex, ASCII), para você conferir se a compressão do prefixo e a estrutura dos registros correspondem ao esperado. O Command Console expõe leituras brutas de páginas quando você quer olhar o próprio wrapper TLV do NDEF: o byte de tamanho 0x03 que abre uma mensagem NDEF e o terminador 0xFE.

Perguntas frequentes

O NDEF é igual no iPhone e no Android?

Sim. O NDEF é definido pelo NFC Forum, e a mesma mensagem codificada é lida de forma idêntica no Core NFC do iOS e no android.nfc do Android. As diferenças estão no que cada sistema faz com o resultado interpretado, não em como os bytes são interpretados.

Qual é a diferença entre um registro NDEF e uma mensagem NDEF?

A mensagem é o contêiner; os registros são os itens dentro dela. Uma mensagem NDEF é um ou mais registros concatenados, com o primeiro carregando um flag Message Begin e o último carregando um flag Message End.

Por que meu registro de URL ocupa menos bytes do que eu esperava?

O registro URI usa um identificador de prefixo de um byte: 0x04 para https://, 0x05 para tel:, 0x06 para mailto:. Assim, o esquema não é armazenado como texto literal. Em uma NTAG213 de 144 bytes, isso economiza vários bytes por registro.

Eu preciso mesmo de NDEF?

Se o seu leitor é um app próprio conversando com uma tag sua, não. Mas todo celular de consumo e todo tratador padrão do sistema espera NDEF. Use-o, a menos que você tenha um motivo específico para não usar.

Concluindo

Quando você entende o modelo de mensagem e registros, o resto do ecossistema NFC se encaixa com naturalidade. A capacidade da NTAG diz quais registros cabem; criar um Smart Poster vira "um sub-registro URI mais metadados opcionais". O NDEF transforma a memória da tag em algo que qualquer celular consegue direcionar, e, quando você vê os bytes no Memory Dump do NFCore, o formato deixa de parecer mágica.