Retour aux guides

Enregistrements NDEF personnalisés : au-delà de l'URL et du texte

L'URL et le texte ne sont que deux des types d'enregistrements pris en charge par NDEF. Les enregistrements personnalisés (MIME et External Type) servent à créer les Smart Posters, les tags d'appairage Bluetooth et les données propres à une application. Voici comment cela fonctionne, et comment en écrire un avec NFCore.

Publié

De quoi s'agit-il (la réponse en un paragraphe)

Un enregistrement NDEF personnalisé est un enregistrement NFC qui ne passe pas par les types « well-known » du NFC Forum : ni URL simple, ni enregistrement Text. Il s'appuie à la place sur l'un des deux mécanismes en libre-service : un enregistrement MIME (identifié par une chaîne MIME standard ou inventée) ou un enregistrement External Type (identifié par un domaine que vous contrôlez, comme com.yourapp:sensor-reading). Si vous avez déjà écrit un enregistrement URL ou Wi-Fi avec NFCore, vous avez déjà utilisé le côté « well-known » de NDEF. Les enregistrements personnalisés en sont l'autre moitié : c'est le mécanisme derrière les Smart Posters, les tags d'appairage Bluetooth et toutes les données propres à une application qu'un tag doit transporter.

Comment cela fonctionne concrètement

Chaque enregistrement NDEF commence par un octet d'en-tête appelé Type Name Format (TNF). Il indique au lecteur à quel espace de noms appartient la chaîne de type de l'enregistrement. Pour un enregistrement personnalisé, vous choisissez l'une de ces deux valeurs de TNF :

  • TNF_MIME_MEDIA : le type est une chaîne MIME, soit standard (comme text/vcard), soit inventée pour votre propre application.
  • TNF_EXTERNAL_TYPE : le type est une chaîne en domaine inversé, comme com.yourapp:config, que seul vous êtes censé utiliser.

La classe NdefRecord d'Android fournit les méthodes statiques createMime() et createExternal(), de sorte que vous n'assemblez jamais les octets d'en-tête à la main : il suffit de fournir la chaîne MIME ou la chaîne domaine:type, ainsi qu'une charge utile en octets. Core NFC sur iOS fait le même travail avec l'énumération NFCTypeNameFormat : .media pour les enregistrements MIME et .nfcExternal pour les enregistrements External Type. Écrivez un enregistrement avec TNF_EXTERNAL_TYPE sur Android, relisez-le sur iOS avec .nfcExternal, et il passe sans problème d'une plateforme à l'autre, à condition que les deux côtés s'accordent sur la chaîne domaine:type exacte. Cet accord est tout le contrat. Pas de registre, pas d'étape d'approbation.

Où en croise-t-on

L'exemple le plus courant est le type d'enregistrement Smart Poster, qui n'est pas vraiment un enregistrement personnalisé, mais une petite composition d'enregistrements well-known (un enregistrement URI plus des enregistrements Text et Action) indiquant au lecteur s'il doit ouvrir un lien, l'enregistrer ou agir en arrière-plan. Les enregistrements personnalisés à proprement parler apparaissent quand un produit a besoin de données structurées qu'un type well-known ne peut pas exprimer. Le tag d'appairage par simple contact d'une enceinte Bluetooth, par exemple, stocke un enregistrement MIME avec un type documenté comme application/vnd.bluetooth.ep.oob, de sorte qu'un seul contact lance l'appairage au lieu d'un détour par les réglages Bluetooth. C'est le même mécanisme de transfert statique que le NFC Forum a défini pour les tags passifs : sans alimentation, sans négociation, juste un enregistrement que n'importe quel lecteur peut récupérer au contact. C'est un proche cousin de la manière dont Apple Pay et Google Pay utilisent le NFC : une charge utile personnalisée très strictement spécifiée, transportée sur le même lien NFC qui peut aussi porter un simple enregistrement Text.

Conseils, pièges et mini-tutoriel avec NFCore

Choisissez pour l'External Type un domaine que vous contrôlez réellement, comme le nom de package de votre application ou un domaine qui vous appartient, plutôt qu'un nom générique qu'un autre développeur pourrait aussi choisir. Et n'oubliez pas : les octets bruts d'un tag non chiffré, enregistrement personnalisé compris, sont lisibles par n'importe qui avec un téléphone compatible. Jetez un œil à ce qui est réellement en jeu quand un tag est lisible par tous avant d'y mettre quoi que ce soit de sensible.

Envie d'essayer ? Ouvrez le mode d'écriture brute de NFCore, choisissez un enregistrement personnalisé, saisissez une chaîne domaine:type que vous contrôlez (par exemple com.yourname:note), puis écrivez une courte charge utile de texte. Relisez aussitôt le tag pour vérifier que la chaîne de type et la charge utile correspondent à ce que vous avez écrit. Ce contrôle aller-retour est le moyen le plus rapide de repérer une faute de frappe dans la chaîne domaine:type avant qu'elle ne se retrouve sur dix tags au lieu d'un seul. Vous pouvez télécharger NFCore pour iOS ou Android sur nfcore.app si vous voulez tester avec vos propres tags.

Foire aux questions

Quelle est la différence entre un enregistrement MIME et un enregistrement External Type ?

Le type d'un enregistrement MIME est une chaîne MIME standard (comme application/vnd.bluetooth.ep.oob), si bien que toute application qui gère déjà ce type MIME ailleurs peut le prendre en charge. Le type d'un enregistrement External Type est une chaîne en domaine inversé que vous inventez vous-même (comme com.yourapp:config), ce qui garantit qu'elle n'entrera pas en collision avec le type d'enregistrement de quelqu'un d'autre.

Puis-je lire sur iOS un enregistrement NDEF personnalisé écrit par une application Android, ou l'inverse ?

Oui : TNF_EXTERNAL_TYPE sur Android et .nfcExternal dans Core NFC sur iOS décrivent le même format sur le support. Tant que les deux applications s'accordent sur la chaîne domaine:type exacte, l'enregistrement est lu correctement d'une plateforme à l'autre.

Ai-je besoin de l'approbation du NFC Forum pour inventer mon propre type d'enregistrement ?

Non. Les enregistrements External Type et MIME fonctionnent tous deux en libre-service : vous ne les déclarez pas auprès du NFC Forum. C'est tout l'intérêt de la convention de préfixe de domaine : utilisez un domaine ou un nom de package qui vous appartient, et aucun registre ni aucune approbation n'est nécessaire.

Conclusion

Les enregistrements NDEF personnalisés ne sont pas un format avancé et verrouillé : c'est le même mécanisme MIME ou External Type sur lequel reposent déjà tous les tags d'appairage Bluetooth et toutes les fonctions NFC propres à une application, et rien ne vous empêche d'en écrire un. Une fois à l'aise pour construire un enregistrement personnalisé, en empiler plusieurs, comme le Smart Poster qui combine des enregistrements URI, Text et Action, revient à répéter la même brique de base.