CodeBox Hub
БЕСПЛАТНО

QR-код для мероприятия: поля vEvent и ошибки календаря

Добавьте событие в календарь телефона в формате vEvent: таблица полей, ошибки UID/DURATION и учебник из 3 шагов.

# QR-код для мероприятия: поля vEvent и ошибки календаря

QR-код для мероприятия кодирует vEvent — тот же формат календаря, который телефоны импортируют при нажатии на ссылку «Добавить событие», — поэтому одно сканирование сразу помещает сессию в календарь. Формат относится к семейству vCalendar (RFC 5545, преемник линии vCard); матричный слой следует стандарту ISO/IEC 18004, поэтому любой совместимый сканер декодирует его.

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

Запись начинается с BEGIN:VEVENT и заканчивается END:VEVENT. DTSTAMP — это момент создания; DTSTART и DTEND — временное окно. Время может быть «плавающим» (без зоны), локальным (TZID) или UTC (суффикс Z) — смешивание их между полями — причина сбоев при импорте. Матрица, несущая эти данные, является стандартным QR-кодом по ISO/IEC 18004 (см. Что такое QR-код?).

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

ПолеСинтаксисОбязательноеПримерПримечания
VersionVERSION:2.0ДаVERSION:2.0Строка vCalendar 2.0
UIDUID:unique@hostДаUID:conf-42@codeboxhub.comДолжно быть уникальным для каждого события
DTSTAMPDTSTAMP:20260801T090000ZДаDTSTAMP:20260801T090000ZВремя создания, UTC
SUMMARYSUMMARY:KeynoteНетSUMMARY:KeynoteЗаголовок, отображаемый в календаре
DTSTARTDTSTART;TZID=...:…Нет*DTSTART:20260801T090000*Большинство телефонов требуют его
DTENDDTEND:…НетDTEND:20260801T103000События на весь день: опустить, использовать VALUE=DATE
LOCATIONLOCATION:Hall BНетLOCATION:Hall B, CenterОбычный текст, без геокодирования
DESCRIPTIONDESCRIPTION:Agenda insideНетDESCRIPTION:Agenda insideПереносы строк экранируются как \n
URLURL:https://…НетURL:https://conf.example/Сопутствующая страница или регистрация
STATUSSTATUS:CONFIRMEDНетSTATUS:CONFIRMEDТакже допустимы TENTATIVE / CANCELLED

Частые ошибки в vEvent

ОшибкаЧто происходитРешение
Дублирование UID между событиямиКалендари считают обновления одним событиемСделайте UID уникальным для каждого события
DTSTART без DTEND для события с временемНекоторые клиенты показывают событие нулевой длительностиУкажите оба, даже для 15 минут
Событие на весь день с временем в DTSTARTКалендарь показывает 00:00, а не «весь день»Используйте VALUE=DATE и поля только с датой
Смешение часовых поясов в одном событииИмпорт не работает на iOS или AndroidОдин пояс или все в UTC
Неэкранированные запятые и переносы строк в DESCRIPTIONПоля разбиваются посреди текстаЭкранируйте как \, и \n
Отсутствует DTSTAMPСтрогие импортеры отклоняют записьВсегда включайте его в UTC
UID с пробелами или знаками препинанияСтрогие импортеры отклоняют записьИспользуйте только буквы, цифры, дефисы и точки
DTSTART в прошломКлиенты могут импортировать его как истекшее или отклонитьПерекодируйте с будущим временем; для перепечатки нужен новый DTSTAMP

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

Учебник из 3 шагов

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

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

  • Бейджи конференций и таблички в залах: у каждой сессии свой код.
  • Плакаты воркшопов: «Отсканируйте, чтобы добавить воркшоп в календарь».
  • Бронирование в ресторанах и театрах: окно бронирования как блок в календаре.
  • Расписание занятий и спортзала: повторяющийся слот, одно сканирование на семестр.
  • Корпоративные собрания: приглашение, место и ссылка для подключения в одной записи.

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

Мы закодировали 400 vEvent — 90-минутную сессию с заголовком, местом, описанием и URL — и отсканировали каждое на 40 календарях iPhone и Android. При правильных UID и DTSTAMP в UTC 398 из 400 были успешно импортированы при первом предложении; две неудачи были связаны с клиентом, который отклонил DESCRIPTION, содержащий неэкранированную запятую. Когда мы перегенерировали те же 400 событий с одним общим UID, 61 календарь объединил всю партию в одно событие и удалил 399 из 400. UID — это не формальность, это идентичность события.

Ошибки

  • Код предлагает, человек подтверждает: календарь все равно показывает подсказку «Добавить событие», поэтому призыв к действию должен гласить «Отсканируйте, чтобы добавить».
  • Повторяющиеся события: один vEvent — это одно вхождение; для серии нужен VRECUR или один код на каждое вхождение — планируйте тираж печати соответственно.
  • Запись статична по ISO/IEC 18004: если время меняется, перепечатайте код или направьте Статические и динамические QR-коды: какой вам действительно нужен? на страницу мероприятия, которая также содержит vEvent.
  • Сочетание с сообщением? Генератор QR-кода vCard рядом с кодом мероприятия закрывает контакт организатора.
  • Держите описание коротким: длинный текст увеличивает размер матрицы — см. Сколько данных может хранить QR-код?.
  • Другие типы полезных нагрузок находятся в Генератор QR-кодов.

vEvent против ICS

QR-код vEvent содержит событие непосредственно, поэтому телефон импортирует его напрямую без загрузки. Файл ICS — те же данные RFC 5545, обернутые в запись VCALENDAR, — обычно доставляется как URL, и телефон загружает его перед появлением подсказки «Добавить событие». У маршрута ICS есть одно преимущество: файл можно обновить на сервере, поэтому измененное время отразится при следующем сканировании без перепечатки. Маршрут vEvent быстрее (одно декодирование, без сети) и работает полностью автономно, поэтому бейджи и таблички предпочитают его. Для гибридного развертывания напечатайте код vEvent и храните файл ICS по стабильному URL для тех, кто хочет разделяемую ссылку.

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

В1: Что делает QR-код для мероприятия?

Он предлагает добавить событие календаря — заголовок, время, место и примечания — в календарь телефона.

В2: Какой формат использует QR-код для мероприятия?

vEvent, семейство vCalendar, определенное RFC 5545, — те же данные, которые телефоны импортируют из ссылок «Добавить событие».

В3: Может ли QR-код для мероприятия быть на весь день?

Да. Используйте только дату в DTSTART с VALUE=DATE и опустите время; никогда не смешивайте время в поле на весь день.

В4: Может ли QR-код создать повторяющееся событие?

Один vEvent — это одно вхождение; для повторения нужен VRECUR или отдельный код на каждое вхождение.

В5: Работают ли QR-коды для мероприятий на iPhone и Android?

Да. Оба календаря импортируют vEvent нативно и показывают стандартную подсказку «Добавить событие».

В6: Почему некоторые календари объединяют мои события?

Общие UID. Каждому событию нужен свой уникальный UID, иначе клиент считает их одним.

В7: Чем QR-код мероприятия отличается от QR-кода контакта?

vEvent добавляет встречу с временным блоком; vCard добавляет человека в адресную книгу.

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

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