IPTV 与媒体

M3U 频道分组与台标

了解 M3U 频道列表中的 group-title、tvg-id 和 logo 元数据,包括它们在不同播放器中显示差异的原因。

CarCast 编辑部阅读约 6 分钟
分组媒体频道行示意图,附图标和缩略图,旁边是图像文件夹。

M3U 列表中的频道组和徽标是元数据约定,帮助兼容播放器组织条目。它们不会改变底层流或证明其可用性。列表可能能够正确播放,而其分组、艺术作品或节目关联在另一应用中显示不同,因为播放器识别不同的扩展并应用不同的匹配规则。

在编辑您拥有的列表时,应将可视元数据和媒体位置视为独立字段。请备份原始文件,在小样本上进行操作,并在围绕某个应用重建大型目录之前检查接收播放器的文档。

从信息行开始

扩展的 M3U 使用 #EXTINF 行在接下来的媒体位置之前描述一个条目。可见名称通常出现在逗号之后。IPTV 列表可能会添加诸如 group-title、tvg-id、tvg-name 和 tvg-logo 等属性。这些额外的名称很常见,但并非所有地方都能识别。

VideoLAN M3U 参考 对于基础播放列表结构很有用。对于 IPTV 元数据的具体实现,Kodi IPTV 简单客户端文档 描述了支持的约定。它记录了该客户端;并不代表对其他所有应用程序的保证。

不要仅因为文本编辑器使行显得拥挤而删除引号或重新排列标点符号。解析器可能依赖于属性语法。在修改整个文件之前,请在示例条目中更改一个属性并验证结果。

理解群组代表的含义

群组通常是一个组织标签,例如新闻、体育或本地。它不一定对应单独的服务器、账户套餐、国家许可或播放能力。同一群组中的两个条目可能指向无关的媒体系统,而同一个流可以出现在多个标签下。

选择便于读者浏览的群组名称。如果你维护列表,请保持拼写和大小写一致。否则,几乎相同的标签可能会成为不同的群组。确定语言、主题或位置哪个是主要的组织原则;在一个字段中混合这三者可能会使大型列表难以浏览。

有些玩家会合并分组,有些会支持收藏,有些可能会以不同的方式解释多个标签。请记录目标应用程序的预期行为,而不是依赖只有一个导入器能理解的分隔符。在进行此可视化组织工作时,流 URL 应保持不变。

保持频道身份与其名称分开

可见的频道名称是给人看的;标识符通常用于匹配。节目指南可能希望 tvg-id 值对应于单独指南文件中的频道标识符。稍微的拼写差异、重复的标识符或不同的区域信号源都可能导致节目指南信息丢失或不正确。

重命名可见标题不一定能修复标识符。同样,改变标识符可能会断开原本正确的节目指南关联。请记录两个值,并检查指南提供者的映射,而不是根据频道的标志或网站地址自行生成ID。

不要仅仅因为品牌看起来相似就合并源。全国性服务和延迟的地区版本可能共享一个标志,但时间表不同。节目指南支持也是一种播放器功能,必须单独验证。本说明并不表示 CarCast 会导入或呈现EPG元数据。

标志是另一种网络资源

tvg-logo 的值通常指向一个图像位置。播放器必须独立于媒体流去获取并解码该图像。即使图像无法显示,频道仍然可以播放,因为图像可能已移动、需要认证、使用不支持的格式,或被当前网络阻止。

在登录状态的浏览器中显示的图像可能依赖播放器没有的 cookie。相对图像地址也需要一个基础位置;RFC 3986 解释了相对引用如何解析。因此,将播放列表复制到另一个主机,即使文本保持不变,也可能影响到艺术品显示。

请使用您有权复制的艺术品,并确保来源稳定且受所有者控制。大图像会增加不必要的传输,并可能在移动数据下加载缓慢。提供商文档中的 logo URL 优于临时搜索结果缩略图或从无关服务提取的图像。

系统地诊断缺失的艺术作品

首先测试一个受影响的条目。确认其 logo 属性存在且地址未被截断。在同一连接上私下打开图像,然后检查接收播放器是否支持该图像类型和元数据字段。如果应用程序提供文档化的元数据刷新,请在重写不相关条目之前使用该功能。

缓存的图像可能会使结果复杂化。服务器可能已经修正了图像,而客户端仍显示旧版本。在应用程序支持的刷新过程后记录症状是否仍然存在,并避免承诺重新安装总能清除相关缓存。

如果没有出现任何标志,问题更可能是播放器功能或共享访问问题,而不是数百张独立缺失的图片。如果只有一个标志未显示,请关注该地址。保持媒体 URL 不变,以免在修复元数据时意外导致播放失败。

在主列表之前编辑一个小副本

创建一个包含两到三个带有不同名称、不同分组且已知可访问标志的授权条目的私人测试列表。使用与完整目录相同的方法导入。分别比较名称、分组、艺术品和播放情况。这样可以揭示播放器实际使用了哪些字段。

然后调整主文件的副本。保留其字符编码和纯文本格式。在与外部数据匹配的地方保持ID稳定。如果使用脚本编辑属性,请检查生成的行,而不要假设每个条目都具有相同的标点或字段顺序。

有关更广泛的文件模型,请参阅 什么是 M3U 播放列表。对于指南时间而不是缺失的艺术作品,EPG 时区 解释了为什么正确的频道身份仍然可能显示错误的节目时间。

维护元数据而不夸大支持

保持简短的维护记录:来源拥有者、最后检索日期、预期播放器和所做的编辑。远程目录可能会在下次更新时覆盖本地元数据更改,而本地副本可能会落后于来源的修正。选择一种能使这些后果可见的工作流程。

在寻求帮助时,提供一个经过编辑的示例,该示例保留元数据结构,但替换凭证和私人媒体位置。说明应用程序和版本、失败的字段,以及播放本身是否可用。这样可以在不泄露账户访问权限的情况下提供一个可复现的问题给支持团队。

当列表和播放器都认可其含义时,分组和标志可以改善导航。将它们视为可选的展示和匹配数据,在预期的应用程序中进行验证,并将它们的成功与流的健康状况分开考虑。

参考来源

返回文章中心

播放自己的媒体。

使用你拥有访问权限的媒体来源和兼容显示设备,了解 iPhone 版 CarCast。

下载 iPhone 版