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:CONFIRMEDTENTATIVE / 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.
  • Поєднання з повідомленням? Генератор vCard QR-кодів поруч із кодом події покриває лінію організатора.
  • Тримайте опис коротким: довгі тексти роздувають матрицю — див. Скільки даних може містити 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 додає людину в адресну книгу.

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

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