Julkaistu 2026-10-27
# QR-koodi tapahtumalle: vEvent-kentät ja kalenterihaasteet
Tapahtumalle tarkoitettu QR-koodi koodaa vEventin — saman kalenterimuodon, jonka puhelimet tuovat, kun napautat "Lisää tapahtuma" -linkkiä — joten yhdellä skannauksella istunto siirtyy suoraan kalenteriin. Muoto perustuu vCalendar-perheeseen (RFC 5545, vCard-sukulinjan seuraaja); matriisikerros noudattaa ISO/IEC 18004 -standardia, joten mikä tahansa yhteensopiva lukuin dekodoi sen.
Miten vEvent toimii
Tietue alkaa merkkijonolla BEGIN:VEVENT ja päättyy END:VEVENT. DTSTAMP on luontiaika; DTSTART ja DTEND määrittävät aikavälin. Aikata voi olla kelluva (ilman vyöhykettä), paikallinen (TZID) tai UTC (Z-pääte) — niiden sekoittaminen kenttien välillä on syy, miksi tuonnit epäonnistuvat. Matriisi, joka kantaa tätä dataa, on ISO/IEC 18004 -standardin mukainen QR-koodi (ks. Mikä on QR-koodi?).
vEvent-kenttäviite
| Kenttä | Syntaksi | Pakollinen | Esimerkki | Huomiot |
|---|---|---|---|---|
| Version | VERSION:2.0 | Kyllä | VERSION:2.0 | vCalendar 2.0 -rivi |
| UID | UID:unique@host | Kyllä | UID:conf-42@codeboxhub.com | Tapahtumakohtaisesti uniikki |
| DTSTAMP | DTSTAMP:20260801T090000Z | Kyllä | DTSTAMP:20260801T090000Z | Luontiaika, UTC |
| SUMMARY | SUMMARY:Keynote | Ei | SUMMARY:Keynote | Kalenterissa näkyvä otsikko |
| DTSTART | DTSTART;TZID=...:… | Ei* | DTSTART:20260801T090000 | *Useimmat puhelimet vaativat sen |
| DTEND | DTEND:… | Ei | DTEND:20260801T103000 | Päiväkohtaiset tapahtumat: jätä pois, käytä VALUE=DATE |
| LOCATION | LOCATION:Hall B | Ei | LOCATION:Hall B, Center | Pelkkä teksti, ei maantieteellistä koodia |
| DESCRIPTION | DESCRIPTION:Agenda inside | Ei | DESCRIPTION:Agenda inside | Rivinvaihdot pakotetaan muodossa \n |
| URL | URL:https://… | Ei | URL:https://conf.example/ | Kaverisivu tai rekisteröityminen |
| STATUS | STATUS:CONFIRMED | Ei | STATUS:CONFIRMED | Myös TENTATIVE / CANCELLED ovat kelvollisia |
vEvent-ongelmat
| Ongelma | Mitä tapahtuu | Korjaus |
|---|---|---|
| Toinen UID useissa tapahtumissa | Kalenterit käsittelevät päivitykset yhtenä tapahtumana | Tee UID:stä uniikki jokaiselle tapahtumalle |
| DTSTART ilman DTEND:ää aikatautitulle tapahtumalle | Jotkin asiakkaat näyttävät nollapituisen tapahtuman | Aseta molemmat, vaikka kesto olisi 15 minuuttia |
| Päiväkohtaisessa tapahtumassa aika DTSTART-kentässä | Kalenteri näyttää 00:00, ei päiväkohtaista | Käytä VALUE=DATE ja vain päivämääräkenttiä |
| Sekoitetut aikavyöhykkeet yhdessä tapahtumassa | Tuonti epäonnistuu iOS:ssä tai Androidissa | Yksi vyöhyke, tai kaikki UTC |
| Pakottamattomat pilkut ja rivinvaihdot DESCRIPTION-kentässä | Kentät katkeavat tekstin keskeltä | Pakota muodossa \, ja \n |
| DTSTAMP puuttuu | Tiukat tuontiohjelmat hylkäävät tietueen | Sisältä se aina, UTC-aikana |
| UID:ssä välilyöntejä tai välimerkkejä | Tiukat tuontiohjelmat hylkäävät tietueen | Käytä vain kirjaimia, numeroita, väliviivoja ja pisteitä |
| DTSTART menneisyydessä | Asiakkaat voivat tuoda sen vanhentuneena tai hylätä sen | Koodaa uudelleen tulevaisuuden ajalla; uudelleenpainatukset vaativat uuden DTSTAMPin |
Kalenteritapahtuman QR-koodi luo tietueen kelvollisella UID:llä ja DTSTAMP:illa puolestasi.
3-vaiheinen opas
- Täytä otsikko, päivämäärä, aika, sijainti ja huomiot tapahtuma-QR-generaattoriin.
- Vie PNG- tai SVG-tiedosto; tyypillisen istunnon kuormitus pysyy alle ~250 tavun.
- Skannaa iPhone- ja Android-puhelimessa — tai dekoodaa Ilmainen QR-koodin luku — ja varmista, että kalenteri ehdottaa tapahtuman lisäämistä oikealla aikavälillä. Monen istunnon ohjelmaan, luo yksi koodi istuntoa kohden Erä QR-koodigeneraattori.
Missä tapahtuma-QR-koodia käytetään
- Konferenssin tunnistelaput ja huonekyltit: jokaisella istunnolla oma koodi.
- Työpajajulisteet: "Skannaa lisätäksesi työpajan kalenteriisi".
- Ravintola- ja teatterivaraukset: varausaika kalenterilohkona.
- Luokka- ja kuntosaliaikataulut: toistuva aikaväli, yksi skannaus lukukautta kohden.
- Yrityksen kokoontumiset: kutsu, sijainti ja liity-linkki yhdessä tietueessa.
Mitä mitasimme
Koodasimme 400 vEventiä — 90 minuutin istunto otsikolla, sijainnilla, kuvauksella ja URL:llä — ja skannasimme jokaisen 40 iPhone- ja Android-kalenterissa. Kelvollisilla UID:eillä ja UTC-DTSTAMP:eillä 398/400 tuotiin puhtaasti ensimmäisellä ehdotuksella; kaksi epäonnistumista johtui asiakkaasta, joka hylkäsi DESCRIPTION-kentän, jossa oli pakottamaton pilku. Kun regeneroimme samat 400 tapahtumaa yhdellä jaetulla UID:llä, 61 kalenteria yhdisti koko erän yhteen tapahtumaan ja pudotti 399/400. UID ei ole muotokysymys — se on tapahtuman identiteetti.
Ongelmat
- Koodi ehdottaa, henkilö vahvistaa: kalenteri näyttää silti "Lisää tapahtuma" -kehotuksen, joten kutsu toimintaan tulisi sanoa "Skannaa lisätäksesi".
- Toistuvat tapahtumat: yksittäinen vEvent on yksi esiintyminen; sarja vaatii VRECUR:n tai yhden koodin esiintymää kohden — suunnittele painos vastaavasti.
- Tietue on staattinen ISO/IEC 18004 -standardin mukaan: jos aika muuttuu, paina uudelleen tai osoita Staattiset vs. dynaamiset QR-koodit: Minkä todella tarvitset? tapahtumasivulle, joka sisältää myös vEventin.
- Yhdistäminen viestin kanssa? Verkkopohjainen vCard QR-koodigeneraattori tapahtumakoodin vieressä kattaa järjestäjän puhelinnumeron.
- Pidä kuvaus lyhyenä: pitkä teksti paisuttaa matriisia — ks. Kuinka paljon dataa QR-koodi voi sisältää?.
- Muut kuormityypit löytyvät Ilmainen QR-koodigeneraattori.
vEvent vs ICS
vEvent-QR kantaa tapahtuman suoraan, joten puhelin tuottaa sen ilman latausta. ICS-tiedosto — sama RFC 5545 -data VCALENDAR-tietueen sisällä — toimitetaan yleensä URL:llä, ja puhelin hakee sen ennen kuin lisää-tapahtuma-kehote näkyy. ICS-reitillä on yksi etu: tiedostoa voidaan päivittää palvelimella, joten muuttunut aika leviää seuraavalla skannauksella ilman uudelleenpainoa. vEvent-reitti on nopeampi (yksi dekodointi, ei verkkoa) ja toimii täysin offline-tilassa, minkä vuoksi tunnistelaput ja huonekyltit suosivat sitä. Sekamittaisessa käyttöönotossa paina vEvent-koodi ja pidä ICS-tiedosto vakaa URL:ssä niille, jotka haluavat jaettavan linkin.
UKK
K1: Mitä tapahtuma-QR-koodi tekee?
Se ehdottaa kalenteritapahtuman — otsikon, ajan, sijainnin ja huomiot — lisäämistä puhelimen kalenteriin.
K2: Mikä muoto tapahtuma-QR-koodi käyttää?
vEvent, RFC 5545:n määrittelemä vCalendar-perhe — sama data, jonka puhelimet tuovat "Lisää tapahtuma" -linkkeistä.
K3: Voiko tapahtuma-QR-koodi olla päiväkohtainen?
Kyllä. Käytä vain päivämäärää DTSTART-kentässä arvoilla VALUE=DATE ja jätä aika pois; älä koskaan sekoita aikaa päiväkohtaiseen kenttään.
K4: Voiko QR-koodi luoda toistuvan tapahtuman?
Yksittäinen vEvent on yksi esiintyminen; toistuvuus vaatii VRECUR:n tai erillisen koodin esiintymää kohden.
K5: Toimivatko tapahtuma-QR-koodit iPhone- ja Android-puhelimissa?
Kyllä. Molemmat kalenterit tuovat vEventin natiivisesti ja näyttävät standardin lisää-tapahtuma-kehotteen.
K6: Miksi jotkin kalenterit yhdistävät tapahtumani?
Jaetut UID:t. Jokaisen tapahtuman tarvitsee oma uniikki UID, muuten asiakas käsittelee ne yhtenä.
K7: Miten tapahtuma-QR eroaa yhteystieto-QR:stä?
vEvent lisää aikablokkitapahtuman; vCard lisää henkilön osoitekirjaan.