ထုတ်ဝေသည့်ရက် 2026-10-27
# 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 ကိုးကား
| အကွက် | ပုံစံ | လိုအပ်မှု | ဥပမာ | မှတ်ချက် |
|---|---|---|---|---|
| Version | VERSION:2.0 | ဟုတ်ကဲ့ | VERSION:2.0 | vCalendar 2.0 ၏ line |
| UID | UID:unique@host | ဟုတ်ကဲ့ | UID:conf-42@codeboxhub.com | ဖြစ်ရပ်တစ်ခုလျှင် unique ဖြစ်ရမည် |
| DTSTAMP | DTSTAMP:20260801T090000Z | ဟုတ်ကဲ့ | DTSTAMP:20260801T090000Z | ဖန်တီးချိန်၊ UTC ဖြင့် |
| SUMMARY | SUMMARY:Keynote | No | SUMMARY:Keynote | calendar တွင် ပြသသော ခေါင်းစဉ် |
| DTSTART | DTSTART;TZID=...:… | No* | DTSTART:20260801T090000 | *ဖုန်းအများစုက လိုအပ်သည် |
| DTEND | DTEND:… | No | DTEND:20260801T103000 | all-day events အတွက်: ဖယ်ရှားထားပြီး VALUE=DATE ကို အသုံးပြုပါ |
| LOCATION | LOCATION:Hall B | No | LOCATION:Hall B, Center | plain text ဖြစ်ပြီး geocoding မပါ |
| DESCRIPTION | DESCRIPTION:Agenda inside | No | DESCRIPTION:Agenda inside | newlines များကို \n အဖြစ် escape လုပ်ထားသည် |
| URL | URL:https://… | No | URL:https://conf.example/ | companion page သို့မဟုတ် registration |
| STATUS | STATUS:CONFIRMED | No | STATUS:CONFIRMED | TENTATIVE / 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 ပါသော UID | strict importers များက record ကို ငြင်းပယ်သည် | alphanumerics, hyphens နှင့် dots များသာ အသုံးပြုပါ |
| အတိတ်အချိန်ရှိသော DTSTART | client များက ၎င်းကို expired အဖြစ် import လုပ်ခြင်း သို့မဟုတ် ငြင်းပယ်ခြင်း ဖြစ်နိုင်သည် | future အချိန်ဖြင့် ပြန်လည် encode လုပ်ပါ; reprint များအတွက် DTSTAMP အသစ် လိုအပ်သည် |
The အွန်လိုင်း ကယ်လင်ဒါ ဖြစ်စဉ် QR Code ဖန်တီးသူ သည် သင့်အတွက် valid UID နှင့် DTSTAMP ဖြင့် record ကို တည်ဆောက်ပေးပါသည်။
အဆင့် 3 လမ်းညွှန်ချက်
- Event QR generator တွင် ခေါင်းစဉ်၊ နေ့စွဲ၊ အချိန်၊ နေရာနှင့် မှတ်ချက်များကို ဖြည့်ပါ။
- PNG သို့မဟုတ် SVG ကို export လုပ်ပါ။ ပုံမှန် session တစ်ခုအတွက် payload သည် ~250 bytes အောက်တွင် ရှိနေပါမည်။
- 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 ဖြစ်ပါသည်။
အလွဲများ
- Code က ကြားမေးပြီး၊ လူက အတည်ပြုသည်: calendar တွင် "Add event" prompt ပြနေသေးသောကြောင့် call to action သည် "Scan to add" ဟု ပြောသင့်ပါသည်။
- Recurring events: vEvent တစ်ခုတည်းသည် occurrence တစ်ခုတည်းသာ ဖြစ်သည်; series အတွက် VRECUR သို့မဟုတ် occurrence တစ်ခုလျှင် code တစ်ခုစီ လိုအပ်သည် — print run ကို အလျောက် စီစဉ်ပါ။
- Record သည် ISO/IEC 18004 အရ static ဖြစ်သည်: အချိန်ပြောင်းလဲပါက reprint လုပ်ပါ၊ သို့မဟုတ် vEvent ပါသော event page သို့ Static vs Dynamic QR Code - လက်တွေ့ လိုအပ်သောအရာမှာ မည်သည်လဲ ကို ညွှန်ပြပါ။
- Message နှင့် pair လုပ်ရန်? Organizer ၏ line ကို ဖုံးလွှမ်းရန် event code ဘေးတွင် အွန်လိုင်း vCard QR Code ဖန်တီးစက် ကို ထားပါ။
- Description ကို တိုတောင်းစွာ ထားပါ: ရှည်လျားသော စာပေသည် matrix ကို ပိုမိုကြီးထွားစေသည် — see QR Code တစ်ခုတွင် အချက်အလက် မည်မျှသိမ်းဆည်းနိုင်သနည်း?။
- Payload types အခြားများသည် အခမဲ့ QR Code Generator တွင် ရှိပါသည်။
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 တစ်ခုတွင် ထားရှိပါ။