CodeBox Hub
БЕЗКОШТОВНО

QR-код для контакту: поля vCard та типові помилки формату

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

# 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

Генератор vCard QR-кодів записує поля у правильному порядку та обрізає довгі рядки за вас.

Навчальний посібник із 3 кроків

  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-код контакту містити фото?

Технічно так, через base64 поле PHOTO, але це настільки збільшує матрицю, що дрібний друк не сканується; не включайте його.

П4: Як додати два номери телефонів в один vCard?

Напишіть два рядки TEL з різними типами, наприклад `TEL;TYPE=CELL` та `TEL;TYPE=WORK`.

П5: Чи працюють QR-коди контактів на Android?

Так. Android розглядає vCard як імпорт контакту та показує стандартний процес додавання контакту.

П6: Яка різниця між полями N: та FN:?

N: — це структуроване прізвище/ім'я, що використовується для сортування; FN: — це відображуване ім'я, яке показує додаток контактів.

П7: Чи QR-код контакту такий самий, як QR-код візитки?

Зазвичай так — типові дані візитки — це vCard; різниця лише в тому, що ви друкуєте навколо нього.

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

Зв'язатися з нами