Опубликовано 2026-10-28
# 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
| Поле | Синтаксис | Обязательное | Пример | Примечания |
|---|---|---|---|---|
| Version | VERSION:2.0 | Да | VERSION:2.0 | Строка vCalendar 2.0 |
| UID | UID:unique@host | Да | UID:conf-42@codeboxhub.com | Должно быть уникальным для каждого события |
| DTSTAMP | DTSTAMP:20260801T090000Z | Да | DTSTAMP:20260801T090000Z | Время создания, UTC |
| SUMMARY | SUMMARY:Keynote | Нет | SUMMARY:Keynote | Заголовок, отображаемый в календаре |
| DTSTART | DTSTART;TZID=...:… | Нет* | DTSTART:20260801T090000 | *Большинство телефонов требуют его |
| DTEND | DTEND:… | Нет | DTEND:20260801T103000 | События на весь день: опустить, использовать VALUE=DATE |
| LOCATION | LOCATION:Hall B | Нет | LOCATION:Hall B, Center | Обычный текст, без геокодирования |
| DESCRIPTION | DESCRIPTION:Agenda inside | Нет | DESCRIPTION:Agenda inside | Переносы строк экранируются как \n |
| URL | URL:https://… | Нет | URL:https://conf.example/ | Сопутствующая страница или регистрация |
| STATUS | STATUS: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 шагов
- Заполните заголовок, дату, время, место и примечания в генераторе QR-кодов для мероприятий.
- Экспортируйте PNG или SVG; полезная нагрузка остается менее ~250 байт для типичной сессии.
- Отсканируйте на 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 для тех, кто хочет разделяемую ссылку.