Mayk IP TV

技术文档

M3U 播放列表格式规范

面向 IPTV 的完整 M3U 播放列表格式技术规范指南。深入学习第 1 层与第 2 层标签定义、频道解析分类规则,并利用在线工具验证播放列表兼容性。

Mayk IP TV 中的 M3U 格式概述

M3U 播放列表格式是全球 IPTV 频道分发的通行基石。Mayk IP TV 全面兼容传统 M3U 文件以及包含丰富元数据的现代 M3U8 文件。

播放列表的结构与语法规范

规范的 M3U 文件始终以 #EXTM3U 声明行开头,随后是成对出现的 #EXTINF 元数据行与直链流媒体播放地址。

点播电影与剧集分类体系

媒体内容将根据诸如 S01 E02 等季与分集命名规则,自动归类为电视直播、点播电影或电视剧集。

文件解析与最佳实践建议

始终采用纯净的 UTF-8 编码、有效的 HTTP/HTTPS 直链,并配置唯一的 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频道台标图像的直接网络链接(建议使用基于 HTTPS 的 PNG 或 SVG)。
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。
  • 配置与 XMLTV 节目源完全匹配的有效 tvg-id 属性。
  • 善用 group-title 属性对海量频道进行清晰的逻辑分类。
  • 将文件保存为无 BOM 标记的纯正 UTF-8 字符编码。