เผยแพร่เมื่อ 2026-10-28
# QR Code สำหรับงานอีเวนต์: ฟิลด์ vEvent และข้อผิดพลาดของปฏิทิน
QR Code สำหรับงานอีเวนต์จะเข้ารหัสข้อมูล vEvent — ซึ่งเป็นรูปแบบปฏิทินเดียวกันที่โทรศัพท์จะนำเข้าเมื่อคุณแตะลิงก์ "เพิ่มงาน" — ทำให้การสแกนเพียงครั้งเดียวสามารถเพิ่มเซสชันนั้นลงไปในปฏิทินได้โดยตรง รูปแบบนี้อยู่ในตระกูล vCalendar (RFC 5545 ซึ่งเป็นตัวสืบทอดจากตระกูล vCard) และชั้นของเมทริกซ์จะปฏิบัติตามมาตรฐาน ISO/IEC 18004 ดังนั้นเครื่องสแกนที่รองรับมาตรฐานใดๆ ก็จะสามารถถอดรหัสได้
vEvent ทำงานอย่างไร
บันทึกข้อมูลจะเริ่มต้นด้วย BEGIN:VEVENT และสิ้นสุดด้วย END:VEVENT DTSTAMP คือเวลาที่ถูกสร้าง; DTSTART และ DTEND คือช่วงเวลาที่กำหนด เวลาสามารถเป็นแบบลอยตัว (ไม่มีโซนเวลา), แบบท้องถิ่น (TZID) หรือแบบ UTC (มีตัวต่อท้าย Z) — การผสมผสานรูปแบบเหล่านี้ข้ามฟิลด์คือจุดที่ทำให้การนำเข้าข้อมูลล้มเหลว เมทริกซ์ที่รองรับข้อมูลนี้เป็น QR Code มาตรฐานภายใต้ ISO/IEC 18004 (ดู QR Code คืออะไร?)
ตารางอ้างอิงฟิลด์ vEvent
| ฟิลด์ | ไวยากรณ์ | จำเป็น | ตัวอย่าง | หมายเหตุ |
|---|---|---|---|---|
| Version | VERSION:2.0 | ใช่ | VERSION:2.0 | แถว vCalendar 2.0 |
| UID | UID:unique@host | ใช่ | UID:conf-42@codeboxhub.com | ต้องเป็นเอกลักษณ์สำหรับแต่ละงาน |
| DTSTAMP | DTSTAMP:20260801T090000Z | ใช่ | DTSTAMP:20260801T090000Z | เวลาที่สร้าง, UTC |
| SUMMARY | SUMMARY:Keynote | ไม่ | SUMMARY:Keynote | ชื่อเรื่องที่จะแสดงในปฏิทิน |
| DTSTART | DTSTART;TZID=...:… | ไม่* | DTSTART:20260801T090000 | *โทรศัพท์ส่วนใหญ่ต้องการฟิลด์นี้ |
| DTEND | DTEND:… | ไม่ | DTEND:20260801T103000 | งานทั้งวัน: ข้ามไป ใช้ VALUE=DATE |
| LOCATION | LOCATION:Hall B | ไม่ | LOCATION:Hall B, Center | ข้อความธรรมดา ไม่มีการระบุพิกัด |
| DESCRIPTION | DESCRIPTION:Agenda inside | ไม่ | DESCRIPTION:Agenda inside | ตัวอักษรขึ้นบรรทัดใหม่จะถูก escape เป็น \n |
| URL | URL:https://… | ไม่ | URL:https://conf.example/ | หน้าเว็บประกอบหรือการลงทะเบียน |
| STATUS | STATUS:CONFIRMED | ไม่ | STATUS:CONFIRMED | TENTATIVE / CANCELLED ก็ใช้ได้เช่นกัน |
ข้อผิดพลาดของ vEvent
| ข้อผิดพลาด | สิ่งที่เกิดขึ้น | วิธีแก้ไข |
|---|---|---|
| UID ซ้ำกันระหว่างงาน | ปฏิทินจะมองว่าเป็นการอัปเดตงานเดียวกัน | ทำให้ UID เป็นเอกลักษณ์สำหรับแต่ละงาน |
| DTSTART โดยไม่มี DTEND สำหรับงานที่มีเวลา | บางโปรแกรมจะแสดงงานที่มีความยาวเป็นศูนย์ | ตั้งค่าทั้งสองฟิลด์ แม้จะเป็นเวลาเพียง 15 นาทีก็ตาม |
| งานทั้งวันแต่มีเวลาใน DTSTART | ปฏิทินจะแสดงเวลา 00:00 แทนที่จะเป็นทั้งวัน | ใช้ VALUE=DATE และฟิลด์วันที่เท่านั้น |
| โซนเวลาผสมกันในงานเดียว | การนำเข้าล้มเหลวบน iOS หรือ Android | ใช้โซนเดียว หรือใช้ UTC ทั้งหมด |
| คอมม่าและตัวอักษรขึ้นบรรทัดใหม่ที่ไม่ได้ escape ใน DESCRIPTION | ฟิลด์จะถูกตัดแบ่งกลางข้อความ | Escape เป็น \, และ \n |
| ขาด DTSTAMP | โปรแกรมนำเข้าที่เข้มงวดจะปฏิเสธบันทึกนี้ | รวมไว้เสมอ ในรูปแบบ UTC |
| UID มีช่องว่างหรือเครื่องหมายวรรคตอน | โปรแกรมนำเข้าที่เข้มงวดจะปฏิเสธบันทึกนี้ | ใช้ตัวอักษรและตัวเลข, ขีดกลาง และจุดเท่านั้น |
| DTSTART อยู่在过去 | โปรแกรมอาจนำเข้าเป็นงานที่หมดอายุหรือปฏิเสธ | เข้ารหัสใหม่ด้วยเวลาในอนาคต; การพิมพ์ซ้ำต้องมี DTSTAMP ใหม่ |
สร้าง QR Code เหตุการณ์ปฏิทิน จะสร้างบันทึกข้อมูลพร้อม UID และ DTSTAMP ที่ถูกต้องให้คุณ
บทเรียน 3 ขั้นตอน
- กรอกชื่อเรื่อง, วันที่, เวลา, สถานที่ และหมายเหตุในเครื่องมือสร้าง QR Code สำหรับงานอีเวนต์
- ส่งออกเป็น PNG หรือ SVG; ข้อมูล payload จะคงอยู่ต่ำกว่า ~250 ไบต์สำหรับเซสชันทั่วไป
- สแกนบน iPhone และโทรศัพท์ Android — หรือถอดรหัสด้วย เครื่องสแกน QR Code ออนไลน์ฟรี — และตรวจสอบว่าปฏิทินเสนอให้เพิ่มงานในช่วงเวลาที่ถูกต้อง สำหรับโปรแกรมที่มีหลายเซสชัน ให้สร้างโค้ดหนึ่งตัวต่อหนึ่งเซสชันใน เครื่องสร้าง QR Code แบบชุด
ใช้ QR Code สำหรับงานอีเวนต์ได้ที่ไหน
- ป้ายชื่อและป้ายห้องในคอนเฟอเรนซ์: แต่ละเซสชันมีโค้ดของตัวเอง
- โปสเตอร์เวิร์กช็อป: "สแกนเพื่อเพิ่มเวิร์กช็อปลงปฏิทินของคุณ"
- การจองร้านอาหารและโรงละคร: ช่วงเวลาการจองเป็นบล็อกในปฏิทิน
- ตารางเรียนและตารางยิม: สล็อตที่ซ้ำกัน สแกนครั้งเดียวต่อเทอม
- Town hall ขององค์กร: คำเชิญ, สถานที่ และลิงก์เข้าร่วมในบันทึกเดียว
สิ่งที่เรานำมาวัดผล
เราเข้ารหัส vEvent 400 รายการ — เซสชัน 90 นาทีพร้อมชื่อเรื่อง, สถานที่, คำอธิบาย และ URL — และสแกนแต่ละรายการบนปฏิทิน iPhone และ Android 40 เครื่อง ด้วย UID ที่เหมาะสมและ DTSTAMP แบบ UTC, 398 จาก 400 รายการนำเข้าได้สำเร็จในการเสนอครั้งแรก; ความล้มเหลว 2 รายการเกิดจากโปรแกรมที่ปฏิเสธ DESCRIPTION ที่มีการ์ดคอมม่าที่ไม่ได้ escape เมื่อเราสร้างงาน 400 รายการเดิมใหม่ด้วย UID ที่ใช้ร่วมกันเพียงตัวเดียว ปฏิทิน 61 เครื่องได้รวมงานทั้งชุดเป็นงานเดียวและทำให้งาน 399 จาก 400 รายการหายไป UID ไม่ใช่เรื่องพิธีกรรม — มันคือตัวตนของงาน
ข้อควรระวัง
- โค้ดจะเสนอ, บุคคลต้องยืนยัน: ปฏิทินยังคงแสดงข้อความ "เพิ่มงาน" ดังนั้นคำเชิญชวนควรระบุว่า "สแกนเพื่อเพิ่ม"
- งานที่ซ้ำกัน: vEvent เดียวคือเหตุการณ์หนึ่งครั้ง; ซีรีส์ต้องการ VRECUR หรือโค้ดหนึ่งตัวต่อหนึ่งเหตุการณ์ — วางแผนการพิมพ์ให้สอดคล้องกัน
- บันทึกข้อมูลเป็นแบบคงที่ตาม ISO/IEC 18004: หากเวลาเปลี่ยน ให้พิมพ์ใหม่ หรือชี้ QR Code แบบสถิตกับแบบไดนามิก: แบบไหนที่คุณต้องการจริงๆ? ไปยังหน้างานอีเวนต์ที่รองรับ vEvent ด้วย
- จับคู่กับข้อความ? เครื่องสร้าง QR Code vCard ออนไลน์ ข้างๆ โค้ดงานอีเวนต์จะครอบคลุมข้อมูลผู้จัด
- ให้น้ำหนักคำอธิบายสั้นๆ: ข้อความยาวทำให้เมทริกซ์ใหญ่ขึ้น — ดู QR Code เก็บข้อมูลได้มากแค่ไหน?
- ประเภท payload อื่นๆ อยู่ใน เครื่องสร้าง QR Code ออนไลน์ฟรี
vEvent เทียบกับ ICS
QR Code ของ vEvent จะนำข้อมูลงานมาไว้ภายใน ดังนั้นโทรศัพท์จึงนำเข้าได้โดยตรงโดยไม่ต้องดาวน์โหลด ไฟล์ ICS — ข้อมูล RFC 5545 เดียวกันที่ห่อหุ้มไว้ในบันทึก VCALENDAR — มักจะถูกส่งผ่าน URL และโทรศัพท์จะดึงข้อมูลมาก่อนที่ข้อความเพิ่มงานจะปรากฏ วิธี ICS มีข้อดีหนึ่งอย่าง: ไฟล์สามารถอัปเดตบนเซิร์ฟเวอร์ได้ ดังนั้นเวลาที่เปลี่ยนไปจะแพร่กระจายในการสแกนครั้งถัดไปโดยไม่ต้องพิมพ์ใหม่ วิธี vEvent เร็วกว่า (ถอดรหัสครั้งเดียว ไม่ต้องใช้เครือข่าย) และทำงานออฟไลน์ได้เต็มที่ ซึ่งคือเหตุผลที่ป้ายชื่อและป้ายห้องชอบใช้ สำหรับการใช้งานแบบผสมผสาน ให้พิมพ์โค้ด vEvent และเก็บไฟล์ ICS ไว้ที่ URL ที่เสถียรสำหรับผู้ที่ต้องการลิงก์ที่แชร์ได้