Опубліковано 2026-10-27
# 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.
- Поєднання з повідомленням? Генератор vCard QR-кодів поруч із кодом події покриває лінію організатора.
- Тримайте опис коротким: довгі тексти роздувають матрицю — див. Скільки даних може містити QR-код?.
- Інші типи навантажень знаходяться в Безкоштовний QR-генератор.
vEvent проти ICS
QR-код vEvent несе подію вбудовано, тому телефон імпортує його безпосередньо без завантаження. Файл ICS — ті самі дані RFC 5545, загорнуті в запис VCALENDAR — зазвичай доставляється як URL, і телефон отримуює його перед появою запиту на додавання події. Маршрут ICS має одну перевагу: файл можна оновити на сервері, тому змінений час поширюється при наступному скануванні без повторного друку. Маршрут vEvent швидший (один декод, без мережі) і працює повністю офлайн, тому бейджі та вивіски в залах віддають йому перевагу. Для гібридного розгортання, надрукуйте код vEvent і зберігайте файл ICS за стабільним URL для тих, хто хоче посилання для поширення.