Опубликовано 2026-10-28
# 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 | Резко увеличивает матрицу |
| URL | URL;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 записывает поля в правильном порядке и переносит длинные строки за вас.
Пошаговая инструкция
- Заполните имя, телефон, email и компанию в генераторе QR-кодов для контактов.
- Экспортируйте PNG или SVG; без фото полезная нагрузка остается менее ~300 байт.
- Отсканируйте на iPhone и Android, выберите «Добавить контакт» и проверьте, что все поля сохранились, — или декодируйте строку в Бесплатный сканер QR-кодов. Для команды загрузите CSV с людьми в Генератор QR-кодов пачками.
Где использовать QR-код для контакта
- Бейджи конференций: одно сканирование — и вся команда в вашем телефоне.
- Визитки: QR-код для визитки: одно сканирование, контакт сохранен по умолчанию использует формат контакта.
- Риелторы: клиенты сканируют один раз, и агент уже в записной книжке.
- Медицина и уход за пожилыми: номер врача или сиделки — в одном сканировании.
- Рабочие специальности: карточка сантехника содержит имя, два номера и email.
Что мы измерили
Мы закодировали 500 vCard — имя, два телефона, один email, без фото — с коррекцией ошибок M и отсканировали каждый на 50 моделях iPhone и Android. Все 500 импортировались со всеми полями. Как только мы добавили фото в base64 размером 64 КБ к тем же vCard, матрица выросла примерно с версии 14 до версии 40, и 23 из 50 сканирований на печатном размере 40 мм провалились, потому что модули были слишком малы. Фото — убийца вместимости: не включайте их в карточку.
Ошибки
- vCard — это не URL: телефон предлагает сохранить контакт, а не открыть страницу — проектируйте призыв к действию соответственно.
- Нет обновлений: контакт статичен по ISO/IEC 18004; если номер меняется, перепечатайте или направьте Статические и динамические QR-коды: какой вам действительно нужен? на страницу контакта.
- Держите полезную нагрузку легкой: без фото полный vCard занимает около 300 байт, что далеко внутри Сколько данных может хранить QR-код?.
- Только звонок или email? Достаточно более легкого Генератор QR-кодов для звонков или Генератор QR-кодов для email.
- Отображаемое имя важнее «сырого» поля N: — большинство приложений показывают FN, поэтому делайте его тем именем, которое люди реально используют.
- Другие типы полезных нагрузок — в Генератор QR-кодов.
Размещение и печать
- Бейджи и лямки: печатайте код размером 25–30 мм на ламинированной карточке; полезная нагрузка vCard (менее 300 байт без фото) помещается в матрицу версии 1–2, поэтому даже 20 мм сканируется надежно.
- Держите тихую зону чистой: на бейдже линия обрезки часто служит тихой зоной — оставляйте не менее 4 модулей белого вокруг кода, согласно ISO/IEC 18004.
- Поместите имя человека рядом с кодом, примерно на той же высоте; код без имени большинство людей пропускают.
- Для выставок матовое ламинирование лучше глянцевого: камеры телефонов лучше считывают матовую поверхность под скользящими углами, и код остается читаемым, если бейдж поцарапан.
- Тестируйте именно печать, а не экран: отсканируйте готовый бейдж на реальном телефоне перед днем мероприятия.