读懂 M3U 文件:EXTINF、tvg-logo、group-title 都是什么
用文本编辑器打开一份 M3U 列表,你会看到一堆以 # 开头的行。看不懂它,列表出了问题就只能干瞪眼;看懂了,频道名、台标、分组、节目单号全都攥在自己手里。这一页把格式逐层拆开。
全貌:一个频道两行
#EXTM3U
#EXTINF:-1 tvg-id="cctv1" tvg-name="CCTV1" tvg-logo="台标图片地址" group-title="央视频道",CCTV-1 综合
这里一行是频道的流地址
整个文件就是这种两行结构的重复:信息行 + 地址行。
逐个拆解
#EXTM3U——文件第一行,声明这是 M3U 格式。没有它,部分解析器不认这个文件(排查见列表不加载)。
#EXTINF:-1——频道信息行的开头。冒号后的数字是节目时长(直播场景固定写 -1,表示不定长)。
tvg-id——频道标识,节目单(EPG)靠它与节目单源里的频道对号,匹配细节见频道号匹配。
tvg-name——频道原始名称,部分应用用它辅助匹配节目单。
tvg-logo——台标图片的地址,决定频道格子里的图标(显示逻辑见台标显示)。
group-title——分组名,决定频道落在哪个标签页(见分组标签页)。
逗号后的文字——频道显示名称,应用列表里看到的名字,也是搜索频道匹配的目标。
第二行——流的地址,可以是 HTTP 流、HLS 切片流,也可以是组播地址(udp://@ 形态,播放见组播是什么)。
文件头还可带 x-tvg-url——整份列表默认的节目单源地址,应用导入时自动挂载(见挂节目单源)。
掌握之后能做什么
- 自己修列表:改台名、调分组、补台标
- 排查失效:频道地址行看一眼就知道指向什么
- 从零写一份自己的列表——下一步见自建播放列表