Zveřejněno 2026-10-27
# QR kód pro akci: Pole vEvent a pasti kalendáře
QR kód pro akci kóduje vEvent — stejný formát kalendáře, který telefony importují, když klepnete na odkaz „Přidat akci“ — takže jedním naskenováním se session okamžitě dostane do kalendáře. Formát je z rodiny vCalendar (RFC 5545, nástupce linie vCard); maticová vrstva následuje standard ISO/IEC 18004, takže ho dekóduje jakýkoli kompatibilní skener.
Jak funguje vEvent
Záznam začíná na BEGIN:VEVENT a končí na END:VEVENT. DTSTAMP je okamžik vytvoření; DTSTART a DTEND jsou časové okno. Časy mohou být plovoucí (bez zóny), lokální (TZID) nebo UTC (přípona Z) — míchání těchto formátů napříč poli je místo, kde importy selhávají. Matice, která ho nese, je standardní QR kód podle ISO/IEC 18004 (viz Co je QR kód?).
Referenční tabulka polí vEvent
| Pole | Syntaxe | Povinné | Příklad | Poznámky |
|---|---|---|---|---|
| Version | VERSION:2.0 | Ano | VERSION:2.0 | Řádek vCalendar 2.0 |
| UID | UID:unique@host | Ano | UID:conf-42@codeboxhub.com | Musí být unikátní pro každou akci |
| DTSTAMP | DTSTAMP:20260801T090000Z | Ano | DTSTAMP:20260801T090000Z | Čas vytvoření, UTC |
| SUMMARY | SUMMARY:Keynote | Ne | SUMMARY:Keynote | Název zobrazený v kalendáři |
| DTSTART | DTSTART;TZID=...:… | Ne* | DTSTART:20260801T090000 | *Většina telefonů ho vyžaduje |
| DTEND | DTEND:… | Ne | DTEND:20260801T103000 | Celodenní akce: vynechat, použít VALUE=DATE |
| LOCATION | LOCATION:Hall B | Ne | LOCATION:Hall B, Center | Čistý text, bez geokódování |
| DESCRIPTION | DESCRIPTION:Agenda inside | Ne | DESCRIPTION:Agenda inside | Zálomky escapované jako \n |
| URL | URL:https://… | Ne | URL:https://conf.example/ | Doprovazná stránka nebo registrace |
| STATUS | STATUS:CONFIRMED | Ne | STATUS:CONFIRMED | TENTATIVE / CANCELLED jsou také platné |
Pasti vEvent
| Past | Co se stane | Řešení |
|---|---|---|
| Duplicitní UID napříč akcemi | Kalendáře považují aktualizace za jednu akci | Udělejte UID unikátní pro každou akci |
| DTSTART bez DTEND pro časovanou akci | Některé klienty zobrazí akci s nulovou délkou | Nastavte oba, i pro 15 minut |
| Celodenní akce s časem v DTSTART | Kalendář zobrazí 00:00, nikoli celodenní | Použijte VALUE=DATE a pole pouze s datem |
| Smíšené časové zóny v jedné akci | Import selže na iOS nebo Android | Jedna zóna, nebo vše v UTC |
| Neescapované čárky a zálomky v DESCRIPTION | Pole se rozdělí uprostřed textu | Escapujte jako \, a \n |
| Chybějící DTSTAMP | Přísní importéři záznam zamítnou | Vždy ho zahrňte, v UTC |
| UID s mezerami nebo interpunkcí | Přísní importéři záznam zamítnou | Používejte pouze alfanumerické znaky, pomlčky a tečky |
| DTSTART v minulosti | Klienti mohou importovat jako expirovanou nebo ji odmítnout | Překódujte s budoucím časem; při přetisku potřebujete nový DTSTAMP |
Generátor QR kódu pro kalendář pro vás sestaví záznam s platným UID a DTSTAMP.
3krokový návod
- Vyplňte název, datum, čas, místo a poznámky v generátoru QR kódů pro akce.
- Exportujte PNG nebo SVG; payload zůstane pod ~250 bajty pro typickou session.
- Naskenujte na iPhone a na telefonu s Androidem — nebo dekódujte v Online QR Code Scanner — a potvrďte, že kalendář nabízí přidání akce se správným časovým oknem. Pro program s více sessionmi připravte jeden kód pro každou session v Hromadný generátor QR kódů.
Kde použít QR kód pro akci
- Konferenční odznaky a cedulky v místnostech: každá session má svůj vlastní kód.
- Plakáty workshopů: „Naskenujte a přidejte workshop do svého kalendáře“.
- Rezervace v restauracích a divadlech: rezervní okno jako blok v kalendáři.
- Rozvrhy kurzů a posiloven: opakující se slot, jedno naskenování na semestr.
- Firemní town hally: pozvánka, místo a odkaz pro připojení v jednom záznamu.
Co jsme naměřili
Kódovali jsme 400 vEventů — 90minutovou session s názvem, místem, popisem a URL — a každý naskenovali na 40 kalendářích iPhone a Android. S správnými UID a DTSTAMP v UTC se 398 z 400 čistě importovalo při první nabídce; dvě selhání byla u klienta, který zamítl DESCRIPTION obsahující neescapovanou čárku. Když jsme stejné 400 akcí regenerovali s jedním sdíleným UID, 61 kalendářů sloučilo celou dávku do jedné akce a zahodilo 399 z 400. UID není formalita — je to identita akce.
Pasti
- Kód nabízí, člověk potvrzuje: kalendář stále zobrazuje výzvu „Přidat akci“, takže výzva k akci by měla znít „Naskenujte a přidejte“.
- Opakující se akce: jeden vEvent je jedno vyskytnutí; série potřebuje VRECUR nebo jeden kód pro každé vyskytnutí — naplánujte tiskový náklad podle toho.
- Záznam je statický podle ISO/IEC 18004: pokud se čas změní, přetiskněte, nebo zamířte Statické vs dynamické QR kódy: Který skutečně potřebujete? na stránku akce, která také nese vEvent.
- Párování s zprávou? Generátor QR kódu vCard vedle kódu akce pokrývá linku organizátora.
- Popis udržujte krátký: dlouhé texty nafouknou matici — viz Kolik dat zvládne QR kód?.
- Další typy payloadů najdete v Generátor QR kódů.
vEvent vs ICS
QR kód vEvent nese akci inline, takže telefon ji importuje přímo bez stahování. Soubor ICS — stejná data RFC 5545 zabalená do záznamu VCALENDAR — se obvykle dodává jako URL a telefon ho načte, než se objeví výzva k přidání akce. Cesta přes ICS má jednu výhodu: soubor lze aktualizovat na serveru, takže změna času se projeví při dalším naskenování bez přetisku. Cesta přes vEvent je rychlejší (jedno dekódování, bez sítě) a funguje plně offline, proto ji preferují odznaky a cedulky v místnostech. Pro hybridní nasazení vytiskněte kód vEvent a soubor ICS nechte na stabilní URL pro ty, kteří chtějí sdílit odkaz.