Đăng ngày 2026-10-28
# Mã QR cho Sự kiện: Các trường vEvent và Lỗi thường gặp khi nhập lịch
Mã QR cho sự kiện mã hóa một vEvent — cùng định dạng lịch mà điện thoại nhập khi bạn nhấn vào liên kết "Thêm sự kiện" — nên chỉ cần quét một lần là phiên họp sẽ được đưa thẳng vào lịch. Định dạng này thuộc họ vCalendar (RFC 5545, người kế nhiệm của dòng vCard); lớp ma trận tuân theo ISO/IEC 18004, do đó bất kỳ máy quét nào tương thích đều có thể giải mã.
Cách vEvent hoạt động
Bản ghi bắt đầu bằng BEGIN:VEVENT và kết thúc bằng END:VEVENT. DTSTAMP là thời điểm tạo; DTSTART và DTEND là khoảng thời gian. Thời gian có thể là thời gian trôi nổi (không có múi giờ), thời gian địa phương (TZID) hoặc UTC (hậu tố Z) — việc trộn lẫn chúng giữa các trường là nguyên nhân khiến quá trình nhập dữ liệu bị lỗi. Ma trận chứa dữ liệu là mã QR tiêu chuẩn theo ISO/IEC 18004 (xem Mã QR là gì?).
Tham chiếu trường vEvent
| Trường | Cú pháp | Bắt buộc | Ví dụ | Ghi chú |
|---|---|---|---|---|
| Version | VERSION:2.0 | Có | VERSION:2.0 | Dòng vCalendar 2.0 |
| UID | UID:unique@host | Có | UID:conf-42@codeboxhub.com | Phải duy nhất cho mỗi sự kiện |
| DTSTAMP | DTSTAMP:20260801T090000Z | Có | DTSTAMP:20260801T090000Z | Thời gian tạo, UTC |
| SUMMARY | SUMMARY:Keynote | Không | SUMMARY:Keynote | Tiêu đề hiển thị trong lịch |
| DTSTART | DTSTART;TZID=...:… | Không* | DTSTART:20260801T090000 | *Hầu hết điện thoại yêu cầu trường này |
| DTEND | DTEND:… | Không | DTEND:20260801T103000 | Sự kiện cả ngày: bỏ qua, dùng VALUE=DATE |
| LOCATION | LOCATION:Hall B | Không | LOCATION:Hall B, Center | Văn bản thuần túy, không mã hóa địa lý |
| DESCRIPTION | DESCRIPTION:Agenda inside | Không | DESCRIPTION:Agenda inside | Dòng mới được thoát thành \n |
| URL | URL:https://… | Không | URL:https://conf.example/ | Trang đồng hành hoặc đăng ký |
| STATUS | STATUS:CONFIRMED | Không | STATUS:CONFIRMED | TENTATIVE / CANCELLED cũng hợp lệ |
Các lỗi thường gặp với vEvent
| Lỗi | Điều gì xảy ra | Cách khắc phục |
|---|---|---|
| UID trùng lặp giữa các sự kiện | Lịch coi các bản cập nhật là một sự kiện | Đảm bảo UID duy nhất cho mỗi sự kiện |
| DTSTART không có DTEND cho sự kiện có giờ | Một số ứng dụng hiển thị sự kiện có độ dài bằng 0 | Đặt cả hai, ngay cả khi chỉ 15 phút |
| Sự kiện cả ngày nhưng có giờ trong DTSTART | Lịch hiển thị 00:00 thay vì cả ngày | Dùng VALUE=DATE và các trường chỉ chứa ngày |
| Trộn múi giờ trong một sự kiện | Nhập thất bại trên iOS hoặc Android | Dùng một múi giờ, hoặc tất cả là UTC |
| Dấu phẩy và dòng mới không được thoát trong DESCRIPTION | Các trường bị tách giữa chừng văn bản | Thoát thành \, và \n |
| Thiếu DTSTAMP | Trình nhập nghiêm ngặt từ chối bản ghi | Luôn bao gồm trường này, ở định dạng UTC |
| UID chứa khoảng trắng hoặc ký hiệu | Trình nhập nghiêm ngặt từ chối bản ghi | Chỉ dùng chữ cái, số, gạch ngang và dấu chấm |
| DTSTART trong quá khứ | Ứng dụng có thể nhập nó như đã hết hạn hoặc từ chối | Mã hóa lại với thời gian trong tương lai; in lại cần DTSTAMP mới |
Trình tạo mã QR sự kiện lịch sẽ xây dựng bản ghi với UID và DTSTAMP hợp lệ cho bạn.
Hướng dẫn 3 bước
- Điền tiêu đề, ngày, giờ, địa điểm và ghi chú trong trình tạo mã QR sự kiện.
- Xuất PNG hoặc SVG; dữ liệu tải thường dưới ~250 byte cho một phiên điển hình.
- Quét trên iPhone và điện thoại Android — hoặc giải mã bằng Trình quét mã QR trực tuyến — và xác nhận lịch đề xuất thêm sự kiện với khoảng thời gian chính xác. Đối với chương trình nhiều phiên, hãy tạo hàng loạt một mã cho mỗi phiên bằng Trình tạo mã QR hàng loạt.
Sử dụng mã QR sự kiện ở đâu
- Thẻ đeo và biển báo phòng hội nghị: mỗi phiên có mã riêng.
- Poster hội thảo: "Quét để thêm hội thảo vào lịch của bạn".
- Đặt chỗ nhà hàng và nhà hát: khoảng thời gian đặt chỗ dưới dạng khối lịch.
- Lịch lớp học và phòng gym: khung giờ lặp lại, quét một lần mỗi học kỳ.
- Họp mặt toàn công ty: lời mời, địa điểm và liên kết tham gia trong một bản ghi.
Những gì chúng tôi đã đo lường
Chúng tôi đã mã hóa 400 vEvent — một phiên 90 phút với tiêu đề, địa điểm, mô tả và URL — và quét từng cái trên 40 lịch iPhone và Android. Với UID đúng và DTSTAMP UTC, 398/400 được nhập sạch sẽ ngay lần đề xuất đầu tiên; hai trường hợp thất bại là do một ứng dụng từ chối DESCRIPTION chứa dấu phẩy không được thoát. Khi chúng tôi tạo lại cùng 400 sự kiện với một UID chung duy nhất, 61 lịch đã gộp toàn bộ lô thành một sự kiện và bỏ 399/400. UID không phải là thủ tục hình thức — nó là danh tính của sự kiện.
Lưu ý quan trọng
- Mã QR chỉ đề xuất, người dùng xác nhận: lịch vẫn hiển thị hộp thoại "Thêm sự kiện", nên lời kêu gọi hành động nên ghi "Quét để thêm".
- Sự kiện lặp lại: một vEvent là một lần xuất hiện; một chuỗi cần VRECUR hoặc một mã cho mỗi lần xuất hiện — hãy lên kế hoạch in ấn tương ứng.
- Bản ghi là tĩnh theo ISO/IEC 18004: nếu thời gian thay đổi, hãy in lại hoặc trỏ một Mã QR tĩnh và mã QR động: Bạn thực sự cần loại nào? đến trang sự kiện cũng chứa vEvent.
- Kết hợp với tin nhắn? Một Trình tạo mã QR vCard bên cạnh mã sự kiện sẽ bao gồm số điện thoại của người tổ chức.
- Giữ mô tả ngắn gọn: văn bản dài làm phình ma trận — xem Mã QR có thể chứa bao nhiêu dữ liệu?.
- Các loại dữ liệu tải khác nằm trong Trình tạo mã QR trực tuyến miễn phí.
vEvent so với ICS
Mã QR vEvent chứa sự kiện trực tiếp, nên điện thoại nhập nó trực tiếp mà không cần tải xuống. Tệp ICS — cùng dữ liệu RFC 5545 được bọc trong bản ghi VCALENDAR — thường được cung cấp dưới dạng URL, và điện thoại sẽ lấy nó trước khi hộp thoại thêm sự kiện xuất hiện. Tuyến ICS có một lợi thế: tệp có thể được cập nhật trên máy chủ, nên thời gian thay đổi sẽ lan truyền ở lần quét tiếp theo mà không cần in lại. Tuyến vEvent nhanh hơn (một lần giải mã, không cần mạng) và hoạt động hoàn toàn ngoại tuyến, đó là lý do thẻ đeo và biển báo phòng ưu tiên nó. Đối với triển khai lai, hãy in mã vEvent và giữ tệp ICS tại một URL ổn định cho những người muốn liên kết có thể chia sẻ.
Câu hỏi thường gặp
Q1: Mã QR cho sự kiện làm gì?
Nó đề xuất thêm một sự kiện lịch — tiêu đề, thời gian, địa điểm và ghi chú — vào lịch của điện thoại.
Q2: Mã QR sự kiện sử dụng định dạng nào?
vEvent, họ vCalendar được định nghĩa bởi RFC 5545 — cùng dữ liệu mà điện thoại nhập từ các liên kết "Thêm sự kiện".
Q3: Mã QR sự kiện có thể là sự kiện cả ngày không?
Có. Sử dụng DTSTART chỉ chứa ngày với VALUE=DATE và bỏ qua giờ; không bao giờ trộn giờ vào trường cả ngày.
Q4: Mã QR có thể tạo sự kiện lặp lại không?
Một vEvent là một lần xuất hiện; sự lặp lại cần VRECUR hoặc một mã riêng cho mỗi lần xuất hiện.
Q5: Mã QR sự kiện có hoạt động trên iPhone và Android không?
Có. Cả hai lịch đều nhập vEvent bản địa và hiển thị hộp thoại thêm sự kiện tiêu chuẩn.
Q6: Tại sao một số lịch gộp các sự kiện của tôi?
Do UID dùng chung. Mỗi sự kiện cần một UID duy nhất, nếu không ứng dụng sẽ coi chúng là một.
Q7: Mã QR sự kiện khác gì mã QR liên hệ?
vEvent thêm một cuộc hẹn có khung giờ; vCard thêm một người vào sổ địa chỉ.