شرح

رابط دليل القنوات (EPG): من أين تجده وكيف تضيفه

دليل البرامج، أو EPG، هو ما يضع «الآن» و«التالي» بجانب كل قناة، وهو ملف XMLTV له رابط خاص. هنا تعرف شكل هذا الرابط، ومن أين تجده، وكيف تضيفه في آينا، وماذا تفحص إذا ظهر الدليل فارغاً.

آخر تحديث · فريق آينا IPTV

من أين يأتي رابط EPG؟

  • بيانات Xtream Codes فيها رابطها جاهزاً، على نفس السيرفر وبنفس اسم المستخدم وكلمة المرور: http://server:port/xmltv.php?username=…&password=…، أي رابط get.php نفسه وفيه xmltv.php مكانه. وآينا يجلبه وحده، فلا تكتب شيئاً.
  • قائمة M3U تكتب رابطها غالباً في أول سطر: #EXTM3U x-tvg-url="https://…/guide.xml.gz" (أو url-tvg). وبعض القوائم تكتب أكثر من رابط بينها فواصل، رابطاً لكل بلد، فيحمّلها آينا كلها دون أن تطلب.
  • وإن لم يكن، فمزوّدك يعطيك رابطاً خاصاً ينتهي بـ .xml، أو بـ .xml.gz إذا كان مضغوطاً. والاثنان يعملان.
  • «بوابة MAC» تأتي بدليلها، ويقرؤه آينا كما يقرؤه جهاز الرسيفر. والبوابة التي لا دليل لها تضيف لها رابطاً من الإعدادات ثم «مصادر دليل البرامج».

ماذا في ملف XMLTV؟

XMLTV هي الصيغة التي يستخدمها كل دليل IPTV تقريباً: ملف نصي، مضغوط في الغالب، فيه قائمة القنوات ثم برامجها. وهذه أجزاؤه المهمة:

أجزاء دليل XMLTV التي يقرؤها المشغّل.
الجزءماذا فيه
<channel id="…">قناة واحدة والمعرّف الذي تُرتَّب برامجها تحته، مثل mychannel.uk. وقائمة قنوات الدليل هي هذه كلها.
<display-name>اسم القناة، وأحياناً بأكثر من لغة.
<programme start="…" stop="…" channel="…">برنامج واحد، ووقت بدايته ونهايته مع منطقتها الزمنية، ومعرّف القناة التي يتبعها.
<title> و<desc> و<category>اسم البرنامج، وعمّ يتكلم، ونوعه.

دليل أسبوع لاشتراك كبير قد يصل إلى مئات الميغابايت، ولهذا يضغطه المزوّدون. ويكتبه آينا على مساحة التخزين وهو يُنزَّل ويقرؤه جزءاً جزءاً، فلا يُتعب دليل بهذا الحجم ذاكرة الجوال أو جهاز الستيك.

إذا لم يعطك مزوّدك دليلاً

  • اطلبه منه أولاً. الدليل المعدّ لاشتراكك هو الأكثر تطابقاً مع قنواتك، ومعظم المزوّدين عندهم دليل حتى لو لم يذكروه.
  • انظر في القائمة نفسها. افتحها في محرّر نصوص، وابحث في أول سطر عن x-tvg-url.
  • اصنع واحداً بنفسك. iptv-org/epg مشروع مفتوح على GitHub يصنع ملف XMLTV من الجداول التي تنشرها مواقع القنوات، للقنوات التي تختارها. لكنه أداة تشغّلها على كمبيوتر وليس رابطاً جاهزاً، والملف الذي يكتبه يحتاج أن يكون على رابط تصل إليه أجهزتك.

افحص رابط الدليل قبل إضافته

افتحه في متصفح الكمبيوتر. رابط .xml الصحيح يعرض نصاً يبدأ بـ <?xml أو <tv، ورابط .xml.gz ينزّل ملفاً. أما صفحة دخول أو خطأ أو صفحة فارغة فمعناها أن الرابط خاطئ أو انتهت صلاحيته، فاطلب من مزوّدك رابطاً جديداً. ورابط xmltv.php في Xtream Codes إذا رجع فارغاً، فالغالب أن المزوّد لا ينشر دليلاً لهذا الاشتراك.

إضافة رابط EPG إلى قائمة M3U

  1. 1

    ابدأ إضافة القائمة

    اختر «قائمة M3U» في شاشة «أضف اشتراكك»، أو ادخل «الإعدادات» ثم «الاشتراكات» ثم «إضافة اشتراك».

  2. 2

    الصق رابط القائمة

    في خانة «رابط القائمة»، كالمعتاد.

  3. 3

    الصق رابط الدليل

    في خانة «رابط دليل البرامج (اختياري)»: رابط .xml أو .xml.gz. واتركها فارغة إذا كانت القائمة تكتب رابط دليلها.

  4. 4

    اضغط «اتصال»

    تصل القنوات أولاً ثم يتبعها الدليل. والدليل الكبير قد يأخذ دقيقة.

أضف دليلاً آخر لاحقاً

«مصادر دليل البرامج» في الإعدادات تعمل مع كل اشتراك، ومنها Xtream Codes و«بوابة MAC». أضف دليلاً برابط XMLTV ليكمّل القنوات التي لا يغطيها دليل مزوّدك، واضبط لكل دليل توقيته، وأوقف أيّاً منها. وزر «تحديث الدليل الآن» يطبّق التغيير في الحال.

كيف يعرف الدليل قنواتك؟

القائمة تعطي كل قناة المعرّف الذي يقابلها في الدليل، مثل tvg-id="mychannel.uk"، والدليل يرتّب البرامج تحت <channel id="mychannel.uk">، ويطابق آينا بين الاثنين. وإذا لم يكن للقناة معرّف، أو كان الدليل يستخدم معرّفاً آخر، يجرّب آينا اسم القناة، فيستطيع دليل من مصدر آخر أن يملأ جزءاً كبيراً من قنواتك.

لماذا يظهر الدليل فارغاً أو خاطئاً؟

  • الدليل لا يغطّي هذه القنوات. كل دليل يُنشر لمجموعة معيّنة من القنوات، فاطلب من مزوّدك الدليل المعدّ لاشتراكك.
  • المعرّفات والأسماء لا تتطابق. القنوات التي يسمّيها الدليل باسم آخر تبقى فارغة. ودليل مزوّدك نفسه هو الأكثر تطابقاً.
  • انتهت مدة الدليل. الدليل يغطّي أياماً قليلة قادمة، وإذا توقّف المزوّد عن تحديثه ينتهي الجدول حيث ينتهي الملف.
  • ما زال يُحمَّل. يملأ آينا الجدول حين يصل الملف كاملاً، وهذا قد يأخذ دقيقة أو دقيقتين مع دليل كبير.
  • الأوقات غير صحيحة. الدليل يحمل منطقته الزمنية مع كل برنامج، ويعرضها آينا بتوقيتك. فإذا كانت كل البرامج متأخرة أو متقدّمة بعدد الساعات نفسه، فالخطأ في توقيت دليل المزوّد: من «مصادر دليل البرامج»، حرّكه إلى الأمام أو إلى الخلف بالساعة أو بنصف الساعة حتى يطابق.

ماذا تحصل عليه بعد إضافته؟

«الآن» و«التالي» تحت كل قناة، ودليل البرامج لما يُعرض الآن والليلة مع بحث في البرامج، وجدول أسبوع لكل قناة، وإعادة المشاهدة حيث يحتفظ مزوّدك بأرشيف.

أسئلة وأجوبة

مع Xtream Codes هو xmltv.php على سيرفرك باسم المستخدم وكلمة المرور، ويستخدمه آينا وحده. ومع قائمة M3U ابحث عن x-tvg-url في أول سطر منها، أو اطلب من مزوّدك رابط الدليل بصيغة .xml أو .xml.gz.

صيغة الملف التي يستخدمها كل مزوّدي IPTV تقريباً لدليل البرامج: قائمة بالقنوات ولكل قناة معرّف، وبالبرامج مع قناتها ووقت بدايتها ونهايتها وعنوانها ووصفها.

لا يختلف إلا في أنه مضغوط، فيكون تنزيله أصغر بكثير. وآينا يقرأ الاثنين.

نعم، أي رابط XMLTV يعمل في آينا. لكن الدليل من مصدر آخر يملأ فقط القنوات التي تتطابق معرّفاتها أو أسماؤها، فابدأ بدليل مزوّدك، وأضف المجاني بجانبه في «مصادر دليل البرامج» ليكمّل الناقص.

لا. الدليل يأتي من لوحة مزوّدك وحده. ويمكنك مع ذلك إضافة أدلة من اختيارك من الإعدادات ثم «مصادر دليل البرامج»، للقنوات التي لا يغطيها.