CodeBox Hub
ILMAISEKSI

QR-koodi tapahtumalle: vEvent-kentät ja kalenterihaasteet

Lisää tapahtuma puhelimen kalenteriin vEvent-muodossa: kentät, UID/DURATION-ongelmat ja 3-vaiheinen opas.

# 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äSyntaksiPakollinenEsimerkkiHuomiot
VersionVERSION:2.0KylläVERSION:2.0vCalendar 2.0 -rivi
UIDUID:unique@hostKylläUID:conf-42@codeboxhub.comTapahtumakohtaisesti uniikki
DTSTAMPDTSTAMP:20260801T090000ZKylläDTSTAMP:20260801T090000ZLuontiaika, UTC
SUMMARYSUMMARY:KeynoteEiSUMMARY:KeynoteKalenterissa näkyvä otsikko
DTSTARTDTSTART;TZID=...:…Ei*DTSTART:20260801T090000*Useimmat puhelimet vaativat sen
DTENDDTEND:…EiDTEND:20260801T103000Päiväkohtaiset tapahtumat: jätä pois, käytä VALUE=DATE
LOCATIONLOCATION:Hall BEiLOCATION:Hall B, CenterPelkkä teksti, ei maantieteellistä koodia
DESCRIPTIONDESCRIPTION:Agenda insideEiDESCRIPTION:Agenda insideRivinvaihdot pakotetaan muodossa \n
URLURL:https://…EiURL:https://conf.example/Kaverisivu tai rekisteröityminen
STATUSSTATUS:CONFIRMEDEiSTATUS:CONFIRMEDMyös TENTATIVE / CANCELLED ovat kelvollisia

vEvent-ongelmat

OngelmaMitä tapahtuuKorjaus
Toinen UID useissa tapahtumissaKalenterit käsittelevät päivitykset yhtenä tapahtumanaTee UID:stä uniikki jokaiselle tapahtumalle
DTSTART ilman DTEND:ää aikatautitulle tapahtumalleJotkin asiakkaat näyttävät nollapituisen tapahtumanAseta molemmat, vaikka kesto olisi 15 minuuttia
Päiväkohtaisessa tapahtumassa aika DTSTART-kentässäKalenteri näyttää 00:00, ei päiväkohtaistaKäytä VALUE=DATE ja vain päivämääräkenttiä
Sekoitetut aikavyöhykkeet yhdessä tapahtumassaTuonti epäonnistuu iOS:ssä tai AndroidissaYksi vyöhyke, tai kaikki UTC
Pakottamattomat pilkut ja rivinvaihdot DESCRIPTION-kentässäKentät katkeavat tekstin keskeltäPakota muodossa \, ja \n
DTSTAMP puuttuuTiukat tuontiohjelmat hylkäävät tietueenSisältä se aina, UTC-aikana
UID:ssä välilyöntejä tai välimerkkejäTiukat tuontiohjelmat hylkäävät tietueenKäytä vain kirjaimia, numeroita, väliviivoja ja pisteitä
DTSTART menneisyydessäAsiakkaat voivat tuoda sen vanhentuneena tai hylätä senKoodaa uudelleen tulevaisuuden ajalla; uudelleenpainatukset vaativat uuden DTSTAMPin

Kalenteritapahtuman QR-koodi luo tietueen kelvollisella UID:llä ja DTSTAMP:illa puolestasi.

3-vaiheinen opas

  1. Täytä otsikko, päivämäärä, aika, sijainti ja huomiot tapahtuma-QR-generaattoriin.
  2. Vie PNG- tai SVG-tiedosto; tyypillisen istunnon kuormitus pysyy alle ~250 tavun.
  3. 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

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.

Lue lisää

Ota yhteyttä