نُشر في 2026-10-28
# رمز 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
| الحقل | الصياغة | إلزامي | مثال | ملاحظات |
|---|---|---|---|---|
| Version | VERSION:2.0 | نعم | VERSION:2.0 | سطر vCalendar 2.0 |
| UID | UID:unique@host | نعم | UID:conf-42@codeboxhub.com | يجب أن يكون فريدًا لكل حدث |
| DTSTAMP | DTSTAMP:20260801T090000Z | نعم | DTSTAMP:20260801T090000Z | وقت الإنشاء، UTC |
| SUMMARY | SUMMARY:Keynote | لا | SUMMARY:Keynote | العنوان المعروض في التقويم |
| DTSTART | DTSTART;TZID=...:… | لا* | DTSTART:20260801T090000 | *معظم الهواتف تتطلبه |
| DTEND | DTEND:… | لا | DTEND:20260801T103000 | أحداث اليوم الكامل: اتركه فارغًا، استخدم VALUE=DATE |
| LOCATION | LOCATION:Hall B | لا | LOCATION:Hall B, Center | نص عادي، بدون ترميز جغرافي |
| DESCRIPTION | DESCRIPTION:Agenda inside | لا | DESCRIPTION:Agenda inside | يتم هروب الأسطر الجديدة كـ \n |
| URL | URL:https://… | لا | URL:https://conf.example/ | صفحة مرافقة أو تسجيل |
| STATUS | STATUS:CONFIRMED | لا | STATUS:CONFIRMED | TENTATIVE / 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 خطوات
- املأ العنوان والتاريخ والوقت والموقع والملاحظات في مولد رمز QR للفعاليات.
- صدّر PNG أو SVG؛ يبقى الحمولة تحت ~250 بايت لجلسة نموذجية.
- امسح على 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 واحد هو حالة واحدة؛ السلسلة تحتاج VRECUR أو رمزًا لكل حالة — خطط لطباعة التشغيل وفقًا لذلك.
- السجل ثابت بموجب ISO/IEC 18004: إذا تغير الوقت، أعد الطباعة، أو وجّه رموز QR الثابتة مقابل الديناميكية: أيهما تحتاج حقاً؟ إلى صفحة حدث تحمل أيضًا vEvent.
- الاقتران مع رسالة؟ مولّد رمز QR لبطاقة الاتصال بجانب رمز الحدث يغطي خط المنظم.
- حافظ على الوصف قصيرًا: النثر الطويل ينفخ المصفوفة — انظر كم من البيانات يمكن لرمز QR أن يحتويه؟.
- أنواع الحمولة الأخرى موجودة في مولّد رموز QR المجاني.
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 شخصًا إلى دفتر العناوين.