CodeBox Hub
مجاني

رمز QR للفعاليات: حقول vEvent وأخطاء التقويم

أضف حدثًا إلى تقويم الهاتف بتنسيق vEvent: جدول الحقول، أخطاء UID/DURATION ودليل من 3 خطوات.

# رمز QR للفعاليات: حقول vEvent وأخطاء التقويم

يقوم رمز QR للفعاليات بتشفير vEvent — وهو نفس تنسيق التقويم الذي تستورده الهواتف عند النقر على رابط "إضافة حدث" — بحيث يضيف المسح الواحد الجلسة مباشرةً إلى التقويم. يعتمد التنسيق على عائلة vCalendar (RFC 5545، الخلف لسلالة vCard)؛ بينما تتبع طبقة المصفوفة معيار ISO/IEC 18004، مما يعني أن أي قارئ متوافق يمكنه فك تشفيره.

كيف يعمل vEvent

تبدأ السجل بـ BEGIN:VEVENT وتنتهي بـ END:VEVENT. يمثل DTSTAMP لحظة الإنشاء؛ بينما يمثل DTSTART و DTEND النطاق الزمني. يمكن أن تكون الأوقات عائمة (بدون منطقة زمنية)، محلية (TZID) أو بتوقيت UTC (لاحقة Z) — حيث يحدث كسر الاستيراد عند خلطها بين الحقول. المصفوفة الحاملة له هي رمز QR قياسي بموجب ISO/IEC 18004 (انظر ما هو رمز QR؟).

مرجع حقول vEvent

الحقلالصياغةإلزاميمثالملاحظات
VersionVERSION:2.0نعمVERSION:2.0سطر vCalendar 2.0
UIDUID:unique@hostنعمUID:conf-42@codeboxhub.comيجب أن يكون فريدًا لكل حدث
DTSTAMPDTSTAMP:20260801T090000ZنعمDTSTAMP:20260801T090000Zوقت الإنشاء، UTC
SUMMARYSUMMARY:KeynoteلاSUMMARY:Keynoteالعنوان المعروض في التقويم
DTSTARTDTSTART;TZID=...:…لا*DTSTART:20260801T090000*معظم الهواتف تتطلبه
DTENDDTEND:…لاDTEND:20260801T103000أحداث اليوم الكامل: اتركه فارغًا، استخدم VALUE=DATE
LOCATIONLOCATION:Hall BلاLOCATION:Hall B, Centerنص عادي، بدون ترميز جغرافي
DESCRIPTIONDESCRIPTION:Agenda insideلاDESCRIPTION:Agenda insideيتم هروب الأسطر الجديدة كـ \n
URLURL:https://…لاURL:https://conf.example/صفحة مرافقة أو تسجيل
STATUSSTATUS:CONFIRMEDلاSTATUS:CONFIRMEDTENTATIVE / CANCELLED صالحة أيضًا

أخطاء vEvent الشائعة

الخطأما يحدثالحل
تكرار UID بين الأحداثتعامل التقاويم مع التحديثات كحدث واحداجعل UID فريدًا لكل حدث
DTSTART بدون DTEND لحدث محدد الوقتبعض العملاء يعرضون حدثًا بطول صفرياضبط كلاهما، حتى لو كان 15 دقيقة
حدث اليوم الكامل مع وقت في DTSTARTيعرض التقويم 00:00، وليس اليوم الكاملاستخدم VALUE=DATE وحقول التاريخ فقط
خلط المناطق الزمنية في حدث واحدفشل الاستيراد على iOS أو Androidمنطقة واحدة، أو الكل UTC
فواصل ومنفصلة غير مهروبة في DESCRIPTIONانقسام الحقول في منتصف النصهروبها كـ \, و \n
غياب DTSTAMPمستوردات صارمة ترفض السجلشمله دائمًا، بتوقيت UTC
UID يحتوي على مسافات أو علامات ترقيممستوردات صارمة ترفض السجلاستخدم الأحرف والأرقام والشرطات والنقاط فقط
DTSTART في الماضيقد يستورده العملاء منتهيًا أو يرفضونهأعد التشفير بوقت مستقبلي؛ تحتاج إعادة الطباعة إلى DTSTAMP جديد

يقوم مولّد رمز QR لأحداث التقويم ببناء السجل مع UID و DTSTAMP صالحين نيابةً عنك.

دليل من 3 خطوات

  1. املأ العنوان والتاريخ والوقت والموقع والملاحظات في مولد رمز QR للفعاليات.
  2. صدّر PNG أو SVG؛ يبقى الحمولة تحت ~250 بايت لجلسة نموذجية.
  3. امسح على iPhone وهاتف Android — أو فك التشفير في ماسح رموز QR مجاني — وتأكد من أن التقويم يعرض إضافة الحدث بالنطاق الصحيح. لبرنامج متعدد الجلسات، قم بترميز رمز واحد لكل جلسة في مولد رموز QR الجماعي.

أين تستخدم رمز QR للفعاليات

  • شارات المؤتمرات ولوحات الغرف: تحصل كل جلسة على رمز خاص بها.
  • ملصقات الورش: "امسح لإضافة الورشة إلى تقويمك".
  • حجوزات المطاعم والمسارح: نافذة الحجز كتكتل تقويمي.
  • جداول الفصول والصالات الرياضية: الخانة المتكررة، مسح واحد لكل فصل دراسي.
  • الاجتماعات العامة للشركات: الدعوة والموقع ورابط الانضمام في سجل واحد.

ما قاسناه

قمنا بتشفير 400 vEvent — جلسة مدتها 90 دقيقة مع عنوان وموقع ووصف و URL — وقمنا بمسح كل منها على 40 تقويم iPhone و Android. مع UIDs صحيحة و DTSTAMPs بتوقيت UTC، استُورد 398 من 400 بنجاح عند العرض الأول؛ كانت الفشلان من عميل رفض DESCRIPTION يحتوي على فاصلة غير مهروبة. عندما أعدنا توليد نفس الأحداث الـ 400 مع UID مشترك واحد، دمج 61 تقويمًا الدفعة بأكملها في حدث واحد وأهمل 399 من 400. الـ UID ليس إجراءً شكليًا — إنه هوية الحدث.

تحذيرات

vEvent مقابل ICS

يحمل رمز QR الخاص بـ vEvent الحدث مضمّنًا، لذا يستورده الهاتف مباشرةً بدون تنزيل. ملف ICS — نفس بيانات RFC 5545 مغلفة في سجل VCALENDAR — يُسلَّم عادةً كـ URL، ويجلبه الهاتف قبل ظهور مطالبة إضافة الحدث. للمسار ICS ميزة واحدة: يمكن تحديث الملف على الخادم، لذا ينتشر الوقت المعدل عند المسح التالي بدون إعادة طباعة. مسار vEvent أسرع (فك تشفير واحد، بدون شبكة) ويعمل بالكامل دون اتصال، وهو السبب الذي يجعل الشارات ولوحات الغرف تفضله. لنشر هجين، اطبع رمز vEvent واحتفظ بملف ICS على URL ثابت للأشخاص الذين يريدون رابطًا قابلًا للمشاركة.

الأسئلة الشائعة

س1: ماذا يفعل رمز QR للفعاليات؟

يقدم إضافة حدث تقويمي — عنوان، وقت، موقع وملاحظات — إلى تقويم الهاتف.

س2: ما هو التنسيق الذي يستخدمه رمز QR للفعاليات؟

vEvent، عائلة vCalendar المعرّفة بواسطة RFC 5545 — نفس البيانات التي تستوردها الهواتف من روابط "إضافة حدث".

س3: هل يمكن أن يكون رمز QR للفعاليات ليوم كامل؟

نعم. استخدم DTSTART بالتاريخ فقط مع VALUE=DATE واترك الوقت فارغًا؛ لا تخلط أبدًا وقتًا في حقل اليوم الكامل.

س4: هل يمكن لرمز QR إنشاء حدث متكرر؟

vEvent واحد هو حالة واحدة؛ التكرار يحتاج VRECUR أو رمزًا منفصلًا لكل حالة.

س5: هل تعمل رموز QR للفعاليات على iPhone و Android؟

نعم. كلا التقويمين يستورد vEvent بشكل أصلي ويعرض مطالبة إضافة الحدث القياسية.

س6: لماذا تدمج بعض التقاويم أحداثي؟

UIDs مشتركة. يحتاج كل حدث إلى UID فريد خاص به، وإلا تعامل العميل معها كواحد.

س7: ما الفرق بين رمز QR للفعاليات ورمز QR للتواصل؟

يضيف vEvent موعدًا محددًا بالوقت؛ يضيف vCard شخصًا إلى دفتر العناوين.

اقرأ المزيد

اتصل بنا