Какво съдържа vCard
vCard е обикновен текст от редове с етикети, започващ с BEGIN:VCARD и завършващ с END:VCARD. Всеки ред съдържа едно свойство, като форматирано име, телефонен номер или имейл адрес. Същият текст се съдържа във файл .vcf, когато контактите се експортират от телефон или имейл програма.
Минимален vCard 3.0 за QR код изглежда така, по едно свойство на ред: 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 съдържа структурираното име (първо фамилията, разделено с точка и запетая), а FN - името във вида, в който трябва да се показва.
- N: структурирано име (фамилия;собствено;презиме;префикс;суфикс)
- FN: показвано име
- TEL: телефонен номер, за предпочитане в международен формат
- EMAIL: имейл адрес
- ORG: фирма или организация
- TITLE: длъжност
- URL и ADR: уебсайт и пощенски адрес
Коя версия да използвате
Версия 3.0 все още е най-сигурният избор за QR кодове, защото почти всички телефони я четат. Тя е определена в RFC 2426 от 1998 г. Версия 4.0, определена в RFC 6350 през 2011 г., е текущият стандарт и изисква UTF-8, но някои по-стари четци я обработват по-непоследователно.
Версия 3.0 очаква и N, и FN, докато 4.0 изисква само FN. Независимо коя версия се използва, редът VERSION трябва да е веднага след BEGIN:VCARD.
Компромиси между размер и сканиране
Всяко поле, добавено към vCard, добавя знаци, а повече знаци означават по-гъст QR код с по-малки модули. Визитка с име, един телефонен номер и един имейл се сканира лесно дори в размера на визитна картичка. Добавянето на пощенски адрес, няколко номера, дълга бележка или вградена снимка може да изкара кода във версия, която трябва да се отпечата много по-голяма.
Снимките обикновено са проблемът: изображение, кодирано в base64, може да достигне хиляди знаци и рядко се побира в практичен код. Често срещана алтернатива е да се кодира кратък линк към хоствани .vcf файл или страница с контакт, което запазва кода малък и позволява данните да се променят по-късно.
