TVBox 使用文档：从空壳播放器到私人影视中心的完整指南
关于本站：第三方整理的中文文档站，非官方页面；内容来自公开资料整理，功能与界面以官方最新版为准。
TVBox 是一款发布在开源社区的安卓 TV 播放器，它和市面上任何自带内容的视频 App 走的是完全相反的路子：安装包里不带任何影视资源，只提供一套干净的播放框架——搜索、播放、直播、收藏，全都要靠你自己「接入数据源」才转得起来。接好之后，一次搜索能同时问遍多个影视站点，同一部剧的多条解析线路随你切换，直播频道也能和点播在同一界面里观看。
这套文档按真实使用的先后顺序展开：先弄清「壳」这个字到底是什么意思、有哪些类型的源可以接；再装好应用、接上第一份接口；接着分类浏览、搜索、进入播放器；然后把想看的剧收藏起来、把常看的直播频道攒进列表；最后是本地文件播放和按症状组织的排错手册——装不上、源空白、播放失败、直播卡顿，每一篇都从最可能的原因查起。
产品档案速览
| 项目 | 情况 |
|---|---|
| 软件名 | TVBox |
| 类型 | 安卓平台开源 TV 播放器壳（不含内置内容） |
| 内容来源 | 由用户配置数据源接口后，从各影视站点聚合获取 |
| 收费 | 免费、无广告、无会员门槛 |
| 主要功能 | 聚合搜索、多源点播、直播频道、内置播放器、收藏历史、本地播放 |
| 核心特色 | 多解析线路切换、JS 爬虫源支持、聚合模式搜索 |
| 运行方式 | 纯单机运行，数据源可配置为公开接口或自建服务 |
| 平台 | 面向安卓 5.0+；主要适配智能电视/盒子，手机也可使用 |
结构导览
- 认识TVBox：还没装的朋友从这里起步——它为什么是空壳、源有哪些类型。
- 安装与初始配置：下载渠道、手机和盒子两条安装路径、首次打开看到空白首页意味着什么。
- 数据源与接口配置：本站分量最重的一组——什么是源、怎么加接口、m3u 直播源格式、JS 爬虫源。
- 点播与搜索：配好源之后怎么找剧——分类浏览、聚合搜索一次问遍所有源。
- 播放器操作：全屏、倍速、跳过片头片尾、多解析线路切换、导入本地字幕。
- 直播频道：直播源的补充方法、频道列表与分组管理。
- 收藏与历史：把追的剧攒进收藏、观看历史与继续观看。
- 本地功能：直接播放本地视频文件、局域网共享访问。
- 排错与常见问题：按症状查原因，装不上、源空白、播放失败各自独立排查。