ما هو دليل البرامج الإلكتروني EPG بتنسيق XMLTV لقوائم IPTV العامة وكيفية ربطه

يعتقد العديد من المستخدمين الجدد في مجال البث التدفقي أن الحصول على قائمة تشغيل (ملف M3U) يعني اكتمال الإعداد بالكامل. ولكن بمجرد فتح هذه القائمة على جهاز التلفزيون أو تطبيق المشغل، تقتصر الواجهة غالباً على عمود فارغ من أسماء القنوات: لا يمكنك معرفة البرنامج المعروض حالياً، ولا موعد انتهاء الحلقة، ولا الاطلاع على جدول المساء. القائمة في هذه الحالة لا تتعدى كونها دليلاً بارداً لعناوين البث.

ولكي يمتلك برنامج التشغيل واجهة إرشادية تشبه التلفزيون التقليدي، يجب تزويده ببيانات EPG. نوضح في هذا المقال العلاقة التقنية بين EPG وXMLTV، ولماذا يُفصل جدول البرامج عن قوائم التشغيل في ملفات مستقلة، وكيف يتم الربط بينهما عبر الحقول التعريفية، وما هي الحدود العملية لاستخدام البيانات المتاحة على الإنترنت.

بدون جدول برامج، القائمة مجرد أسماء

إذا سبق لك الاطلاع على شرحنا حول تحليل بنية ملف M3U النصي، فستعلم أن ملف M3U القياسي يتولى مهمة واحدة أساسية: تسجيل روابط البث التدفقي والوسوم التوضيحية الخاصة بها.

وفي حال غياب دليل برامج مرافق، يكتفي المشغل بقراءة اسم القناة ورابط التشغيل فقط. والواجهة التي تظهر عبر جهاز التحكم تكون مجرد قائمة لتغيير القنوات. أما عند إدخال معلومات البرامج، يتمكن المشغل من رسم مخطط زمني متكامل: يمثل المحور الأفقي التوقيت، والمحور الرأسي القنوات، ويحتوي كل مربع على اسم البرنامج، ووقت البدء والانتهاء، ونبذة مختصرة عنه. وتُعرف هذه المنظومة البرمجية المخصصة لعرض جداول البث باسم EPG (Electronic Program Guide - دليل البرامج الإلكتروني).

ما هو EPG وما هو XMLTV؟

يمثل EPG اسم الميزة البرمجية العامة، بينما يُعد XMLTV التنسيق البياني المفتوح الأكثر استخداماً لتطبيق هذه الميزة.

يعتمد XMLTV على قواعد لغة XML، وقد صُمم في الأصل لتسهيل تبادل جداول البرامج التلفزيونية بين البرمجيات المفتوحة المصدر والأنظمة المختلفة. يتألف ملف XMLTV القياسي من قسمين رئيسيين من البيانات:

1. تعريف القناة (عقدة channel): للإعلان عن المعرف الفريد للقناة (id)، واسم العرض الظاهر (display-name)، ورابط شعار القناة (icon).
2. عنصر البرنامج (عقدة programme): لتسجيل تفاصيل مواعيد البث. ويتضمن كل عنصر معرف القناة التابع لها (channel)، ووقت البدء (start)، ووقت الانتهاء (stop)، وعنوان البرنامج (title)، إلى جانب نبذة اختيارية أو تصنيف للمحتوى.

تقوم تطبيقات IPTV الحديثة بمختلف أنواعها بتنزيل ملف XMLTV وتحليله عند الإقلاع، ثم تحويل الطوابع الزمنية لتتطابق مع المنطقة الزمنية المحلية للجهاز، وعرضها على شكل جدول بيانات شبكي واضح.

لماذا يتم الفصل في ملفين مستقلين؟

يطرح العديد من المبتدئين هذا السؤال: طالما أن معلومات القنوات وجدول البرامج مطلوبان معاً، فلماذا لا تُدمج الجداول مباشرة داخل قائمة التشغيل بدلاً من تقسيمهما إلى ملفي M3U وXMLTV منفصلين؟

يعود هذا القرار بالدرجة الأولى إلى الاختلاف الجذري في وتيرة التحديث وحجم البيانات بين الاثنين:

• اختلاف دورة الحياة: تكون عناوين تدفق القنوات التلفزيونية ثابتة نسبياً؛ وما لم تحدث أعمال صيانة للخوادم أو تغيير للمسارات، يمكن لقائمة التشغيل أن تعمل لأسابيع أو أشهر دون تعديل. بينما يتغير جدول البرامج باستمرار وبشكل يومي، مما يستلزم سحب بيانات جديدة كل بضعة أيام أو بصورة يومية.
• التباين الهائل في حجم البيانات: لا يتجاوز حجم ملف M3U الذي يحتوي على عشرات القنوات بضعة كيلوبايتات (KB). ولكن إذا أردت تضمين جدول دقيق ومفصل بالدقائق لمدة أسبوع كامل لهذه القنوات، فإن حجم ملف XMLTV الناتج بعد فك الضغط قد يصل إلى عشرات الميجابايتات (MB). وإعادة إرسال هذه البيانات الضخمة مع كل تبديل للقناة يستهلك حزم البيانات ويجعل معالجة القوائم بطيئة للغاية على أجهزة الاستقبال المحدودة الموارد.

وينطبق هذا المبدأ التقني على بيئة البيانات المفتوحة؛ إذ يقوم القائمون على جمع القنوات المفتوحة بتوثيق تدفقات الاختبار في دليل مستقل (يمكنك مراجعة دليل قنوات التلفزيون العامة)، بينما يتم تنظيم سحب وتنسيق بيانات الجداول العالمية في مشروع EPG منفصل تماماً.

كيفية الربط وأبرز أسباب عدم التطابق

تحدد قائمة التشغيل للمشغل «من أين يجلب بث الفيديو»، في حين يوضح دليل البرامج «ماذا يُعرض على القناة ومتى». والجسر الذي يربط بين الاثنين هو المعرف الفريد للقناة، والذي يظهر في وسوم M3U عادةً تحت اسم tvg-id.

يتجلى منطق المطابقة النموذجي كما يلي:

في ملف M3U، يحدد سطر البيانات الوصفية خصائص القناة:

#EXTINF:-1 tvg-id="CCTV1.cn" tvg-name="CCTV-1" tvg-logo="[原文](https://example.com/logo.png"),CCTV-1 综合
[原文](https://example.com/live/cctv1.m3u8)

وفي ملف XMLTV المقابل، يوجد التعريف المخصص لها:

<channel id="CCTV1.cn">
  <display-name>CCTV-1</display-name>
</channel>
<programme start="20260908120000 +0800" stop="20260908123000 +0800" channel="CCTV1.cn">
  <title lang="zh">新闻30分</title>
</programme>

يقوم المشغل بمطابقة قيمة tvg-id في M3U مع قيمة channel id في XMLTV، وبمجرد تطابق السلسلتين النصيتين تماماً، يتم ربط البرنامج «新闻30分» مباشرة بشريط تشغيل «CCTV-1 综合».

إذا استمر المشغل في عرض شاشة برامج فارغة بعد الإعداد، فإن ذلك يعود عادةً إلى الأسباب التالية:

1. اختلاف حالة الأحرف أو الرموز في tvg-id: كأن يُكتب في M3U المعرف tvg-id="cctv1" بينما يُعرف في XMLTV كـ channel id="CCTV1.cn". ورغم تشابه الاسمين ظاهرياً، إلا أن المطابقة الحرفية تفشل بسبب عدم التطابق الدقيق.
2. انحراف معالجة المنطقة الزمنية: تعتمد طوابع XMLTV على معايير تشمل إزاحة المنطقة الزمنية (مثل +0800). وإذا عجز المشغل عن تحويل الوقت إلى التوقيت المحلي للجهاز بدقة، فستظهر البرامج متقدمة أو متأخرة بعدة ساعات.
3. انتهاء صلاحية البيانات: تمتلك ملفات EPG العامة نافذة صلاحية محددة. فإذا توقف سكريبت جمع البيانات التلقائي وبقي الملف عند الأسبوع الماضي، فلن يعثر المشغل على برامج لتاريخ اليوم وستظل الشاشة فارغة رغم صحة المعرف.
4. أخطاء في بنية XML والترميز: تتطلب لغة XML انضباطاً صارماً في الكتابة؛ فوجود رمز خاص غير معالج برمجياً (مثل رمز & المنفرد) أو وسم غير مغلق يؤدي إلى فشل قراءة الملف بالكامل وتوقف عرض البرامج لبقية القنوات.

كيف تفحص وتدير جدول البرامج على موقعنا

لمساعدتك في تنظيم وفحص ملفاتك المحلية أو العامة، نوفر على موقعنا مجموعة من الأدوات الخفيفة:

• معاينة وفحص نصوص XMLTV: يمكنك الاعتماد على أداة /xmltv-checker/ لتحليل نصوص أو روابط XMLTV بسرعة، واستخراج قائمة معرفات القنوات ونطاق التواريخ، للتأكد من سلامة البنية وصلاحية الجدول.
• تنقيح وسوم القوائم: قبل تصدير القائمة إلى مشغلك، يُنصح باستخدام /m3u-playlist-editor/ لمطابقة tvg-id مع معرفات XMLTV بدقة وتفادي الأخطاء الإملائية، كما يمكنك فحص سلامة روابط التدفق عبر /hls-player/.
• توليد الاشتراكات ومزامنة الأجهزة: تتيح لك مساحة العمل في /playlist-sync/ إدارة قوائمك المعتمدة وإلحاق روابط EPG لتوليد Feed مجمع خاص باشتراكاتك.

تنبيه هام: يعمد بعض المستخدمين أثناء الفحص على أجهزة الكمبيوتر إلى لصق رابط Feed أو ملف .m3u مباشرة في شريط عنوان متصفح Chrome. متصفح Chrome هو متصفح ويب عادي، يتعامل مع الرابط إما بتنزيله كنص مجرد أو بمحاولة تشغيله كملف فيديو مباشر، ولا يقوم إطلاقاً بجلب بيانات EPG المرتبطة به وتحليلها كما تفعل تطبيقات IPTV. لذا، فإن فتح الرابط عبر المتصفح المكتبي لا يُعد اختباراً صالحاً لدليل البرامج، ويجب دائماً التحقق باستخدام مشغل متخصص يدعم XMLTV.

الحدود الواقعية للبيانات العامة

عند بناء بيئة المشاهدة الخاصة بك، من الضروري إدراك الحدود الطبيعية لبيانات EPG المفتوحة:

• طبيعة موقعنا: موقع m3u8-player.net هو منصة أدوات تقنية متخصصة، وأداة /xmltv-checker/ المتاحة فيه مخصصة لفحص البنية النصية فقط. الموقع ليس جهة بث تلفزيوني، ولا يقدم خدمات إعادة بث القنوات، ولا يبيع أي قنوات تلفزيونية.
• عدم استقرار المصادر المفتوحة: تعتمد بيانات EPG العامة المتداولة على الإنترنت على نصوص برمجية يطورها هواة لسحب الجداول من المواقع الرسمية. وتتعرض هذه المصادر لتوقف مؤقت، أو تغيير في التنسيق، أو غياب جداول بعض القنوات المتخصصة. ولا يقدم موقعنا أي ضمانات بتوفر دليل برامج كامل لكل قناة عامة على الإنترنت.

الخيار الأمثل للمستخدم هو الاعتماد على قائمة منتقاة ومختصرة: التحقق من صحة tvg-id للقنوات الأساسية عبر أدواتنا وربطها بمصدر EPG منتظم التحديث، بدلاً من إثقال أجهزة التشغيل بآلاف القنوات العامة المعطلة.

الخلاصة

تشبه العلاقة بين قائمة تشغيل IPTV ودليل البرامج العلاقة بين جهاز المذياع وجريدة مواعيد البث. تتولى القائمة مهمة توصيل الإشارة، بينما يقدم XMLTV خريطة المواعيد، ويمثل tvg-id حلقة الوصل بينهما. ومن خلال استيعاب آلية الربط بين هذين الملفين، يمكن حل معظم المشكلات الشائعة مثل الشاشات السوداء، أو غياب الشعارات، أو اختفاء مواعيد العرض.

إذا حصلت على ملف دليل برامج جديد أو تعذر على جهازك تحميل الجداول، يمكنك التوجه إلى أداة /xmltv-checker/ ولصق الرابط أو النص للتحقق من سلامة البيانات والمعرفات.

المصادر

• مستخدم Zhihu «易三福»: يتيح EPG للتطبيق عرض محتوى البث الحالي، ويعتمد تنسيق XMLTV ويتم الربط عبر tvg-id (原文)
• مستخدم Zhihu «x1ao4»: يلزم إعداد ملفي M3U وXMLTV معاً، وعدم تطابق المعرف يمنع عرض الشعار وجدول البرامج (原文)
• مستخدم Zhihu «怪侠说不说»: يتم تحديث مستودعات EPG ومستودعات قوائم التشغيل بشكل مستقل تماماً داخل بيئة iptv-org (原文)