TVBox 中文文档 下载 App

TVBox 数据源类型全览:爬虫源、XP源、采集源与 m3u 直播源

TVBox 的「源」根据技术原理和数据格式,可以分为四种常见类型。理解它们的区别,就能在遇到某个源失效时快速找同类替代。

JSON 接口源(最常见的点播源)

格式:一个远程 JSON 文件,包含分类列表、剧集详情、播放地址等结构化数据。

运作方式:TVBox 根据接口约定的 JSON Schema 解析这个文件,拿到分类数据后在 UI 上渲染出来。用户浏览分类、进入详情页、点击播放,每一步都是往接口发一个 HTTP 请求,拿到 JSON 响应后解析。

优点:结构清晰、加载速度快、支持完整的分类→详情→播放三步流程。

缺点:需要源提供方维护接口稳定性;如果源站改版导致接口失效,整份源就废了。

爬虫/采集源

格式:一段 JavaScript 代码或一组 XPATH 规则,告诉 TVBox 如何从目标网站 HTML 页面中「爬」出分类链接、详情页信息和播放地址。

运作方式:TVBox 内置 JS 引擎,运行源提供的爬虫脚本,动态请求目标网站页面并解析。这使得它能适配几乎任何公开可访问的网站。

优点:覆盖面广——理论上任何网站都能做成源;灵活性极高,可以处理复杂的动态页面。

缺点:网站一改版(比如换了 HTML 结构、加了反爬),爬虫脚本就需要跟着更新;加载速度比纯 JSON 源慢。

XP 源(XPATH 规则源)

格式:一组 XPATH 表达式,标注在目标页面的哪个位置能找到分类列表、视频标题、播放地址等字段。

运作方式:TVBox 用标准的 DOM 解析器加载页面,然后用 XPATH 表达式在 DOM 树里定位目标元素并提取文本/链接。

优点:规则简洁、易读易写;对于结构稳定的网站非常好用。

缺点:不支持复杂的 JavaScript 动态渲染;网站一改版 DOM 结构就失效。

m3u/m3u8 直播源

格式:一个 .m3u 或 .m3u8 文件(本质是纯文本播放列表),包含频道名称和流媒体地址。

运作方式:m3u 是 IPTV 行业通用的播放列表格式,TVBox 直接按标准解析就能拿到频道列表,点哪个频道就直接播放对应的流媒体地址。

优点:格式最标准、兼容性最好;来源也最多——运营商 IPTV、第三方直播服务、自建频道都能输出 m3u。

缺点:只支持直播,不支持点播;单个 m3u 文件只能包含直播频道。

类型对比速查表

类型适用内容格式稳定性维护难度
JSON 接口源点播影视JSON 远程文件中(依赖接口方)低(使用现成接口)
JS 爬虫源点播影视JavaScript 脚本中低(网站改版风险)中(需要脚本能力)
XP 源点播影视XPATH 规则低(网站改版风险)低(规则易写)
m3u 直播源电视频道m3u 文本高(标准协议)低

混合使用

一个活跃的 TVBox 配置通常同时包含多种类型的源:几个 JSON 接口源覆盖主要点播、一个 m3u 源接入直播、必要时再加一两个 JS 爬虫源补充冷门资源。没有哪个类型是最好的,覆盖范围越大越好。

下一页

现在知道源有哪些类型了,接着看看TVBox 和同类壳(影视仓、OK影视、酷9等)有什么不同——为什么要选它而不是别的。