#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
مرجع فنی
مشخصات فنی قالب پلیلیست M3U
مشخصات کامل قالب پلیلیستهای M3U برای IPTV. شناخت تگهای سطح ۱ و ۲، پردازش کانالها و ارزیابی تعاملی فهرستها.
معرفی قالب M3U در Mayk IP TV
قالب M3U استاندارد پایه و جهانی برای ارائه فهرست کانالهای IPTV به شمار میرود. برنامه Mayk IP TV از فایلهای سنتی M3U و فایلهای نوین M3U8 با ابردادههای غنی پشتیبانی کامل دارد.
ساختار و دستور نگارش پلیلیست
پرونده معتبر M3U همواره با سطر #EXTM3U آغاز میگردد و به دنبال آن جفتهای پیاپی از سطرهای فراداده #EXTINF و نشانیهای مستقیم پخش قرار میگیرند.
دستهبندی فیلمها و سریالها
محتواها به طور خودکار بر پایه شناسههای فصل و قسمت مانند S01 E02 به پخش زنده، فیلمهای سینمایی یا قسمتهای سریال تفکیک میشوند.
بهترین روشها برای پردازش فایل
همواره از کدگذاری استاندارد UTF-8، پیوندهای پایدار HTTP/HTTPS و شناسههای یکتای tvg-id برای عملکرد بیپایان راهنمای الکترونیکی برنامهها (EPG) بهره بگیرید.
سطح ۱: تگهای استاندارد #EXTINF
| فیلد / تگ | سطح | نوع | مقدار نمونه | توضیحات |
|---|---|---|---|---|
#EXTM3U | استاندارد (سطح ۱) · ضروری | Directive (Header) | #EXTM3U | سطر سرآیند الزامی پرونده که فایل را به عنوان پلیلیست گسترشیافته M3U تعریف میکند. |
#EXTINF | استاندارد (سطح ۱) · ضروری | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | دستور اطلاعات تراک که مدتزمان و ویژگیهای فراداده را مشخص میکند. |
tvg-id | استاندارد (سطح ۱) · اختیاری | String | trt1.tr | شناسه اختصاصی که پیوند میان کانال و دادههای راهنمای برنامه XMLTV EPG را برقرار میسازد. |
tvg-name | استاندارد (سطح ۱) · اختیاری | String | TRT 1 HD | نام رسمی و ثبتی کانال در جدول راهنمای الکترونیکی برنامههای تلویزیونی. |
tvg-logo | استاندارد (سطح ۱) · اختیاری | URL (http/https) | https://stream.example.com:8080/images/trt1.png | نشانی مستقیم وب برای تصویر نشانواره یا لوگوی کانال (ترجیحاً PNG یا SVG از بستر HTTPS). |
group-title | استاندارد (سطح ۱) · اختیاری | String | National | نام گروه یا دستهبندی ویژهای که کانال ذیل آن در منوی برنامه جای میگیرد. |
#EXTGRP: | استاندارد (سطح ۱) · اختیاری | Directive | #EXTGRP:National | دستور جایگزین دستهبندی که بلافاصله پس از خط EXTINF قرار میگیرد. |
سطح ۲: تگهای پیشرفته Mayk IP TV
| فیلد / تگ | سطح | نوع | مقدار نمونه | توضیحات |
|---|---|---|---|---|
media-type | پیشرفته (سطح ۲) · اختیاری | Enum ("live" | "movie" | "series") | media-type="series" | تعریف صریح نوع رسانه: 'live' یا 'movie' یا 'series'. |
series-id | پیشرفته (سطح ۲) · اختیاری | String / Integer | series-id="show-42" | شناسه اختصاصی سریال برای گروهبندی قسمتهای گوناگون مجموعه. |
series-name | پیشرفته (سطح ۲) · اختیاری | String | series-name="Example Series" | عنوان اصلی و رسمی سریال برای تجمیع فصلها و قسمتها. |
season | پیشرفته (سطح ۲) · اختیاری | Integer | season="1" | شماره فصل برای قسمتهای مجموعه تلویزیونی (عدد صحیح). |
episode | پیشرفته (سطح ۲) · اختیاری | Integer | episode="4" | شماره قسمت در فصل تعیینشده سریال (عدد صحیح). |
is_adult | پیشرفته (سطح ۲) · اختیاری | Integer ("0" | "1") | is_adult="1" | نشانگر قفل کودک: '1' محتوای ویژه بزرگسالان را تعیین مینماید. |
age_rating | پیشرفته (سطح ۲) · اختیاری | String | age_rating="18+" | نشان ردهبندی سنی (مانند '+18') برای فیلترهای نظارت والدین. |
قواعد دستهبندی محتوا
| نوع | # | مقدار نمونه |
|---|---|---|
| پخش زنده | #3 | http(s)://... | media-type="live" |
| فیلم (VOD) | #2 | /movie/... | media-type="movie" |
| قسمت سریال | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
الگوهای نمونه
#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 یا پاسخ JSON سرویس Xtream را در کادر زیر وارد کنید تا سازگاری با Mayk IP TV سنجیده شود.
فهرست بررسی سازگاری M3U
- اطمینان حاصل کنید که نخستین خط فایل دقیقاً عبارت #EXTM3U باشد.
- مدت زمان را برای تمام شبکههای زنده تلویزیونی برابر ۱- قرار دهید.
- شناسههای دقیق tvg-id متناسب با منبع جدول XMLTV تعیین نمایید.
- کانالها را با ویژگی group-title به صورت دستههای منطقی بچینید.
- پرونده را با کدگذاری یکدست UTF-8 بدون نشانگر ترتیب بایت (BOM) ذخیره فرمایید.