Voltar aos guias

Registros NDEF personalizados: além de URL e texto

URL e texto são só dois dos tipos de registro que o NDEF suporta. Os registros personalizados (MIME e External Type) são a base de Smart Posters, tags de pareamento Bluetooth e dados específicos de apps. Veja como funcionam e como criar um com o NFCore.

Publicado

O que é (resposta em um parágrafo)

Um registro NDEF personalizado é qualquer registro NFC que não usa os tipos "well-known" do NFC Forum: nada de URL simples, nada de registro de texto. Em vez disso, ele usa um de dois mecanismos de autoatendimento: um registro MIME (identificado por uma string MIME padrão ou inventada) ou um registro External Type (identificado por um domínio que você controla, como com.yourapp:sensor-reading). Se você já gravou um registro de URL ou de Wi-Fi com o NFCore, já usou o lado well-known do NDEF. Os registros personalizados são a outra metade: o mecanismo por trás de Smart Posters, tags de pareamento Bluetooth e de qualquer dado específico de app que uma tag precise carregar.

Como funciona na prática

Todo registro NDEF começa com um byte de cabeçalho chamado Type Name Format (TNF). Ele informa ao leitor a qual namespace pertence a string de tipo do registro. Para um registro personalizado, você escolhe um de dois valores de TNF:

  • TNF_MIME_MEDIA: o tipo é uma string MIME, seja uma padrão (como text/vcard) ou uma que você inventa para o seu próprio app.
  • TNF_EXTERNAL_TYPE: o tipo é uma string de domínio reverso, como com.yourapp:config, que só você deve usar.

A classe NdefRecord do Android oferece os métodos estáticos createMime() e createExternal(), então você nunca monta os bytes do cabeçalho manualmente: basta informar a string MIME ou a string domínio:tipo, mais um payload em bytes. O Core NFC do iOS faz o mesmo trabalho com o enum NFCTypeNameFormat: .media para registros MIME e .nfcExternal para registros External Type. Grave um registro com TNF_EXTERNAL_TYPE no Android, leia no iOS com .nfcExternal e ele funciona normalmente nos dois sentidos, desde que os dois lados concordem com a string domínio:tipo exata. Esse acordo é todo o contrato. Não existe registro oficial nem etapa de aprovação.

Onde você vai encontrar

O exemplo mais comum é o tipo de registro Smart Poster, que na verdade não é um único registro personalizado, mas uma pequena composição de registros well-known (um registro URI mais registros de texto e de ação) que diz ao leitor se deve abrir um link, salvá-lo ou executá-lo em segundo plano. Os registros personalizados propriamente ditos aparecem quando um produto precisa de dados estruturados que um tipo well-known simplesmente não consegue expressar. A tag de pareamento por aproximação de uma caixa de som Bluetooth, por exemplo, guarda um registro MIME com um tipo documentado como application/vnd.bluetooth.ep.oob, de modo que um único toque inicia o pareamento, sem precisar passar pelo menu de configurações do Bluetooth. Esse é o mesmo mecanismo de static handover que o NFC Forum definiu para tags passivas: sem energia, sem negociação, só um registro que qualquer leitor consegue ler ao encostar. É um parente próximo de como o Apple Pay e o Google Pay usam NFC: um payload personalizado rigidamente especificado, trafegando no mesmo link NFC que também pode carregar um simples registro de texto.

Dicas, armadilhas e um passo a passo rápido com o NFCore

Escolha um domínio External Type que você realmente controle (o nome de pacote do seu app ou um domínio seu), em vez de chutar algo genérico que outro desenvolvedor também possa acabar usando. E lembre-se: os bytes brutos de uma tag sem criptografia, incluindo o registro personalizado, podem ser lidos por qualquer pessoa com um celular compatível. Vale conferir o que realmente está em risco quando uma tag pode ser lida por qualquer um antes de gravar algo sensível.

Quer testar? Abra o modo de gravação bruta do NFCore, escolha um registro personalizado, informe uma string domínio:tipo que você controle (por exemplo, com.yourname:note) e grave um pequeno payload de texto. Leia a tag logo em seguida para confirmar que a string de tipo e o payload batem com o que você gravou. Essa verificação de ida e volta é a forma mais rápida de pegar um erro de digitação na string domínio:tipo antes que ele vá parar em dez tags em vez de uma. Você pode baixar o NFCore para iOS ou Android em nfcore.app para testar com as suas próprias tags.

Perguntas frequentes

Qual é a diferença entre um registro MIME e um registro External Type?

O tipo de um registro MIME é uma string MIME padrão (como application/vnd.bluetooth.ep.oob), então qualquer app que já trate esse tipo MIME em outros contextos pode reivindicá-lo. O tipo de um registro External Type é uma string de domínio reverso que você mesmo inventa (como com.yourapp:config), o que garante que ele não vai colidir com o tipo de registro de mais ninguém.

Posso ler no iOS um registro NDEF personalizado gravado por um app Android, ou vice-versa?

Sim: TNF_EXTERNAL_TYPE no Android e .nfcExternal no Core NFC do iOS descrevem o mesmo formato transmitido. Desde que os dois apps concordem com a string domínio:tipo exata, o registro funciona corretamente entre as plataformas.

Preciso de aprovação do NFC Forum para inventar meu próprio tipo de registro?

Não. Registros External Type e MIME são de autoatendimento: você não os registra no NFC Forum. Esse é todo o objetivo da convenção de prefixo de domínio: use um domínio ou nome de pacote que seja seu, e nenhum registro ou etapa de aprovação é necessário.

Conclusão

Os registros NDEF personalizados não são um formato avançado e restrito. São o mesmo mecanismo MIME ou External Type em que toda tag de pareamento Bluetooth e todo recurso NFC específico de app já se baseiam, sem nada que impeça você de criar um. Quando você já estiver à vontade para montar um único registro personalizado, combinar vários (como o Smart Poster faz com um registro URI, um de texto e um de ação) é só o mesmo bloco de construção, repetido.