Mayk IP TV

مرجع فنی

مشخصات فنی قالب پلی‌لیست 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استاندارد (سطح ۱) · اختیاریStringtrt1.trشناسه اختصاصی که پیوند میان کانال و داده‌های راهنمای برنامه XMLTV EPG را برقرار می‌سازد.
tvg-nameاستاندارد (سطح ۱) · اختیاریStringTRT 1 HDنام رسمی و ثبتی کانال در جدول راهنمای الکترونیکی برنامه‌های تلویزیونی.
tvg-logoاستاندارد (سطح ۱) · اختیاریURL (http/https)https://stream.example.com:8080/images/trt1.pngنشانی مستقیم وب برای تصویر نشان‌واره یا لوگوی کانال (ترجیحاً PNG یا SVG از بستر HTTPS).
group-titleاستاندارد (سطح ۱) · اختیاریStringNationalنام گروه یا دسته‌بندی ویژه‌ای که کانال ذیل آن در منوی برنامه جای می‌گیرد.
#EXTGRP:استاندارد (سطح ۱) · اختیاریDirective#EXTGRP:Nationalدستور جایگزین دسته‌بندی که بلافاصله پس از خط EXTINF قرار می‌گیرد.

سطح ۲: تگ‌های پیشرفته Mayk IP TV

فیلد / تگسطحنوعمقدار نمونهتوضیحات
media-typeپیشرفته (سطح ۲) · اختیاریEnum ("live" | "movie" | "series")media-type="series"تعریف صریح نوع رسانه: 'live' یا 'movie' یا 'series'.
series-idپیشرفته (سطح ۲) · اختیاریString / Integerseries-id="show-42"شناسه اختصاصی سریال برای گروه‌بندی قسمت‌های گوناگون مجموعه.
series-nameپیشرفته (سطح ۲) · اختیاریStringseries-name="Example Series"عنوان اصلی و رسمی سریال برای تجمیع فصل‌ها و قسمت‌ها.
seasonپیشرفته (سطح ۲) · اختیاریIntegerseason="1"شماره فصل برای قسمت‌های مجموعه تلویزیونی (عدد صحیح).
episodeپیشرفته (سطح ۲) · اختیاریIntegerepisode="4"شماره قسمت در فصل تعیین‌شده سریال (عدد صحیح).
is_adultپیشرفته (سطح ۲) · اختیاریInteger ("0" | "1")is_adult="1"نشانگر قفل کودک: '1' محتوای ویژه بزرگسالان را تعیین می‌نماید.
age_ratingپیشرفته (سطح ۲) · اختیاری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 یا پاسخ JSON سرویس Xtream را در کادر زیر وارد کنید تا سازگاری با Mayk IP TV سنجیده شود.

فهرست بررسی سازگاری M3U

  • اطمینان حاصل کنید که نخستین خط فایل دقیقاً عبارت #EXTM3U باشد.
  • مدت زمان را برای تمام شبکه‌های زنده تلویزیونی برابر ۱- قرار دهید.
  • شناسه‌های دقیق tvg-id متناسب با منبع جدول XMLTV تعیین نمایید.
  • کانال‌ها را با ویژگی group-title به صورت دسته‌های منطقی بچینید.
  • پرونده را با کدگذاری یکدست UTF-8 بدون نشانگر ترتیب بایت (BOM) ذخیره فرمایید.