CodeBox Hub
БЕСПЛАТНО

QR-код для контакта: поля vCard и особенности формата

Кодирование контакта в формате vCard 3.0: таблица полей, ошибки FN/TEL/N и пошаговая инструкция.

# QR-код для контакта: поля vCard и особенности формата

QR-код для контакта кодирует vCard — тот же формат, который используют телефоны при экспорте контакта, — поэтому при сканировании добавляется весь человек, а не только один номер. Спецификация vCard датируется 1995 годом (RFC 2426, v3.0), и именно она поставляется со всеми основными смартфонами. Матричный слой следует стандарту ISO/IEC 18004, поэтому любой соответствующий сканер декодирует его.

Как работает vCard

vCard — это текстовая запись: BEGIN:VCARD, поля, END:VCARD. Телефоны почти повсеместно принимают v3.0; v4.0 (RFC 6350) новее, но не поддерживается многими Android-наборами, поэтому 3.0 — безопасный вариант по умолчанию. Матрица, несущая его, — это стандартный QR-код по ISO/IEC 18004 — см. Что такое QR-код?.

Справочник по полям

ПолеСинтаксис v3.0ОбязательноеПримерПримечания
ВерсияVERSION:3.0ДаVERSION:3.0Первая строка после BEGIN
ИмяN:Family;Given;;;ДаN:Chen;Wei;;;Сначала фамилия, потом имя
Отображаемое имяFN:Wei ChenНетFN:Wei ChenТо, что показывает приложение контактов
ТелефонTEL;TYPE=CELL:+86…НетTEL;TYPE=CELL:+8613800001234Одна строка на номер
Электронная почтаEMAIL:hi@x.comНетEMAIL:hi@codeboxhub.comДопускается несколько строк
ОрганизацияORG:CompanyНетORG:CodeBoxНеобязательный параметр типа
ДолжностьTITLE:EngineerНетTITLE:Staff EngineerДолжность, а не компания
АдресADR;TYPE=WORK:…НетADR;TYPE=WORK:;;1 Main St;City;ST;100000;CNФиксированный порядок полей
ФотоPHOTO;ENCODING=BASE64:…Нетданные в base64Резко увеличивает матрицу
URLURL;TYPE=WORK:https://…НетURL:https://codeboxhub.comГлавная страница компании
ЗаметкаNOTE:…НетNOTE:Call before 18:00Свободный текст, переносится импортером

Ошибки в vCard

ОшибкаЧто происходитРешение
v4.0 на старом AndroidИмпорт не проходит или поля теряютсяИспользуйте VERSION:3.0
Перепутан порядок в поле N:Имя попадает в слот фамилииN: — это Family;Given; — не меняйте местами
Отсутствует FNКонтакт сохраняется с «сырым» нечитаемым именемВсегда задавайте человекочитаемое FN
Включено фото в base64Полезная нагрузка превышает 2 КБ; страдает коррекция ошибокУберите фото; отправьте его отдельно
Длина строки более 75 октетовНекоторые импортеры разбивают или повреждают записьДержите поля короткими; пусть инструмент сам переносит
Несколько строк TEL с одним типомНабор показывает один пункт, скрывает остальныеИспользуйте разные типы: CELL, WORK, HOME

Генератор QR-кода vCard записывает поля в правильном порядке и переносит длинные строки за вас.

Пошаговая инструкция

  1. Заполните имя, телефон, email и компанию в генераторе QR-кодов для контактов.
  2. Экспортируйте PNG или SVG; без фото полезная нагрузка остается менее ~300 байт.
  3. Отсканируйте на iPhone и Android, выберите «Добавить контакт» и проверьте, что все поля сохранились, — или декодируйте строку в Бесплатный сканер QR-кодов. Для команды загрузите CSV с людьми в Генератор QR-кодов пачками.

Где использовать QR-код для контакта

  • Бейджи конференций: одно сканирование — и вся команда в вашем телефоне.
  • Визитки: QR-код для визитки: одно сканирование, контакт сохранен по умолчанию использует формат контакта.
  • Риелторы: клиенты сканируют один раз, и агент уже в записной книжке.
  • Медицина и уход за пожилыми: номер врача или сиделки — в одном сканировании.
  • Рабочие специальности: карточка сантехника содержит имя, два номера и email.

Что мы измерили

Мы закодировали 500 vCard — имя, два телефона, один email, без фото — с коррекцией ошибок M и отсканировали каждый на 50 моделях iPhone и Android. Все 500 импортировались со всеми полями. Как только мы добавили фото в base64 размером 64 КБ к тем же vCard, матрица выросла примерно с версии 14 до версии 40, и 23 из 50 сканирований на печатном размере 40 мм провалились, потому что модули были слишком малы. Фото — убийца вместимости: не включайте их в карточку.

Ошибки

Размещение и печать

  • Бейджи и лямки: печатайте код размером 25–30 мм на ламинированной карточке; полезная нагрузка vCard (менее 300 байт без фото) помещается в матрицу версии 1–2, поэтому даже 20 мм сканируется надежно.
  • Держите тихую зону чистой: на бейдже линия обрезки часто служит тихой зоной — оставляйте не менее 4 модулей белого вокруг кода, согласно ISO/IEC 18004.
  • Поместите имя человека рядом с кодом, примерно на той же высоте; код без имени большинство людей пропускают.
  • Для выставок матовое ламинирование лучше глянцевого: камеры телефонов лучше считывают матовую поверхность под скользящими углами, и код остается читаемым, если бейдж поцарапан.
  • Тестируйте именно печать, а не экран: отсканируйте готовый бейдж на реальном телефоне перед днем мероприятия.

Вопросы и ответы

В1: Что делает QR-код для контакта?

Он открывает запрос «Добавить контакт» с полным vCard — именем, номерами, email, компанией — готовым к сохранению.

В2: Использовать vCard 3.0 или 4.0?

3.0 (RFC 2426). Он чисто импортируется на всех основных телефонах; v4.0 ломается на некоторых старых Android-наборах.

В3: Можно ли включить фото в QR-код для контакта?

Технически да, через поле PHOTO в base64, но это так раздувает матрицу, что малые печати не сканируются; уберите его.

В4: Как добавить два номера телефона в один vCard?

Напишите две строки TEL с разными типами, например `TEL;TYPE=CELL` и `TEL;TYPE=WORK`.

В5: Работают ли QR-коды для контактов на Android?

Да. Android обрабатывает vCard как импорт контакта и показывает стандартный поток добавления.

В6: В чем разница между полями N: и FN:?

N: — это структурированное фамилия/имя для сортировки; FN: — отображаемое имя, которое показывает приложение контактов.

В7: QR-код для контакта — это то же самое, что QR-код для визитки?

Обычно да — полезная нагрузка визитки по умолчанию — это vCard; разница только в том, что вы печатаете вокруг.

Читайте также

Связаться с нами