企业官网建设流程全解析

Kodi IPTV Simple 直播配置教程

【免费下载链接】pvr.iptvsimpleIPTV Simple client for Kodi PVR项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple

周末想窝在客厅看一场球赛,你不想翻说明书、不想接机顶盒,只想打开电视直接看。Kodi 上的 IPTV Simple 插件干的就是这件事:它读取网络直播的频道清单,把这些频道变成 Kodi 里的电视直播频道,让你像看有线电视一样看 IPTV 直播。

它是什么,适合谁

pvr.iptvsimple 是 Kodi PVR 插件家族中的 IPTV Simple Client。它读取 M3U 格式的频道清单和 XMLTV 格式的电子节目单(EPG,Electronic Programme Guide,也就是电视上那个节目表),把两者合并后交给 Kodi 播放。适合手上有一份网络直播地址清单、希望用 Kodi 当"网络电视机顶盒"的用户,不需要写代码,全程在设置界面里完成。

动手前先确认这几项

• Kodi 版本为 20(Nexus)或更新,且已开启 PVR 支持;较新版本支持同一插件加载多套配置。
• 一份可正常播放的 M3U 清单文件或其网络地址,这是最核心的前提。
• 一份 XMLTV 节目单文件(可选,没有也能看直播,只是没有节目表)。
• 打算使用直播暂停、回退等时移功能的话,需另外安装 inputstream.ffmpegdirect 组件。

安装 IPTV Simple 插件

打开 Kodi,依次进入"附加程序"→"从库安装",在"PVR 客户端"分类里找到"IPTV Simple Client",选择安装。等待右下角安装完成提示消失。完成后你应看到:附加程序列表中出现 IPTV Simple Client,并且 Kodi 的"视频"界面里多出一个"电视直播"(PVR)入口,点进去时不会报"未配置"错误。

配置第一个 M3U 播放列表

进入插件设置,在"常规"页签里选择清单位置:本地路径就填 M3U 文件的存放位置,远程路径就填它的网络地址;如果清单是远程的,还可以勾选把清单缓存到本地,这样每次启动不用重新下载。保存设置后等待清单加载。

一份 M3U 清单最少只需要频道名和播放地址,长这样:

#EXTM3U #EXTINF:0 tvg-id="cctv1" group-title="新闻",央视一套 http://example.com/cctv1.ts #EXTINF:0 tvg-id="hunan" group-title="娱乐",湖南卫视 http://example.com/hunan.ts

其中tvg-id是频道的唯一标识,后面配节目单时靠它对应关系;group-title决定频道归入哪个分组。完成后你应看到:回到 Kodi 主界面打开"电视直播",频道列表按分组显示出了清单里的所有频道,随便点一个能出画面出声音。

⚠️ 注意:如果列表是空的,先确认路径或地址拼写无误,再用设备浏览器或播放器单独打开清单里某个频道地址验证。远程地址加载失败时,可适当调大设置里的 M3U 检查超时时间。

接上 XMLTV 节目单

回到插件设置的"EPG"页签,同样选择 XMLTV 文件的位置(本地路径或远程地址)。这里有两个实用选项:EPG 时间偏移,如果你的节目单时间戳和实际播出时间对不上,可以整体平移,范围在负 12 小时到正 14 小时;忽略频道 ID 大小写,开启后匹配节目时不再区分tvg-id的大小写,能解决相当一部分"节目单不显示"的问题。保存后回到 Kodi 打开指南界面。完成后你应看到:每个频道下方出现了当前和后续的节目名称、播出时间,点进节目还能看到简介。

⚠️ 注意:频道能播但节目表空白,多半是 XMLTV 里的频道 ID 和 M3U 里的tvg-id对不上。两边的 ID 必须一致(名称也可以参与匹配),不一致时优先改自己的清单而不是节目单。改完设置后记得在 Kodi 的"设置→PVR 与直播电视→指南"里清除缓存再试。

让直播可以暂停和回退

时移功能让直播像点播一样可以暂停、快进、回退。它的实现方式是插件把直播流从你开始播放的时刻起缓冲到本地,再允许你在缓冲范围内拖动。操作分两部分:在 Kodi 附加程序库安装 inputstream.ffmpegdirect;回到 IPTV Simple 设置的"时移"页签,打开"启用时移",并按你的清单类型勾选 HTTP 流或 UDP 流。保存后重新进入某个直播频道,按暂停键。完成后你应看到:画面停在原地,进度条可以往回拖,拖到之前看过的位置能正常继续播放。

⚠️ 注意:时移只适用于 HTTP/UDP 等支持的协议。如果某个频道没有时移选项,可以单独在这个频道的 M3U 条目上方加上#KODIPROP:inputstream.ffmpegdirect.stream_mode=timeshift属性来强制启用。TS 格式的流还可以加#KODIPROP:mimetype=video/mp2t,加快首次加载速度。

进阶玩法

只保留想看的频道分组

如果你手上有几百个频道,每次翻找很费劲。插件的"分组"页签提供了三种 TV 分组模式:全部分组、指定分组、自定义分组。"指定分组"最多填 5 个分组名(注意区分大小写,名字要和 M3U 里group-title的写法一字不差);"自定义分组"则通过一个 XML 文件指定要加载哪些分组,适合分组数量多的情况。改完分组模式后,频道列表就只剩你勾选的那几个组,切台列表一下子清爽了。

让频道图标显示出来

光秃秃的频道名不好认。准备一个文件夹,把各频道的 PNG 图标(建议 100×100 左右)以tvg-id命名存放,在插件设置的"频道图标"页签把这个文件夹选为本地图标目录;如果图标跟着清单走,也可以填一个基础 URL。图标来源有 M3U 和 XMLTV 两种时,该页签还允许你选择优先用哪一个,本地目录方式下甚至可以直接忽略 M3U 自带的图标。设置完成后,频道列表和指南里的每个频道前都会出现对应台标。

给节目单按类别上色

节目单默认是一整片文字。插件可以读取一个类型映射文件(默认文件名genres.xml),把 XMLTV 里的节目分类转换成 Kodi 识别的类别编号,指南界面就会按类别显示颜色,电影、新闻、体育一眼区分。插件自带了示例映射文件,照着格式改一份自己的副本、在"类型"页签指定路径即可。设置完成后,指南里的节目按类别出现不同底色,想找体育节目扫一眼颜色就行。

几个容易卡住的情况

• 现象:个别频道无法播放。可能原因:该地址本身过期或需要特定请求头。处理:单独测试该地址;清单支持在频道条目里附加user-agent等请求属性。
• 现象:时移选项灰色或不可用。可能原因:未安装 inputstream.ffmpegdirect,或流协议不受支持。处理:安装组件,或用 KODIPROP 属性为该频道单独指定时移模式。
• 现象:改了分组、类型等配置没生效。可能原因:Kodi 缓存了旧数据。处理:到"设置→PVR 与直播电视"下分别清除指南缓存或全部缓存,再重启播放。

接下来去哪儿

插件的完整源码在 pvr.iptvsimple 开源仓库,设置文档直接写在仓库的 README 里,涵盖回看(catchup)、多播转单播(udpxy)等本文没展开的内容;配置上的疑难问题可以去 Kodi 社区的 PVR 支持版块提问,输入流相关行为则和 inputstream.ffmpegdirect 组件配合有关,遇到异常可先确认该组件的版本。

现在打开 Kodi,把 M3U 路径填进去,今晚就能在客厅的电视上看上网络直播了。

【免费下载链接】pvr.iptvsimpleIPTV Simple client for Kodi PVR项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple