CodeBox Hub
MIỄN PHÍ

Mã QR cho Sự kiện: Các trường vEvent và Lỗi thường gặp khi nhập lịch

Thêm sự kiện vào lịch điện thoại với định dạng vEvent: bảng trường, các lỗi thường gặp về UID/DURATION và hướng dẫn 3 bước.

# 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ườngCú phápBắt buộcVí dụGhi chú
VersionVERSION:2.0CóVERSION:2.0Dòng vCalendar 2.0
UIDUID:unique@hostCóUID:conf-42@codeboxhub.comPhải duy nhất cho mỗi sự kiện
DTSTAMPDTSTAMP:20260801T090000ZCóDTSTAMP:20260801T090000ZThời gian tạo, UTC
SUMMARYSUMMARY:KeynoteKhôngSUMMARY:KeynoteTiêu đề hiển thị trong lịch
DTSTARTDTSTART;TZID=...:…Không*DTSTART:20260801T090000*Hầu hết điện thoại yêu cầu trường này
DTENDDTEND:…KhôngDTEND:20260801T103000Sự kiện cả ngày: bỏ qua, dùng VALUE=DATE
LOCATIONLOCATION:Hall BKhôngLOCATION:Hall B, CenterVăn bản thuần túy, không mã hóa địa lý
DESCRIPTIONDESCRIPTION:Agenda insideKhôngDESCRIPTION:Agenda insideDòng mới được thoát thành \n
URLURL:https://…KhôngURL:https://conf.example/Trang đồng hành hoặc đăng ký
STATUSSTATUS:CONFIRMEDKhôngSTATUS:CONFIRMEDTENTATIVE / CANCELLED cũng hợp lệ

Các lỗi thường gặp với vEvent

LỗiĐiều gì xảy raCách khắc phục
UID trùng lặp giữa các sự kiệnLị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 DTSTARTLịch hiển thị 00:00 thay vì cả ngàyDùng VALUE=DATE và các trường chỉ chứa ngày
Trộn múi giờ trong một sự kiệnNhập thất bại trên iOS hoặc AndroidDù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 DESCRIPTIONCác trường bị tách giữa chừng văn bảnThoát thành \, và \n
Thiếu DTSTAMPTrình nhập nghiêm ngặt từ chối bản ghiLuôn bao gồm trường này, ở định dạng UTC
UID chứa khoảng trắng hoặc ký hiệuTrình nhập nghiêm ngặt từ chối bản ghiChỉ 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ốiMã 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

  1. Điền tiêu đề, ngày, giờ, địa điểm và ghi chú trong trình tạo mã QR sự kiện.
  2. 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.
  3. 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ỉ.

Đọc tiếp

Liên hệ với chúng tôi