Mit tartalmaz a vCard
A vCard címkézett sorokból álló egyszerű szöveg, amelyet a BEGIN:VCARD nyit és az END:VCARD zár. Minden sor egy tulajdonságot tartalmaz, például a formázott nevet, egy telefonszámot vagy egy e-mail-címet. Ugyanezt a szöveget tartalmazza a .vcf fájl is, amikor a névjegyeket telefonról vagy e-mail-programból exportálják.
Egy minimális vCard 3.0 QR-kódhoz így néz ki, soronként egy tulajdonsággal: 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. Az N a strukturált nevet tartalmazza (előbb a családnév, pontosvesszővel elválasztva), az FN pedig a megjelenítendő nevet.
- N: strukturált név (család;utó;középső;előtag;utótag)
- FN: megjelenített név
- TEL: telefonszám, lehetőleg nemzetközi formátumban
- EMAIL: e-mail-cím
- ORG: cég vagy szervezet
- TITLE: beosztás
- URL és ADR: weboldal és postacím
Melyik verziót használd
A 3.0-s verzió továbbra is a legbiztonságosabb választás a QR-kódokhoz, mert szinte minden telefon olvassa. Az 1998-as RFC 2426 határozza meg. A 4.0-s verzió, amelyet az RFC 6350 határoz meg 2011-ből, a jelenlegi szabvány, és UTF-8-at követel meg, de egyes régebbi olvasók következetlenebbül kezelik.
A 3.0-s verzió az N-t és az FN-t is elvárja, míg a 4.0 csak az FN-t követeli meg. Bármelyik verziót használod, a VERSION sornak közvetlenül a BEGIN:VCARD után kell állnia.
Méret és beolvashatóság közötti kompromisszum
A vCardhoz hozzáadott minden mező karaktereket ad, a több karakter pedig sűrűbb QR-kódot kisebb modulokkal jelent. A névvel, egy telefonszámmal és egy e-mail-címmel rendelkező kártya névjegykártya-méretben is könnyen beolvasható. Postacím, több szám, hosszú megjegyzés vagy beágyazott fénykép hozzáadása olyan verzióba tolhatja a kódot, amelyet sokkal nagyobbra kell nyomtatni.
A fényképek a szokásos gond: a base64-kódolt kép több ezer karakter lehet, és ritkán fér el egy praktikus kódban. Gyakori alternatíva, hogy egy tárolt .vcf fájlra vagy névjegyoldalra mutató rövid linket kódolnak, ami kicsi kódot ad, és lehetővé teszi az adatok későbbi módosítását.