Mida vCard sisaldab
vCard on lihttekst, mis koosneb märgendatud ridadest, avatud BEGIN:VCARD ja suletud END:VCARD abil. Iga rida sisaldab ühte omadust, näiteks vormindatud nime, telefoninumbrit või e-posti aadressi. Sama tekst on ka .vcf-failis, kui kontakte telefonist või e-posti programmist eksporditakse.
Minimaalne QR-koodi jaoks mõeldud vCard 3.0 näeb välja selline, üks omadus rea kohta: 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 sisaldab struktureeritud nime (perekonnanimi esimesena, eraldatud semikoolonitega) ja FN nime sellisena, nagu seda tuleb kuvada.
- N: struktureeritud nimi (perekonnanimi;eesnimi;teine nimi;eesliide;järelliide)
- FN: kuvatav nimi
- TEL: telefoninumber, soovitavalt rahvusvahelisel kujul
- EMAIL: e-posti aadress
- ORG: ettevõte või organisatsioon
- TITLE: ametinimetus
- URL ja ADR: veebisait ja postiaadress
Millist versiooni kasutada
Versioon 3.0 on QR-koodide jaoks endiselt kindlaim valik, sest seda loeb peaaegu iga telefon. See on määratletud 1998. aasta standardis RFC 2426. Versioon 4.0, mis on määratletud 2011. aasta standardis RFC 6350, on kehtiv standard ja nõuab UTF-8, kuid mõned vanemad lugejad käsitlevad seda ebaühtlasemalt.
Versioon 3.0 eeldab nii N-i kui ka FN-i, versioon 4.0 nõuab ainult FN-i. Olenemata kasutatavast versioonist peaks rida VERSION tulema kohe pärast rida BEGIN:VCARD.
Suuruse ja skannimise kompromissid
Iga vCardile lisatud väli lisab märke ja rohkem märke tähendab tihedamat QR-koodi väiksemate moodulitega. Nime, ühe telefoninumbri ja ühe e-posti aadressiga kaart skannib kergesti isegi visiitkaardi suuruses. Postiaadressi, mitme numbri, pika märkuse või manustatud foto lisamine võib viia koodi versioonini, mida tuleb printida palju suuremana.
Fotod on tavaline probleem: base64-kodeeritud pilt võib ulatuda tuhandete märkideni ja mahub praktilisse koodi harva. Levinud alternatiiv on kodeerida lühike link majutatud .vcf-failile või kontaktilehele, mis hoiab koodi väikesena ja laseb andmeid hiljem muuta.