Vad ett vCard innehåller
Ett vCard är vanlig text bestående av märkta rader, inledd med BEGIN:VCARD och avslutad med END:VCARD. Varje rad innehåller en egenskap, till exempel det formaterade namnet, ett telefonnummer eller en e-postadress. Samma text finns i en .vcf-fil när kontakter exporteras från en telefon eller ett e-postprogram.
Ett minimalt vCard 3.0 för en QR-kod ser ut så här, en egenskap per rad: 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 innehåller det strukturerade namnet (efternamn först, åtskilt med semikolon) och FN namnet så som det ska visas.
- N: strukturerat namn (efternamn;förnamn;mellannamn;prefix;suffix)
- FN: visningsnamn
- TEL: telefonnummer, helst i internationellt format
- EMAIL: e-postadress
- ORG: företag eller organisation
- TITLE: befattning
- URL och ADR: webbplats och postadress
Vilken version du bör använda
Version 3.0 är fortfarande det säkraste valet för QR-koder eftersom nästan varje telefon läser den. Den definieras i RFC 2426 från 1998. Version 4.0, definierad i RFC 6350 år 2011, är den aktuella standarden och kräver UTF-8, men vissa äldre läsare hanterar den mindre konsekvent.
Version 3.0 förväntar sig både N och FN, medan 4.0 bara kräver FN. Oavsett vilken version som används bör raden VERSION komma direkt efter BEGIN:VCARD.
Avvägningar mellan storlek och skanning
Varje fält som läggs till i ett vCard lägger till tecken, och fler tecken ger en tätare QR-kod med mindre moduler. Ett kort med ett namn, ett telefonnummer och en e-postadress skannas lätt även i visitkortsstorlek. Att lägga till en postadress, flera nummer, en lång anteckning eller ett inbäddat foto kan driva koden till en version som måste tryckas mycket större.
Foton är det vanliga problemet: en base64-kodad bild kan uppgå till tusentals tecken och ryms sällan i en praktisk kod. Ett vanligt alternativ är att koda en kort länk till en hostad .vcf-fil eller kontaktsida, vilket håller koden liten och låter uppgifterna ändras senare.