Генератор QR-кода визитки (vCard)

Как выглядит запись vCard 4.0

Полезная нагрузка — это маленький текстовый документ, а не ссылка. Он открывается строками BEGIN:VCARD и VERSION:4.0, несёт по одному свойству на строку с разделителем из возврата каретки и перевода строки и закрывается END:VCARD. Версия 4.0 определена в RFC 6350.

За имя отвечают два свойства, и работа у них разная. N хранит структурированное имя в пяти упорядоченных слотах, начиная с фамилии. FN хранит одну строку для отображения, которую показывает адресная книга, и RFC 6350 делает FN обязательным — поэтому карточка вообще без имени не является корректной записью.

ADR — это одно свойство из семи компонентов в фиксированном порядке, и пустым компонентам разделители всё равно нужны. Именно поэтому адрес без абонентского ящика начинается с двух точек с запятой перед улицей.

• N:Соколова;Марина;;; затем FN:Марина Соколова
• ORG:Северный переплёт и TITLE:Начальник производства
• TEL;TYPE=cell:+79161234567 и TEL;TYPE=work,voice:+74951234567
• ADR;TYPE=work:;;улица Свободы, 18;Ярославль;Ярославская область;150000;Россия
• RFC 6350 типизирует TEL как URI tel:; более короткая форма с голым номером, которая используется здесь, — то, чего ждут и парсеры эпохи 3.0

Почему карточка контакта даёт большой символ

Карточка, заполняющая на этой странице каждое поле, доходит примерно до 400 байт текста — в несколько раз больше обычной веб-ссылки. Уровень H тратит около двух третей кодовых слов символа на коррекцию ошибок — 2430 из 3706 на версии 40, — и именно это покупает те примерно 30 процентов символа, которые он способен восстановить. Это же делает H уровнем, который вмещает меньше всего: сетка версии 20 держит на H 382 байта. Поэтому по умолчанию здесь стоит M, который размещает ту же информацию на заметно меньшей сетке.

Версия 20 — это 97 модулей в поперечнике. Вместе со свободной зоной в четыре модуля с каждой стороны, которую требует стандарт, получается 105 модулей от края до края. При печати шириной 25 мм каждый модуль — около 0,24 мм. Рекомендации по печати кладут нижнюю границу между 0,4 и 0,5 мм на модуль, так что этим 105 ширинам модуля нужно где-то от 42 до 53 мм, и полная карточка контакта на 25 мм заметно не дотягивает ни до одной из этих цифр.

Если код обязан быть маленьким, лечится это меньшим числом байт, а не большей коррекцией. Отказ от заметки, второго телефона и региона часто убирает из полезной нагрузки сотню байт и опускает версию сразу на несколько ступеней.

• Символы с диакритикой и нелатинские кодируются в UTF-8 и стоят от двух до четырёх байт каждый вместо одного
• Логотип в центре принудительно включает уровень H, поэтому полной карточке с логотипом нужен больший размер печати
• Абсолютный потолок одного символа — 2953 байта, на уровне L

Версия 4.0 и то, что её всё ещё читает

В обращении три версии vCard: 2.1, 3.0 из RFC 2426 и 4.0 из RFC 6350. Эта страница пишет 4.0 — действующую спецификацию и ту, которая задаёт UTF-8 как кодировку, а не оставляет наборы символов на откуп параметру.

«Контакты» в iOS и современные приложения контактов в Android читают записи 4.0 из сканирования. Ниже этого уровня поддержка не всеобщая: часть старых сторонних приложений контактов и часть корпоративных адресных книг делались под 2.1 или 3.0 и либо проигнорируют незнакомые свойства, либо откажутся от записи целиком. Если карточка должна дойти до парка старых аппаратов, проверьте на одном, прежде чем печатать тысячу.

Ничто в записи не проверяется. vCard утверждает то, что вы напечатали, поэтому сканирование — это предложение сохранить контакт, а не доказательство, что контакт настоящий. Все платформы показывают экран подтверждения, прежде чем писать в адресную книгу.