CodeBox Hub
ZDARMA

QR kód pro akci: Pole vEvent a pasti kalendáře

Přidejte akci do kalendáře telefonu ve formátu vEvent: tabulka polí, pasti s UID/DURATION a 3krokový návod.

# 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

PoleSyntaxePovinnéPříkladPoznámky
VersionVERSION:2.0AnoVERSION:2.0Řádek vCalendar 2.0
UIDUID:unique@hostAnoUID:conf-42@codeboxhub.comMusí být unikátní pro každou akci
DTSTAMPDTSTAMP:20260801T090000ZAnoDTSTAMP:20260801T090000ZČas vytvoření, UTC
SUMMARYSUMMARY:KeynoteNeSUMMARY:KeynoteNázev zobrazený v kalendáři
DTSTARTDTSTART;TZID=...:…Ne*DTSTART:20260801T090000*Většina telefonů ho vyžaduje
DTENDDTEND:…NeDTEND:20260801T103000Celodenní akce: vynechat, použít VALUE=DATE
LOCATIONLOCATION:Hall BNeLOCATION:Hall B, CenterČistý text, bez geokódování
DESCRIPTIONDESCRIPTION:Agenda insideNeDESCRIPTION:Agenda insideZálomky escapované jako \n
URLURL:https://…NeURL:https://conf.example/Doprovazná stránka nebo registrace
STATUSSTATUS:CONFIRMEDNeSTATUS:CONFIRMEDTENTATIVE / CANCELLED jsou také platné

Pasti vEvent

PastCo se staneŘešení
Duplicitní UID napříč akcemiKalendáře považují aktualizace za jednu akciUdělejte UID unikátní pro každou akci
DTSTART bez DTEND pro časovanou akciNěkteré klienty zobrazí akci s nulovou délkouNastavte oba, i pro 15 minut
Celodenní akce s časem v DTSTARTKalendář zobrazí 00:00, nikoli celodenníPoužijte VALUE=DATE a pole pouze s datem
Smíšené časové zóny v jedné akciImport selže na iOS nebo AndroidJedna zóna, nebo vše v UTC
Neescapované čárky a zálomky v DESCRIPTIONPole se rozdělí uprostřed textuEscapujte jako \, a \n
Chybějící DTSTAMPPřísní importéři záznam zamítnouVždy ho zahrňte, v UTC
UID s mezerami nebo interpunkcíPřísní importéři záznam zamítnouPoužívejte pouze alfanumerické znaky, pomlčky a tečky
DTSTART v minulostiKlienti mohou importovat jako expirovanou nebo ji odmítnoutPř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

  1. Vyplňte název, datum, čas, místo a poznámky v generátoru QR kódů pro akce.
  2. Exportujte PNG nebo SVG; payload zůstane pod ~250 bajty pro typickou session.
  3. 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.

Časté otázky

Co dělá QR kód pro akci?

Nabízí přidat akci do kalendáře telefonu — název, čas, místo a poznámky.

Jaký formát používá QR kód pro akci?

vEvent, rodina vCalendar definovaná RFC 5545 — stejná data, která telefony importují z odkazů „Přidat akci“.

Může být QR kód pro akci celodenní?

Ano. Použijte pouze datum v DTSTART s VALUE=DATE a vynechte čas; nikdy nemíchejte čas do celodenního pole.

Může QR kód vytvořit opakující se akci?

Jeden vEvent je jedno vyskytnutí; opakování potřebuje VRECUR nebo samostatný kód pro každé vyskytnutí.

Fungují QR kódy pro akce na iPhone a Android?

Ano. Oba kalendáře importují vEvent nativně a zobrazují standardní výzvu k přidání akce.

Proč některé kalendáře slučují moje akce?

Sdílené UID. Každá akce potřebuje své vlastní unikátní UID, jinak je klient považuje za jednu.

Jak se liší QR kód pro akci od kontaktního QR kódu?

vEvent přidává schůzku s časovým blokem; vCard přidává osobu do adresáře.

Čtěte také

Kontaktujte nás