Mayk IP TV

المرجع التقني

مواصفات تنسيق قائمة تشغيل M3U

المواصفات الفنية الكاملة لتنسيق قائمة M3U لـ IPTV. تعلم علامات المستويين 1 و 2 وقواعد التصنيف وتحقق من القوائم.

مقدمة حول تنسيق M3U في Mayk IP TV

يعد تنسيق قوائم التشغيل M3U المعيار العالمي لقوائم قنوات IPTV. يدعم Mayk IP TV ملفات M3U التقليدية وملفات M3U8 الحديثة الغنية بالبيانات الوصفية.

بنية وتكوين قائمة التشغيل

يبدأ ملف M3U الصالح دائماً بعبارة التصريح #EXTM3U، تليها أزواج متتابعة من أسطر البيانات الوصفية #EXTINF وعناوين التدفق المباشرة.

تصنيف الأفلام والمسلسلات

يتم تصنيف المحتوى تلقائياً إلى بث تلفزيوني حي أو أفلام أو حلقات مسلسلات بناءً على أنماط المواسم والحلقات مثل S01 E02.

أفضل الممارسات للتحليل والتشغيل

احرص دائماً على استخدام ترميز UTF-8 وروابط تدفق نشطة ومعرفات tvg-id فريدة لضمان عمل دليل البرامج الإلكتروني (EPG) بدقة.

المستوى 1: علامات #EXTINF القياسية

الحقل / العلامةالمستوىالنوعقيمة تجريبيةالوصف
#EXTM3Uقياسي (المستوى 1) · مطلوبDirective (Header)#EXTM3Uسطر الترويسة الإلزامي الذي يحدد الملف كقائمة تشغيل M3U موسعة صالحة.
#EXTINFقياسي (المستوى 1) · مطلوبDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDتوجيه معلومات المسار الذي يحدد مدة البث وسمات البيانات الوصفية.
tvg-idقياسي (المستوى 1) · اختياريStringtrt1.trمعرف فريد يربط القناة بسجل القناة في ملف دليل البرامج XMLTV EPG.
tvg-nameقياسي (المستوى 1) · اختياريStringTRT 1 HDاسم القناة الرسمي المسجل في دليل البرامج الإلكتروني التلفزيوني.
tvg-logoقياسي (المستوى 1) · اختياريURL (http/https)https://stream.example.com:8080/images/trt1.pngرابط مباشر لصورة شعار القناة (يفضل تنسيق PNG أو SVG عبر HTTPS).
group-titleقياسي (المستوى 1) · اختياريStringNationalاسم الفئة أو الباقة التي يتم تصنيف القناة تحتها في واجهة المشغل.
#EXTGRP:قياسي (المستوى 1) · اختياريDirective#EXTGRP:Nationalتوجيه تصنيف بديل يتم وضعه مباشرة بعد سطر EXTINF.

المستوى 2: علامات Mayk IP TV الموسعة

الحقل / العلامةالمستوىالنوعقيمة تجريبيةالوصف
media-typeموسع (المستوى 2) · اختياريEnum ("live" | "movie" | "series")media-type="series"تجاوز صريح لنوع الوسائط: 'live' أو 'movie' أو 'series'.
series-idموسع (المستوى 2) · اختياريString / Integerseries-id="show-42"معرف مسلسل فريد لتجميع تدفقات الحلقات المتعددة معاً.
series-nameموسع (المستوى 2) · اختياريStringseries-name="Example Series"اسم المسلسل القياسي لتجميع مواسم وحلقات العمل التلفزيوني.
seasonموسع (المستوى 2) · اختياريIntegerseason="1"رقم الموسم لحلقات المسلسلات التلفزيونية (عدد صحيح).
episodeموسع (المستوى 2) · اختياريIntegerepisode="4"رقم الحلقة ضمن الموسم التلفزيوني المحدد (عدد صحيح).
is_adultموسع (المستوى 2) · اختياريInteger ("0" | "1")is_adult="1"علامة القفل الأبوي: '1' تحدد محتوى البالغين المقيد.
age_ratingموسع (المستوى 2) · اختياريStringage_rating="18+"شارة الحد الأدنى للعمر (مثل '18+') لمرشحات الرقابة الأبوية.

قواعد تصنيف المحتوى

النوع#قيمة تجريبية
بث مباشر#3http(s)://... | media-type="live"
فيلم (VOD)#2/movie/... | media-type="movie"
حلقة مسلسل#1/series/... + S01E01 / S01.E01 | media-type="series"

نماذج وقوالب

بث مباشر (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-id="trt1.tr" tvg-name="TRT 1 HD" tvg-logo="https://stream.example.com:8080/images/trt1.png" group-title="Ulusal",TRT 1 HD
https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
#EXTINF:-1 tvg-id="atv.tr" tvg-name="ATV HD" tvg-logo="https://stream.example.com:8080/images/atv.png" group-title="Ulusal",ATV HD
https://stream.example.com:8080/live/demo_user/demo_pass/102.m3u8
فيلم (VOD) & حلقة مسلسل (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-logo="https://stream.example.com:8080/images/movie202.png" group-title="Sinema",Example Movie (2026)
https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
#EXTINF:-1 group-title="Dizi",Example Series - S01E01 - Pilot
https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4
#EXTINF:-1 media-type="series" series-name="Custom Show" season="1" episode="2" group-title="Dizi",Custom Show - S01E02
https://stream.example.com:8080/series/demo_user/demo_pass/30302.mp4

المدقق التفاعلي للتنسيق

الصق مقتطف M3U أو حمولة Xtream JSON أدناه للتحقق من التوافق مع مشغل Mayk IP TV.

قائمة التحقق من توافق M3U

  • تأكد من أن السطر الأول في الملف هو تماماً #EXTM3U.
  • حدد المدة بالقيمة -1 لكافة القنوات التلفزيونية الحية المستمرة.
  • عيّن قيم tvg-id دقيقة تتطابق مع مصدر بيانات XMLTV الخاص بك.
  • نظم القنوات بدقة ضمن مجموعات باستخدام خاصية group-title.
  • احفظ الملفات بترميز UTF-8 نقي دون علامة ترتيب البايتات (BOM).