Ce que contient une vCard
Une vCard est du texte brut fait de lignes étiquetées, ouvert par BEGIN:VCARD et fermé par END:VCARD. Chaque ligne contient une propriété, comme le nom formaté, un numéro de téléphone ou une adresse e-mail. C’est le même texte que contient un fichier .vcf lorsque des contacts sont exportés depuis un téléphone ou un logiciel de messagerie.
Une vCard 3.0 minimale pour un QR code ressemble à ceci, une propriété par ligne : BEGIN:VCARD, VERSION:3.0, N:Lee;Jordan, FN:Jordan Lee, ORG:Maple Street Bakery, TEL:+15035550123, EMAIL:jordan@example.com, URL:https://example.com, END:VCARD. N contient le nom structuré (nom de famille d’abord, séparé par des points-virgules) et FN le nom tel qu’il doit être affiché.
- N : nom structuré (famille;prénom;deuxième prénom;préfixe;suffixe)
- FN : nom d’affichage
- TEL : numéro de téléphone, idéalement au format international
- EMAIL : adresse e-mail
- ORG : entreprise ou organisation
- TITLE : intitulé de poste
- URL et ADR : site web et adresse postale
Quelle version utiliser
La version 3.0 reste le choix le plus sûr pour les QR codes, car presque tous les téléphones la lisent. Elle est définie dans la RFC 2426 de 1998. La version 4.0, définie dans la RFC 6350 en 2011, est la norme actuelle et exige l’UTF-8, mais certains lecteurs plus anciens la gèrent moins bien.
La version 3.0 attend à la fois N et FN, alors que la 4.0 n’exige que FN. Quelle que soit la version utilisée, la ligne VERSION doit venir juste après BEGIN:VCARD.
Compromis entre taille et scan
Chaque champ ajouté à une vCard ajoute des caractères, et plus de caractères signifie un QR code plus dense avec des modules plus petits. Une carte avec un nom, un numéro de téléphone et un e-mail se scanne facilement même à la taille d’une carte de visite. Ajouter une adresse postale, plusieurs numéros, une longue note ou une photo intégrée peut pousser le code vers une version qui doit être imprimée bien plus grande.
Les photos sont le problème habituel : une image encodée en base64 peut atteindre des milliers de caractères et tient rarement dans un code pratique. Une alternative courante consiste à encoder un lien court vers un fichier .vcf hébergé ou une page de contact, ce qui garde le code petit et permet de modifier les coordonnées plus tard.