CodeBox Hub
ZA DARMO

Kod QR na wydarzenie: pola vEvent i pułapki kalendarza

Dodaj wydarzenie do kalendarza telefonu w formacie vEvent: tabela pól, pułapki UID/DURATION i 3-krokowy poradnik.

# 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

PoleSkładniaWymaganePrzykładUwagi
VersionVERSION:2.0TakVERSION:2.0Linia vCalendar 2.0
UIDUID:unique@hostTakUID:conf-42@codeboxhub.comMusi być unikalne dla każdego wydarzenia
DTSTAMPDTSTAMP:20260801T090000ZTakDTSTAMP:20260801T090000ZCzas utworzenia, UTC
SUMMARYSUMMARY:KeynoteNieSUMMARY:KeynoteTytuł wyświetlany w kalendarzu
DTSTARTDTSTART;TZID=...:…Nie*DTSTART:20260801T090000*Większość telefonów go wymaga
DTENDDTEND:…NieDTEND:20260801T103000Wydarzenia całodniowe: pominąć, użyć VALUE=DATE
LOCATIONLOCATION:Hall BNieLOCATION:Hall B, CenterZwykły tekst, bez kodowania geograficznego
DESCRIPTIONDESCRIPTION:Agenda insideNieDESCRIPTION:Agenda insideZnaki nowej linii uciekają jako \n
URLURL:https://…NieURL:https://conf.example/Strona towarzysząca lub rejestracja
STATUSSTATUS:CONFIRMEDNieSTATUS:CONFIRMEDTENTATIVE / CANCELLED również są poprawne

Pułapki vEvent

PułapkaCo się dziejeRozwiązanie
Duplikat UID między wydarzeniamiKalendarze traktują aktualizacje jako jedno wydarzenieUczyń UID unikalnym dla każdego wydarzenia
DTSTART bez DTEND dla wydarzenia z czasemNiektóre klienty wyświetlają wydarzenie o zerowej długościUstaw oba, nawet dla 15 minut
Wydarzenie całodniowe z czasem w DTSTARTKalendarz wyświetla 00:00, a nie cały dzieńUżyj VALUE=DATE i pól tylko z datą
Mieszane strefy czasowe w jednym wydarzeniuImport zawodzi na iOS lub AndroidJedna strefa, albo wszystko w UTC
Niezabezpieczone przecinki i znaki nowej linii w DESCRIPTIONPola dzielą się w połowie tekstuZabezpiecz jako \, i \n
Brak DTSTAMPSurowe importery odrzucają zapisZawsze go dołączaj, w UTC
UID z spacjami lub znakami interpunkcyjnymiSurowe importery odrzucają zapisUżywaj tylko alfanumeryków, myślników i kropek
DTSTART w przeszłościKlienty 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

  1. Wypełnij tytuł, datę, czas, lokalizację i notatki w generatorze QR na wydarzenia.
  2. Eksportuj PNG lub SVG; obciążenie pozostaje poniżej ~250 bajtów dla typowej sesji.
  3. 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.

Najczęstsze pytania

Co robi kod QR na wydarzenie?

Proponuje dodanie wydarzenia kalendarzowego — tytuł, czas, lokalizacja i notatki — do kalendarza telefonu.

Jaki format używa kod QR na wydarzenie?

vEvent, rodzina vCalendar zdefiniowana przez RFC 5545 — te same dane, które telefony importują z linków „Dodaj wydarzenie”.

Czy kod QR na wydarzenie może być całodniowy?

Tak. Użyj tylko daty w DTSTART z VALUE=DATE i pominij czas; nigdy nie mieszaj czasu w polu całodniowym.

Czy kod QR może tworzyć wydarzenie powtarzające się?

Pojedynczy vEvent to jedno wystąpienie; powtarzalność wymaga VRECUR lub osobnego kodu na wystąpienie.

Czy kody QR na wydarzenia działają na iPhone i Android?

Tak. Oba kalendarze importują vEvent natywnie i wyświetlają standardowy prompt dodania wydarzenia.

Dlaczego niektóre kalendarze łączą moje wydarzenia?

Współdzielone UID. Każde wydarzenie potrzebuje własnego unikalnego UID, inaczej klient traktuje je jako jedno.

Czym kod QR na wydarzenie różni się od kodu QR kontaktowego?

vEvent dodaje umówienie z blokiem czasowym; vCard dodaje osobę do książki adresowej.

Czytaj dalej

Skontaktuj się z nami