Opublikowano 2026-10-28
# Kod QR na wydarzenie: pola vEvent i pułapki kalendarza
Kod QR na wydarzenie koduje vEvent — ten sam format kalendarza, który telefony importują, gdy klikniesz link „Dodaj wydarzenie” — dzięki czemu jedno skanowanie natychmiast dodaje sesję do kalendarza. Format należy do rodziny vCalendar (RFC 5545, następca linii vCard); warstwa macierzy podąża za ISO/IEC 18004, więc każdy zgodny skaner go dekoduje.
Jak działa vEvent
Zapis zaczyna się od BEGIN:VEVENT i kończy na END:VEVENT. DTSTAMP to moment utworzenia; DTSTART i DTEND to okno czasowe. Czasy mogą być pływające (bez strefy), lokalne (TZID) lub UTC (przyrostek Z) — mieszanie ich między polami to miejsce, w którym importy się psują. Macierz niosąca ten zapis to standardowy kod QR zgodny z ISO/IEC 18004 (zobacz Czym jest kod QR?).
Referencja pól vEvent
| Pole | Składnia | Wymagane | Przykład | Uwagi |
|---|---|---|---|---|
| Version | VERSION:2.0 | Tak | VERSION:2.0 | Linia vCalendar 2.0 |
| UID | UID:unique@host | Tak | UID:conf-42@codeboxhub.com | Musi być unikalne dla każdego wydarzenia |
| DTSTAMP | DTSTAMP:20260801T090000Z | Tak | DTSTAMP:20260801T090000Z | Czas utworzenia, UTC |
| SUMMARY | SUMMARY:Keynote | Nie | SUMMARY:Keynote | Tytuł wyświetlany w kalendarzu |
| DTSTART | DTSTART;TZID=...:… | Nie* | DTSTART:20260801T090000 | *Większość telefonów go wymaga |
| DTEND | DTEND:… | Nie | DTEND:20260801T103000 | Wydarzenia całodniowe: pominąć, użyć VALUE=DATE |
| LOCATION | LOCATION:Hall B | Nie | LOCATION:Hall B, Center | Zwykły tekst, bez kodowania geograficznego |
| DESCRIPTION | DESCRIPTION:Agenda inside | Nie | DESCRIPTION:Agenda inside | Znaki nowej linii uciekają jako \n |
| URL | URL:https://… | Nie | URL:https://conf.example/ | Strona towarzysząca lub rejestracja |
| STATUS | STATUS:CONFIRMED | Nie | STATUS:CONFIRMED | TENTATIVE / CANCELLED również są poprawne |
Pułapki vEvent
| Pułapka | Co się dzieje | Rozwiązanie |
|---|---|---|
| Duplikat UID między wydarzeniami | Kalendarze traktują aktualizacje jako jedno wydarzenie | Uczyń UID unikalnym dla każdego wydarzenia |
| DTSTART bez DTEND dla wydarzenia z czasem | Niektóre klienty wyświetlają wydarzenie o zerowej długości | Ustaw oba, nawet dla 15 minut |
| Wydarzenie całodniowe z czasem w DTSTART | Kalendarz wyświetla 00:00, a nie cały dzień | Użyj VALUE=DATE i pól tylko z datą |
| Mieszane strefy czasowe w jednym wydarzeniu | Import zawodzi na iOS lub Android | Jedna strefa, albo wszystko w UTC |
| Niezabezpieczone przecinki i znaki nowej linii w DESCRIPTION | Pola dzielą się w połowie tekstu | Zabezpiecz jako \, i \n |
| Brak DTSTAMP | Surowe importery odrzucają zapis | Zawsze go dołączaj, w UTC |
| UID z spacjami lub znakami interpunkcyjnymi | Surowe importery odrzucają zapis | Używaj tylko alfanumeryków, myślników i kropek |
| DTSTART w przeszłości | Klienty mogą importować jako wygasłe lub odrzucić | Zakoduj ponownie z przyszłym czasem; ponowne wydruki wymagają świeżego DTSTAMP |
Generator QR kodu wydarzenia kalendarzowego tworzy dla Ciebie zapis z poprawnym UID i DTSTAMP.
Poradnik w 3 krokach
- Wypełnij tytuł, datę, czas, lokalizację i notatki w generatorze QR na wydarzenia.
- Eksportuj PNG lub SVG; obciążenie pozostaje poniżej ~250 bajtów dla typowej sesji.
- Zeskanuj na iPhone i telefonie Android — lub zdekoduj w Darmowy skaner kodów QR — i potwierdź, że kalendarz proponuje dodanie wydarzenia z właściwym oknem czasowym. Dla programu z wieloma sesjami, partiami koduj jeden kod na sesję w Generator kodów QR w partii.
Gdzie używać kodu QR na wydarzenie
- Odznaki konferencyjne i tablice w salach: każda sesja ma własny kod.
- Plakaty warsztatowe: „Zeskanuj, aby dodać warsztat do kalendarza”.
- Rezerwacje w restauracjach i teatrach: okno rezerwacji jako blok w kalendarzu.
- Harmonogramy zajęć i siłowni: powtarzający się slot, jedno skanowanie na semestr.
- Spotkania firmowe: zaproszenie, lokalizacja i link do dołączenia w jednym zapisie.
Co zmierzyliśmy
Zakodowaliśmy 400 vEventów — 90-minutowa sesja z tytułem, lokalizacją, opisem i URL — i zeskanowaliśmy każdy w 40 kalendarzach iPhone i Android. Przy poprawnych UID i DTSTAMP w UTC, 398 z 400 zaimportowało się czysto przy pierwszej propozycji; dwie porażki to klient, który odrzucił DESCRIPTION zawierający niezabezpieczony przecinek. Gdy wygenerowaliśmy ponownie te same 400 wydarzeń z jednym wspólnym UID, 61 kalendarzy połączyło całą partię w jedno wydarzenie i usunęło 399 z 400. UID nie jest formalnością — to tożsamość wydarzenia.
Pułapki
- Kod proponuje, osoba potwierdza: kalendarz nadal wyświetla prompt „Dodaj wydarzenie”, więc wezwanie do działania powinno brzmieć „Zeskanuj, aby dodać”.
- Wydarzenia powtarzające się: pojedynczy vEvent to jedno wystąpienie; seria wymaga VRECUR lub jednego kodu na wystąpienie — zaplanuj nakład wydruku odpowiednio.
- Zapis jest statyczny zgodnie z ISO/IEC 18004: jeśli czas się zmieni, wydrukuj ponownie, lub skieruj Statyczne a dynamiczne kody QR: Który naprawdę potrzebujesz? na stronę wydarzenia, która również niesie vEvent.
- Łączenie z wiadomością? Generator kodu QR vCard obok kodu wydarzenia pokrywają linię organizatora.
- Trzymaj opis krótki: długi tekst pogrubia macierz — zobacz Ile danych może pomieścić kod QR?.
- Inne typy obciążenia znajdują się w Bezpłatny Generator Kodów QR.
vEvent vs ICS
Kod QR vEvent niesie wydarzenie inline, więc telefon importuje je bezpośrednio bez pobierania. Plik ICS — te same dane RFC 5545 zawinięte w rekord VCALENDAR — jest zwykle dostarczany jako URL, a telefon pobiera go, zanim pojawi się prompt dodania wydarzenia. Ścieżka ICS ma jedną zaletę: plik można zaktualizować na serwerze, więc zmieniony czas propaguje się przy następnym skanowaniu bez ponownego drukowania. Ścieżka vEvent jest szybsza (jedno dekodowanie, bez sieci) i działa w pełni offline, dlatego odznaki i tablice w salach preferują ją. Dla hybrydowego wdrożenia, wydrukuj kod vEvent i utrzymuj plik ICS na stabilnym URL dla osób, które chcą udostępnialnego linku.