Che cosa contiene una vCard
Una vCard è testo semplice fatto di righe con etichetta, aperto da BEGIN:VCARD e chiuso da END:VCARD. Ogni riga contiene una proprietà, come il nome formattato, un numero di telefono o un indirizzo email. Lo stesso testo è ciò che contiene un file .vcf quando i contatti vengono esportati da un telefono o da un programma di posta.
Una vCard 3.0 minima per un codice QR ha questo aspetto, una proprietà per riga: 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 contiene il nome strutturato (prima il cognome, separato da punti e virgola) e FN il nome come deve essere visualizzato.
- N: nome strutturato (cognome;nome;secondo nome;prefisso;suffisso)
- FN: nome visualizzato
- TEL: numero di telefono, meglio in formato internazionale
- EMAIL: indirizzo email
- ORG: azienda o organizzazione
- TITLE: qualifica professionale
- URL e ADR: sito web e indirizzo postale
Quale versione usare
La versione 3.0 è ancora la scelta più sicura per i codici QR perché quasi ogni telefono la legge. È definita nella RFC 2426 del 1998. La versione 4.0, definita nella RFC 6350 del 2011, è lo standard attuale e richiede UTF-8, ma alcuni lettori più vecchi la gestiscono in modo meno coerente.
La versione 3.0 si aspetta sia N sia FN, mentre la 4.0 richiede solo FN. Qualunque versione si usi, la riga VERSION dovrebbe venire subito dopo BEGIN:VCARD.
Compromessi tra dimensione e scansione
Ogni campo aggiunto a una vCard aggiunge caratteri, e più caratteri significano un codice QR più fitto con moduli più piccoli. Una scheda con un nome, un numero di telefono e un'email si scansiona facilmente anche alla dimensione di un biglietto da visita. Aggiungere un indirizzo postale, più numeri, una nota lunga o una foto incorporata può portare il codice a una versione che va stampata molto più grande.
Le foto sono il problema tipico: un'immagine codificata in base64 può arrivare a migliaia di caratteri e raramente sta in un codice pratico. Un'alternativa comune è codificare un link breve a un file .vcf ospitato o a una pagina di contatto, che tiene piccolo il codice e permette di cambiare i dati in seguito.