CodeBox Hub
အခမဲ့

Event အတွက် QR Code: vEvent Fieldsနှင့် Calendar Pitfalls

vEvent format ဖြင့် ဖုန်းကယ်လင်ဒါသို့ ဖြစ်ရပ်ထည့်ပါ။ Field table, UID/DURATION အခက်အခဲများနှင့် 3-အဆင့် သင်ခန်းစာ။

# Event အတွက် QR Code: vEvent Fieldsနှင့် Calendar Pitfalls

Event အတွက် QR code သည် vEvent ကို encode လုပ်ပါသည်။ ဖုန်းများတွင် "Add event" link ကို နှိပ်သည့်အခါ import လုပ်သော calendar format နှင့် တူညီပါသည်။ ထို့ကြောင့် scan တစ်ကြိမ်ဖြင့် session ကို calendar သို့ တိုက်ရိုက်ထည့်သွင်းနိုင်ပါသည်။ Format သည် vCalendar family (RFC 5545, vCard lineage ၏ ဆက်ခံသူ) ဖြစ်ပြီး matrix layer သည် ISO/IEC 18004 ကို လိုက်နာသောကြောင့် compliant scanner များအားလုံး decode လုပ်နိုင်ပါသည်။

vEvent သည် မည်သို့ အလုပ်လုပ်သည်

Record သည် BEGIN:VEVENT ဖြင့် စတင်ပြီး END:VEVENT ဖြင့် ပြီးဆုံးပါသည်။ DTSTAMP သည် ဖန်တီးချိန်ဖြစ်ပြီး DTSTART နှင့် DTEND သည် ကာလဖြစ်ပါသည်။ အချိန်များသည် floating (zone မရှိ)၊ local (TZID) သို့မဟုတ် UTC (Z suffix) ဖြစ်နိုင်ပါသည် — fields များအကြား ဖြောင့်ဖျက်အသုံးပြုခြင်းသည် imports များ ပျက်စီးစေသော အချက်ဖြစ်ပါသည်။ ၎င်းကို သယ်ဆောင်သော matrix သည် ISO/IEC 18004 အောက်ရှိ standard QR code ဖြစ်ပါသည် (see QR Code ဆိုတာဘာလဲ?)။

vEvent Field ကိုးကား

အကွက်ပုံစံလိုအပ်မှုဥပမာမှတ်ချက်
VersionVERSION:2.0ဟုတ်ကဲ့VERSION:2.0vCalendar 2.0 ၏ line
UIDUID:unique@hostဟုတ်ကဲ့UID:conf-42@codeboxhub.comဖြစ်ရပ်တစ်ခုလျှင် unique ဖြစ်ရမည်
DTSTAMPDTSTAMP:20260801T090000Zဟုတ်ကဲ့DTSTAMP:20260801T090000Zဖန်တီးချိန်၊ UTC ဖြင့်
SUMMARYSUMMARY:KeynoteNoSUMMARY:Keynotecalendar တွင် ပြသသော ခေါင်းစဉ်
DTSTARTDTSTART;TZID=...:…No*DTSTART:20260801T090000*ဖုန်းအများစုက လိုအပ်သည်
DTENDDTEND:…NoDTEND:20260801T103000all-day events အတွက်: ဖယ်ရှားထားပြီး VALUE=DATE ကို အသုံးပြုပါ
LOCATIONLOCATION:Hall BNoLOCATION:Hall B, Centerplain text ဖြစ်ပြီး geocoding မပါ
DESCRIPTIONDESCRIPTION:Agenda insideNoDESCRIPTION:Agenda insidenewlines များကို \n အဖြစ် escape လုပ်ထားသည်
URLURL:https://…NoURL:https://conf.example/companion page သို့မဟုတ် registration
STATUSSTATUS:CONFIRMEDNoSTATUS:CONFIRMEDTENTATIVE / CANCELLED များလည်း valid ဖြစ်သည်

vEvent အလွဲများ

အလွဲဖြစ်ပေါ်လာသောအရာဖြေရှင်းနည်း
ဖြစ်ရပ်များအကြား UID ထပ်နေခြင်းcalendars များက updates များကို ဖြစ်ရပ်တစ်ခုတည်းအဖြစ် ကြည့်သည်ဖြစ်ရပ်တစ်ခုလျှင် UID ကို unique ဖြစ်အောင် လုပ်ပါ
timed event တစ်ခုတွင် DTEND မပါဘဲ DTSTART သာရှိခြင်းclient အချို့က zero-length event အဖြစ် ပြသသည်15 မိနစ်သာဖြစ်ဖြစ် နှစ်ခုလုံး ဆက်ပါ
all-day event တစ်ခုတွင် DTSTART မှာ အချိန်ပါနေခြင်းcalendar က 00:00 ဟု ပြပြီး all-day ဟု မပြသည်VALUE=DATE နှင့် date-only fields များကို အသုံးပြုပါ
ဖြစ်ရပ်တစ်ခုတည်းတွင် timezone များ ရောနှောခြင်းiOS သို့မဟုတ် Android တွင် import မအောင်မြင်ပါzone တစ်ခုတည်း သို့မဟုတ် အားလုံးကို UTC ဖြင့်
DESCRIPTION တွင် escape မလုပ်ထားသော commas နှင့် newlines များfields များသည် စာပေအလယ်တွင် ကွဲထွက်သည်\, နှင့် \n အဖြစ် escape လုပ်ပါ
DTSTAMP မရှိခြင်းstrict importers များက record ကို ငြင်းပယ်သည်UTC ဖြင့် အမြဲပါဝင်အောင် ထားပါ
spaces သို့မဟုတ် punctuation ပါသော UIDstrict importers များက record ကို ငြင်းပယ်သည်alphanumerics, hyphens နှင့် dots များသာ အသုံးပြုပါ
အတိတ်အချိန်ရှိသော DTSTARTclient များက ၎င်းကို expired အဖြစ် import လုပ်ခြင်း သို့မဟုတ် ငြင်းပယ်ခြင်း ဖြစ်နိုင်သည်future အချိန်ဖြင့် ပြန်လည် encode လုပ်ပါ; reprint များအတွက် DTSTAMP အသစ် လိုအပ်သည်

The အွန်လိုင်း ကယ်လင်ဒါ ဖြစ်စဉ် QR Code ဖန်တီးသူ သည် သင့်အတွက် valid UID နှင့် DTSTAMP ဖြင့် record ကို တည်ဆောက်ပေးပါသည်။

အဆင့် 3 လမ်းညွှန်ချက်

  1. Event QR generator တွင် ခေါင်းစဉ်၊ နေ့စွဲ၊ အချိန်၊ နေရာနှင့် မှတ်ချက်များကို ဖြည့်ပါ။
  2. PNG သို့မဟုတ် SVG ကို export လုပ်ပါ။ ပုံမှန် session တစ်ခုအတွက် payload သည် ~250 bytes အောက်တွင် ရှိနေပါမည်။
  3. iPhone နှင့် Android ဖုန်းများတွင် scan လုပ်ပါ — သို့မဟုတ် အခမဲ့ QR Code Scanner တွင် decode လုပ်ပါ — calendar ကမှ ဖြစ်ရပ်ကို မှန်ကန်သော ကာလဖြင့် ထည့်သွင်းရန် ကြားမေးကြောင်းကို အတည်ပြုပါ။ Multi-session program အတွက် အွန်လိုင်း Batch QR Code ဖန်တီးကိရိယာ တွင် session တစ်ခုလျှင် code တစ်ခုစီ batch လုပ်ပါ။

Event QR Code ကို မည်သည့်နေရာတွင် အသုံးပြုသနည်း

  • Conference badges နှင့် room signs: session တစ်ခုစီအတွက် code သီးသန့်ရှိပါမည်။
  • Workshop posters: "Scan to add the workshop to your calendar"။
  • Restaurant နှင့် theatre reservations: booking window ကို calendar block အဖြစ်။
  • Class နှင့် gym schedules: recurring slot, term တစ်ခုလျှင် scan တစ်ကြိမ်။
  • Corporate town halls: invite, location နှင့် join link တို့ကို record တစ်ခုတည်းတွင် ပါဝင်စေခြင်း။

ကျွန်ုပ်တို့ တိုင်းတာခဲ့သည့် အရာများ

vEvents 400 ခုကို encode လုပ်ခဲ့သည် — ခေါင်းစဉ်၊ နေရာ၊ ဖော်ပြချက်နှင့် URL ပါသော 90 မိနစ် session — နှင့် iPhone နှင့် Android calendars 40 ခုတွင် scan လုပ်ခဲ့သည်။ မှန်ကန်သော UIDs နှင့် UTC DTSTAMPs ဖြင့် 400 ခုထဲမှ 398 ခုသည် ပထမကြိမ် offer တွင် အောင်မြင်စွာ import ဖြစ်ခဲ့သည်။ အကျိုးအမြတ်မရရှိခဲ့သော 2 ခုသည် unescaped comma ပါဝင်သော DESCRIPTION ကို ငြင်းပယ်ခဲ့သော client တစ်ခုကြောင့် ဖြစ်ပါသည်။ တူညီသော 400 ဖြစ်ရပ်များကို shared UID တစ်ခုတည်းဖြင့် ပြန်လည် generate လုပ်သောအခါ calendars 61 ခုသည် batch အားလုံးကို ဖြစ်ရပ်တစ်ခုတည်းအဖြစ် ပေါင်းစပ်ပြီး 400 ခုထဲမှ 399 ခုကို ဖယ်ရှားခဲ့သည်။ UID သည် formalities မဟုတ်ပါ — ၎င်းသည် ဖြစ်ရပ်၏ identity ဖြစ်ပါသည်။

အလွဲများ

vEvent နှင့် ICS နှိုင်းယှဉ်ချက်

vEvent QR သည် ဖြစ်ရပ်ကို inline ဖြင့် သယ်ဆောင်သောကြောင့် download မလိုဘဲ ဖုန်းက တိုက်ရိုက် import လုပ်နိုင်ပါသည်။ ICS file — VCALENDAR record ဖြင့် wrap လုပ်ထားသော RFC 5545 data တူညီသော — သည် ပုံမှန်အားဖြင့် URL အဖြစ် ပေးပို့ပြီး add-event prompt ပေါ်လာမည့်အချိန်အထိ ဖုန်းက fetch လုပ်ပါသည်။ ICS route တွင် အားသာချက်တစ်ခုရှိသည်: server တွင် file ကို update လုပ်နိုင်သောကြောင့် reprint မလုပ်ဘဲ အချိန်ပြောင်းလဲမှုသည် scan နောက်တစ်ကြိမ်တွင် ပျံ့နှံ့သွားပါသည်။ vEvent route သည် ပိုမိုမြန်ဆန်ပါသည် (decode တစ်ကြိမ်သာ၊ network မလို) နှင့် offline တွင် လုံးဝလုပ်ဆောင်နိုင်သောကြောင့် badges နှင့် room signs များက ၎င်းကို နှစ်သက်ပါသည်။ Hybrid deployment အတွက် vEvent code ကို print လုပ်ပြီး shareable link လိုချင်သူများအတွက် ICS file ကို stable URL တစ်ခုတွင် ထားရှိပါ။

FAQ

Event အတွက် QR code သည် အဘယ်ကို လုပ်ဆောင်သနည်း?

ဖုန်း၏ calendar သို့ ဖြစ်ရပ်တစ်ခု (ခေါင်းစဉ်၊ အချိန်၊ နေရာနှင့် မှတ်ချက်များ) ကို ထည့်သွင်းရန် ကြားမေးပါသည်။

Event QR code သည် ဖောแมတ်ဘယ်လုံးကို အသုံးပြုသနည်း?

vEvent, RFC 5545 ဖြင့် သတ်မှတ်ထားသော vCalendar family — "Add event" links များမှ ဖုန်းများ import လုပ်သော data တူညီပါသည်။

Event QR code သည် all-day ဖြစ်နိုင်ပါသလား?

ရပါသည်။ VALUE=DATE ဖြင့် date-only DTSTART ကို အသုံးပြုပြီး အချိန်ကို ဖယ်ရှားပါ; all-day field တွင် အချိန်ကို မဖျောင့်ဖျက်အသုံးပြုပါနှင့်။

QR code က recurring event ကို ဖန်တီးနိုင်ပါသလား?

vEvent တစ်ခုတည်းသည် occurrence တစ်ခုတည်းသာ ဖြစ်သည်; recurrence အတွက် VRECUR သို့မဟုတ် occurrence တစ်ခုလျှင် code သီးသန့် လိုအပ်ပါသည်။

Event QR codes များသည် iPhone နှင့် Android တွင် အလုပ်လုပ်ပါသလား?

ရပါသည်။ Calendar နှစ်မျိုးလုံးသည် vEvent ကို native အဖြစ် import လုပ်ပြီး standard add-event prompt ကို ပြသပါသည်။

calendar အချို့က ဖြစ်ရပ်များကို မည်သို့ ပေါင်းစပ်ကြသနည်း?

Shared UIDs ကြောင့် ဖြစ်သည်။ ဖြစ်ရပ်တစ်ခုစီအတွက် unique UID သီးသန့် လိုအပ်သည်၊ မဟုတ်ပါက client များက ၎င်းတို့ကို တစ်ခုတည်းအဖြစ် ကြည့်ရှုပါမည်။

Event QR သည် contact QR နှင့် မည်သို့ ကွဲပြားသနည်း?

vEvent သည် အချိန်ကာလရှိသော appointment တစ်ခုကို ထည့်သွင်းပေးသည်; vCard သည် address book သို့ လူတစ်ဦးကို ထည့်သွင်းပေးသည်။

ဆက်လက်ဖတ်ရှုရန်

ကျွန်ုပ်တို့ကို ဆက်သွယ်ရန်