Čo vCard obsahuje
vCard je obyčajný text zložený z označených riadkov, otvorený riadkom BEGIN:VCARD a ukončený riadkom END:VCARD. Každý riadok obsahuje jednu vlastnosť, napríklad formátované meno, telefónne číslo alebo e-mailovú adresu. Rovnaký text obsahuje aj súbor .vcf pri exporte kontaktov z telefónu alebo e-mailového programu.
Minimálna vCard 3.0 pre QR kód vyzerá takto, jedna vlastnosť na riadok: 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 obsahuje štruktúrované meno (najprv priezvisko, oddelené bodkočiarkami) a FN meno v podobe, v akej sa má zobraziť.
- N: štruktúrované meno (priezvisko;krstné meno;druhé meno;predpona;prípona)
- FN: zobrazované meno
- TEL: telefónne číslo, ideálne v medzinárodnom formáte
- EMAIL: e-mailová adresa
- ORG: firma alebo organizácia
- TITLE: pracovná pozícia
- URL a ADR: webová stránka a poštová adresa
Ktorú verziu použiť
Verzia 3.0 je pre QR kódy stále najbezpečnejšia voľba, pretože ju číta takmer každý telefón. Je definovaná v RFC 2426 z roku 1998. Verzia 4.0, definovaná v RFC 6350 v roku 2011, je aktuálny štandard a vyžaduje UTF-8, no niektoré staršie čítačky s ňou zaobchádzajú menej konzistentne.
Verzia 3.0 očakáva N aj FN, zatiaľ čo 4.0 vyžaduje iba FN. Bez ohľadu na verziu by riadok VERSION mal nasledovať hneď po BEGIN:VCARD.
Veľkosť a kompromisy pri skenovaní
Každé pole pridané do vCard pridáva znaky a viac znakov znamená hustejší QR kód s menšími modulmi. Karta s menom, jedným telefónnym číslom a jedným e-mailom sa dá ľahko naskenovať aj vo veľkosti vizitky. Pridanie poštovej adresy, viacerých čísel, dlhej poznámky alebo vloženej fotografie môže kód posunúť do verzie, ktorú treba vytlačiť podstatne väčšiu.
Fotografie sú obvyklý problém: obrázok zakódovaný v base64 môže mať tisíce znakov a do praktického kódu sa zriedka zmestí. Častou alternatívou je zakódovať krátky odkaz na hostovaný súbor .vcf alebo stránku kontaktu, vďaka čomu kód zostane malý a údaje sa dajú neskôr zmeniť.
