【教程】TVBox 直播源怎么配置（点播与直播分开）

redpear

相关下载（夸克免码 + 百度带码）
夸克网盘（免提取码）：https://pan.quark.cn/s/506a1f556866
百度网盘：https://pan.baidu.com/s/1ZJlsIF4s0Euc71AyDM0hnw
提取码：6f33
说明：入门三件套含 FongMi / 俊版 / takagen99 电视版 APK。TVBox 为空壳播放器，需自行配置合法内容源。



TVBox 直播源怎么配置

在前面的教程中，我们详细探讨了点播库（单仓与多仓）的配置方法。许多用户在成功加载了家庭 NAS 的点播资源后，顺理成章地希望利用电视盒子观看本地宽带运营商提供的 IPTV 直播频道。

然而，直播和点播在 TVBox 中是两条完全独立的线。配置好点播并不代表系统会自动生成直播频道；相反，直播源需要特定的格式和独立的配置。本篇教程将向您展示如何在空壳播放器中正确导入合法合规的直播频道列表。

在此重申：TVBox 仅仅是播放器空壳。 本文的所有演示代码均使用 example.com 占位符。请各位用户务必配置自己有权使用的合法直播源（如三大运营商通过单播/组播转出的内网源，或拥有版权的测试流），不要在论坛内发帖求取所谓“稳定不卡”的侵权盗版直播源。


下载安装包

空壳安装包和直播源格式示例（占位频道，无实际画面）在这里：

· 夸克网盘（免提取码）：https://pan.quark.cn/s/506a1f556866
· 百度网盘：https://pan.baidu.com/s/1ZJlsIF4s0Euc71AyDM0hnw
· 百度提取码：6f33

转存后按后文步骤安装或对照格式。真正的配置、直播源和网盘文件仍须使用您自己有权使用的内容。

一、 直播与点播的区别及 EPG 概念

在开始配置前，我们需要厘清几个核心概念：

1. 两条独立的配置线：
点播（VOD）主要通过 JSON 文件中的 sites 字段和专门的爬虫脚本（spider）进行解析；而直播（Live）则是直接读取包含了媒体流直链（通常为 .m3u8 或 .ts 格式）的文本文件。这两个功能互不干涉。
2. 什么是 EPG？
EPG（Electronic Program Guide，电子节目单）是我们在看电视时，屏幕下方显示的“当前正在播放：XX新闻，下一档：XX剧场”的时间表。EPG 仅仅是文字说明，不是频道本身。 频道出不出画面，取决于直播源地址；而能否显示节目预告，取决于您是否配置了对应的 EPG 接口。即使 EPG 对不上或缺失，也丝毫不影响画面的正常播放。

二、 常见直播源格式解析

目前主流的直播源文件主要有两种格式：m3u 和 txt。您的合法直播源无论是什么形式，最终都需要整理成这两种标准格式。

1. M3U 格式

这是国际通用的播放列表格式。开头必须是 #EXTM3U，随后每两行为一个频道。
示例（占位数据）：

1. #EXTM3U
2. #EXTINF:-1 tvg-name="示例新闻" tvg-logo="https://example.com/logo.png",示例新闻
3. https://example.com/live/sample_news.ts
4. #EXTINF:-1 tvg-name="示例综合",示例综合
5. https://example.com/live/sample_general.m3u8

复制代码

2. TXT 分组格式

这是国内各类播放器非常流行的一种极简文本格式。利用 #genre# 标签进行大类分组。
示例（占位数据）：

1. 本地测试频道,#genre#
2. 示例新闻,https://example.com/live/sample_news.ts
3. 示例综合,https://example.com/live/sample_general.m3u8

复制代码

三、 分步配置教程

将直播源导入播放器，通常有以下两种常见做法（不同分支如 FongMi、俊版、影视仓在菜单命名上略有差异，请以您的实际版本为准）：

方法 A：写进主配置 JSON 的 lives 字段

如果您习惯于维护一个整体的 JSON 配置文件，可以将整理好的直播源地址直接写进去。

1. 打开您的单仓 JSON 配置文件。
2. 找到 lives 数组，将直播源链接填入，并可选填 EPG 链接。

1. "lives": [
2.   {
3.     "name": "本地IPTV",
4.     "url": "https://example.com/live/playlist.txt",
5.     "epg": "https://example.com/live/epg.xml"
6.   }
7. ]

复制代码

3. 在电视端重新加载该 JSON 配置。回到首页，点击【直播】板块，即可进入频道列表。



将 txt 或 m3u 链接写入 json 配置文件的 lives 字段示意


方法 B：在设置界面的“直播源”独立填写（推荐新手）

部分版本为了方便用户随时更换直播流，提供了独立的直播地址输入框。

1. 打开播放器，进入【设置】菜单。
2. 寻找名为「直播地址」或「Live URL」的选项。
3. 通过手机扫码或遥控器，输入您事先准备好的独立直播源直链（如 `https://example.com/live/playlist.m3u）。



进入设置菜单找到独立的直播地址输入框


4. 确认后退回首页，点击底栏或侧边栏的【直播】入口。
5. 此时预期界面是：左侧出现频道分组（如“本地测试频道”），中间出现具体频道（如“示例新闻”）。点击频道，右侧屏幕开始缓冲并成功出画。



进入直播界面后的频道分类与播放画面示意



点击菜单呼出换台列表，并在下方显示 EPG 节目单


四、 常见问题排查（FAQ）

直播源的稳定性受网络环境和解码器影响极大，遇到问题请参考以下排查步骤：

1. 现象：点播完全正常，但点击首页的“直播”进去后一片空白。
· 原因： 您的 JSON 配置文件里根本没有填写 lives 字段，或者填写的直播源链接已经失效返回 404 错误。
· 处理： 检查配置地址，确保里面正确包含了直播源的文本链接，或者在独立直播设置中补齐直链。


2. 现象：导入 txt 直播源后，左侧频道列表全是乱码字符。
· 原因： 文本文件的编码格式不兼容。您的 txt 文件可能被保存成了 ANSI 或 GBK 编码。
· 处理： 在电脑上用记事本打开该 txt 文件，选择“另存为”，并在底部的编码选项中强制选择 UTF-8 编码，保存后重新上传到您的网络空间。


3. 现象：只有声音没有画面，或者画面严重花屏、绿屏。
· 原因： 电视内置的硬件解码芯片不支持该直播流的编码格式（如老电视不支持 H.265 的源）。
· 处理： 在播放界面的设置（或主设置页面）寻找【解码器】或【播放内核】选项。尝试将默认的“硬解”切换为“软解”，或者在 Exo、IJK、Ali 等不同的播放内核之间进行切换测试。


4. 现象：一直转圈缓冲，或者播放几秒就卡顿跳台。
· 原因： 绝大多数情况下是您的网络带宽不足以支撑高码率直播，或者该频道的源服务器负载过高（俗称“源挂了”）。
· 处理： 直播卡顿 99% 是源的问题，而非播放器的问题。请更换更稳定的同频道源，如果是家庭局域网 IPTV，请检查路由器 IGMP 设置或网线连接质量。


5. 现象：填入了 EPG 链接，但显示的节目单跟现在播出的内容对不上时间。
· 原因： 提供 EPG 数据的接口维护不及时，或者您的电视系统时间设置错误，导致时区对不上。
· 处理： 首先进入系统设置核对电视当前的系统时间和时区。如果时间无误，说明是 EPG 接口提供方的数据有误，这不影响画面，只能更换更好的 EPG 接口源。



五、 注意事项

· 运营商 IPTV 源的特殊性： 如果您提取了自家宽带运营商的组播源地址（如 rtp://... 开头），这种源必须在特定的内网环境下才能播放（例如将盒子网线直接插在光猫的 IPTV 口，或路由器配置了 VLAN 穿透）。如果在普通的互联网 WiFi 下直接填入是绝对无法出画的。
· 链接末尾如果是直接指向 .m3u 文件，部分国产智能系统的安全模块可能会拦截 HTTP 下载，遇到此情况建议将源放置在支持 HTTPS 的服务器或本地群晖上。

六、 相关下载

以下为本教程配套的纯净版播放器空壳及本地直播源测试模板（内置 2 个占位的 txt 格式演示频道，无实际画面，仅供新手体验频道列表解析过程）。请自行下载测试。

· 夸克网盘（免提取码）：https://pan.quark.cn/s/506a1f556866
· 百度网盘：https://pan.baidu.com/s/1ZJlsIF4s0Euc71AyDM0hnw
· 百度提取码：6f33
(注：请在下载后，使用记事本打开压缩包内的 live_sample.txt 查看格式结构，并替换为您合法的真实源使用。)

七、 小结

配置直播源是一项需要一点耐心的工作。它的核心在于“找对合法源”和“保存对编码”。只要掌握了 m3u 或 txt` 两种基础文本格式的编写规律，并学会合理运用软硬解码器切换，您就能通过 TVBox 空壳轻松打造出一个响应极速、换台秒开的定制化家庭直播大屏。配置完成后，建议只用自己有权使用的源做换台测试，确认出画再长期使用。