Kaj vsebuje vCard
vCard je navadno besedilo, sestavljeno iz oznakam opremljenih vrstic, ki se začne z BEGIN:VCARD in konča z END:VCARD. Vsaka vrstica vsebuje eno lastnost, na primer oblikovano ime, telefonsko številko ali e-poštni naslov. Isto besedilo je v datoteki .vcf, ko se stiki izvozijo iz telefona ali e-poštnega programa.
Najkrajši vCard 3.0 za kodo QR izgleda takole, ena lastnost v vsaki vrstici: 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 vsebuje strukturirano ime (najprej priimek, ločeno s podpičji), FN pa ime, kot naj se prikaže.
- N: strukturirano ime (priimek;ime;srednje ime;predpona;pripona)
- FN: prikazno ime
- TEL: telefonska številka, po možnosti v mednarodni obliki
- EMAIL: e-poštni naslov
- ORG: podjetje ali organizacija
- TITLE: delovno mesto
- URL in ADR: spletna stran in poštni naslov
Katero različico uporabiti
Različica 3.0 je za kode QR še vedno najvarnejša izbira, ker jo bere skoraj vsak telefon. Določena je v RFC 2426 iz leta 1998. Različica 4.0, določena v RFC 6350 leta 2011, je trenutni standard in zahteva UTF-8, vendar jo nekateri starejši bralniki obravnavajo manj dosledno.
Različica 3.0 pričakuje N in FN, 4.0 pa zahteva samo FN. Ne glede na uporabljeno različico mora biti vrstica VERSION takoj za BEGIN:VCARD.
Velikost in kompromisi pri skeniranju
Vsako polje, dodano vCard, doda znake, več znakov pa pomeni gostejšo kodo QR z manjšimi moduli. Vizitka z imenom, eno telefonsko številko in enim e-poštnim naslovom se zlahka skenira tudi v velikosti poslovne vizitke. Dodajanje poštnega naslova, več številk, dolge opombe ali vdelane fotografije lahko kodo potisne na različico, ki jo je treba natisniti precej večjo.
Fotografije so običajna težava: slika, kodirana v base64, lahko obsega tisoče znakov in se redko prilega praktični kodi. Pogosta alternativa je, da kodirate kratko povezavo do gostovane datoteke .vcf ali strani s stikom, kar ohrani kodo majhno in omogoča poznejše spreminjanje podatkov.