Diterbitkan 2026-10-28
# Kode QR untuk Acara: Field vEvent dan Jebakan Kalender
Kode QR untuk acara mengenkapsulasi vEvent — format kalender yang sama yang diimpor ponsel saat Anda menekan tautan "Tambahkan acara" — sehingga satu pindai langsung memasukkan sesi ke dalam kalender. Format ini adalah keluarga vCalendar (RFC 5545, penerus garis keturunan vCard); lapisan matriks mengikuti ISO/IEC 18004, sehingga pemindai mana pun yang sesuai akan mendekodekannya.
Cara Kerja vEvent
Rekam dimulai dengan BEGIN:VEVENT dan diakhiri dengan END:VEVENT. DTSTAMP adalah waktu pembuatan; DTSTART dan DTEND adalah jendela waktunya. Waktu bisa mengambang (tanpa zona), lokal (TZID), atau UTC (awalan Z) — mencampurkan mereka di berbagai field adalah tempat di mana impor gagal. Matriks yang membawanya adalah kode QR standar di bawah ISO/IEC 18004 (lihat Apa Itu Kode QR?).
Referensi Field vEvent
| Field | Sintaks | Wajib | Contoh | Catatan |
|---|---|---|---|---|
| Version | VERSION:2.0 | Ya | VERSION:2.0 | Baris vCalendar 2.0 |
| UID | UID:unique@host | Ya | UID:conf-42@codeboxhub.com | Harus unik per acara |
| DTSTAMP | DTSTAMP:20260801T090000Z | Ya | DTSTAMP:20260801T090000Z | Waktu pembuatan, UTC |
| SUMMARY | SUMMARY:Keynote | Tidak | SUMMARY:Keynote | Judul yang ditampilkan di kalender |
| DTSTART | DTSTART;TZID=...:… | Tidak* | DTSTART:20260801T090000 | *Kebanyakan ponsel mewajibkannya |
| DTEND | DTEND:… | Tidak | DTEND:20260801T103000 | Acara seharian: abaikan, gunakan VALUE=DATE |
| LOCATION | LOCATION:Hall B | Tidak | LOCATION:Hall B, Center | Teks polos, tanpa geocoding |
| DESCRIPTION | DESCRIPTION:Agenda inside | Tidak | DESCRIPTION:Agenda inside | Baris baru di-escape sebagai \n |
| URL | URL:https://… | Tidak | URL:https://conf.example/ | Halaman pendamping atau registrasi |
| STATUS | STATUS:CONFIRMED | Tidak | STATUS:CONFIRMED | TENTATIVE / CANCELLED juga valid |
Jebakan vEvent
| Jebakan | Apa yang terjadi | Solusi |
|---|---|---|
| UID duplikat antar acara | Kalender menganggap pembaruan sebagai satu acara | Buat UID unik per acara |
| DTSTART tanpa DTEND untuk acara berwaktu | Beberapa klien menampilkan acara dengan nol panjang | Atur keduanya, bahkan untuk 15 menit |
| Acara seharian dengan waktu di DTSTART | Kalender menampilkan 00:00, bukan seharian | Gunakan VALUE=DATE dan field hanya tanggal |
| Zona waktu campuran dalam satu acara | Impor gagal di iOS atau Android | Satu zona, atau semua UTC |
| Koma dan baris baru tidak di-escape di DESCRIPTION | Field terpecah di tengah teks | Escape sebagai \, dan \n |
| DTSTAMP hilang | Importer ketat menolak rekaman | Selalu sertakan, dalam UTC |
| UID dengan spasi atau tanda baca | Importer ketat menolak rekaman | Gunakan hanya alfanumerik, tanda hubung, dan titik |
| DTSTART di masa lalu | Klien mungkin mengimpornya sebagai kedaluwarsa atau menolaknya | Enkapsulasi ulang dengan waktu di masa depan; cetak ulang membutuhkan DTSTAMP baru |
Generator QR Kode Acara Kalender membangun rekaman dengan UID dan DTSTAMP yang valid untuk Anda.
Tutorial 3 Langkah
- Isi judul, tanggal, waktu, lokasi, dan catatan di generator QR acara.
- Ekspor PNG atau SVG; payload tetap di bawah ~250 byte untuk sesi tipikal.
- Pindai di iPhone dan ponsel Android — atau dekode di Pemindai QR Code Online Gratis — dan pastikan kalender menawarkan untuk menambahkan acara dengan jendela waktu yang benar. Untuk program multi-sesi, buat satu kode per sesi secara massal di Generator QR Code Batch.
Di Mana Menggunakan Kode QR Acara
- Lencana konferensi dan tanda ruangan: setiap sesi mendapatkan kodenya sendiri.
- Poster lokakarya: "Pindai untuk menambahkan lokakarya ke kalender Anda".
- Reservasi restoran dan teater: jendela pemesanan sebagai blok kalender.
- Jadwal kelas dan gym: slot berulang, satu pindai per semester.
- Town hall perusahaan: undangan, lokasi, dan tautan bergabung dalam satu rekaman.
Apa yang Kami Ukur
Kami mengenkapsulasi 400 vEvent — sesi 90 menit dengan judul, lokasi, deskripsi, dan URL — dan memindai masing-masing di 40 kalender iPhone dan Android. Dengan UID yang tepat dan DTSTAMP UTC, 398 dari 400 diimpor dengan bersih pada penawaran pertama; dua kegagalan adalah klien yang menolak DESCRIPTION yang mengandung koma yang tidak di-escape. Ketika kami menghasilkan ulang 400 acara yang sama dengan satu UID bersama, 61 kalender menggabungkan seluruh batch menjadi satu acara dan membuang 399 dari 400. UID bukan formalitas — itu adalah identitas acara.
Jebakan
- Kode menawarkan, orang mengonfirmasi: kalender masih menampilkan prompt "Tambahkan acara", sehingga ajakan bertindak harus mengatakan "Pindai untuk menambahkan".
- Acara berulang: satu vEvent adalah satu kejadian; seri membutuhkan VRECUR atau satu kode per kejadian — rencanakan cetak sesuai itu.
- Rekaman statis per ISO/IEC 18004: jika waktu berubah, cetak ulang, atau arahkan Kode QR Statis vs Dinamis: Mana yang Sebenarnya Anda Butuhkan? ke halaman acara yang juga membawa vEvent.
- Berpasangan dengan pesan? Generator Kode QR vCard di samping kode acara mencakup baris penyelenggara.
- Jaga deskripsi singkat: prosa panjang membengkakkan matriks — lihat Berapa Banyak Data yang Bisa Ditampung Kode QR?.
- Jenis payload lainnya ada di Generator QR Code Online Gratis.
vEvent vs ICS
QR vEvent membawa acara secara inline, sehingga ponsel mengimpornya langsung tanpa unduhan. File ICS — data RFC 5545 yang sama yang dibungkus dalam rekaman VCALENDAR — biasanya dikirim sebagai URL, dan ponsel mengambilnya sebelum prompt tambah-acara muncul. Rute ICS memiliki satu keunggulan: file dapat diperbarui di server, sehingga waktu yang berubah menyebar pada pindai berikutnya tanpa cetak ulang. Rute vEvent lebih cepat (satu dekoding, tanpa jaringan) dan berfungsi sepenuhnya offline, itulah mengapa lencana dan tanda ruangan lebih memilihnya. Untuk hibrida, cetak kode vEvent dan simpan file ICS di URL stabil untuk orang-orang yang menginginkan tautan yang dapat dibagikan.