【教程】多仓和单仓有什么区别？影视仓怎么用

redpear · 发表于 9 小时前

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

多仓和单仓有什么区别？影视仓怎么用

欢迎各位新手朋友回到 tvbox.org 论坛的「知识教程」板块。在之前的教程中，我们学习了基础的安装与单地址配置。随着大家对这类开源播放器的深入了解，您可能在各类技术讨论区频繁看到“单仓”、“多仓”、“影视仓”等术语，甚至在配置时遇到无法加载或界面毫无变化的情况。

对于刚刚接触电视盒子配置的新手而言，理解“单仓”与“多仓”的数据结构差异，是进阶使用的必经之路。同时，“影视仓”作为基于原版二次开发的优质分支版本，在操作逻辑上与原版略有不同，专门针对多仓环境进行了 UI 优化。本篇文章将为您详细定义这两个核心概念，并手把手教您如何在空壳播放器中正确部署和切换多数据源。

郑重提示：无论是原版还是影视仓，它们本质上都仅仅是播放器空壳，安装后不内置任何影视库或接口。 用户必须自行配置自己有权使用的合法服务（例如本地 NAS 索引、开源测试样例等）。本教程仅讨论软件的操作机制，绝不提供、也不暗示任何违规的第三方影视接口，文中所有链接均为说明格式的 example.com 占位示例。

下载安装包

影视仓空壳与多仓格式示例模板（example.com 占位，不是片源）在这里：

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

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

一、概念解析：单仓与多仓到底有什么区别？

要弄懂这两个概念，我们需要从配置文件的内部结构看起。配置地址本质上是一个文本文件，播放器通过读取里面的代码来生成界面。

1. 什么是单仓（单一配置）？

单仓，顾名思义，就是一个配置地址对应着唯一一份完整的功能清单。这份清单里直接包含了点播分类（sites）、直播列表（lives）以及解析规则（spider）。当您把单仓地址填入播放器后，系统直接读取这份清单并展示内容，没有多余的层级。

判断方法：
如果您在电脑或手机浏览器打开这个 .json 链接，看到的第一层代码包含 spider、sites 等字眼，这就是单仓。
单仓结构示例：

{
"spider": "https://example.com/tvbox/spider.jar",
"sites": [
{
"key": "MyNAS",
"name": "我的家庭媒体库",
"type": 3,
"api": "https://example.com/tvbox/api.php"
}
],
"lives": [
{
"name": "本地监控",
"url": "https://example.com/tvbox/live.txt"
}
]
}

复制代码

2. 什么是多仓（仓库合集）？

多仓（或称仓库），实际上是一个“导航目录”。它本身不包含具体的点播或直播列表，而是包含了一组单仓的地址列表。这就相当于一个文件夹，里面存放了多个不同的单仓文件。播放器读取多仓后，会弹出一个列表让您选择当前想要加载哪一个单仓。这极大地避免了用户在多个合法数据源之间频繁复制粘贴地址的麻烦。

判断方法：
如果在浏览器打开链接，看到的是一个名为 urls 的数组，里面只有一串“仓名 + 地址”的组合，这就是多仓。
多仓结构示例：

{
"urls": [
{
"name": "本地NAS点播仓",
"url": "https://example.com/tvbox/config_nas.json"
},
{
"name": "备用测试仓",
"url": "https://example.com/tvbox/config_test.json"
}
]
}

复制代码

二、使用场景建议

· 何时使用单仓： 如果您的家庭网络中只有一台群晖 NAS 提供的媒体库，或者您只维护着一份固定的自建接口，不需要来回切换，直接填写单仓最为稳定、快捷，加载速度也最快。
· 何时使用多仓： 当您的合法数据源较多（例如一个用于内网高清点播，另一个专门用于局域网 IPTV 直播），或者有主备用地址时。配置多仓后，您只需在电视端用遥控器一键切换，无需重新扫码输入。

三、影视仓怎么用？（多仓配置与切换分步演示）

“影视仓”是一个高度适配多仓特性的电视播放器分支（菜单名称可能因版本更新而异，请以实际版本为准）。以下是具体操作流程：

1. 安装空壳并进入设置
按照常规 U 盘安装法安装好影视仓。打开应用，首页依然是空壳状态。使用遥控器移动到右上角的【设置】图标，点击进入。

影视仓主界面右上角进入设置菜单

2. 填写多仓（仓库）地址
在设置菜单中，找到「配置地址」或「仓库数据源」选项。使用遥控器调出输入框，或者扫描屏幕二维码，将您的多仓地址（如 `https://example.com/tvbox/store.json）填入。点击确认，此时系统会自动下载这个“导航目录”。
3. 在界面切换当前仓
这步是多仓操作的核心！填完多仓后，回到首页或者设置页的显眼位置，您会找到一个名为「线路」、「多仓切换」或直接显示当前仓名称的按钮。点击它，屏幕会弹出一个下拉列表，里面展示了多仓文件里定义的所有名称（如“本地NAS点播仓”、“备用测试仓”）。

点击界面上的线路按钮弹出多仓列表

4. 确认加载成功
使用遥控器选中您想使用的具体仓位，按下确认。系统会提示“加载中”。此时回到首页，当您看到顶部的分类标签（如“电影”、“剧集”、“我的NAS”）发生改变并成功显示时，代表切仓成功。

选择具体仓位后，系统提示正在加载配置

切仓成功后，首页根据所选仓位刷新出具体分类标签

四、常见问题排查（FAQ）

在配置多仓时，新手常常遇到以下问题：

1. 现象：填入多仓地址后，界面没有出现“切换”或“线路”按钮。
· 原因： 填入的地址虽然能访问，但并不是标准的 urls 数组结构，系统未能将其识别为多仓；或者使用的播放器版本过旧，不支持多仓格式。
· 处理： 在手机浏览器打开该链接，检查是否为 {"urls": [...]} 结构。如果格式无误，请在设置中强制重启应用，或更新播放器至支持多仓的最新版本。

2. 现象：切仓后，首页依然是一片空白，没有分类。
· 原因： 多仓地址（导航）有效，但您选择的那个具体的单仓地址（目标）已经失效，或者服务器宕机。
· 处理： 在多仓列表中切换另一个备用线路。如果是自建接口，请检查单仓服务器的状态和局域网连通性。

3. 现象：提示加载失败，发现“多仓嵌套（套娃）”。
· 原因： 您在一个多仓的 URL 列表里，填写的不是单仓地址，而是另一个多仓地址，导致播放器无限循环解析，最终超时崩溃。
· 处理： 严格遵守规则：多仓的子节点只能是指向单仓的链接，绝不能多层嵌套。请修改 JSON 文件结构。

4. 现象：一直转圈，最后提示解析 JSON 异常。
· 原因： 您误把一个发布接口的网页地址（HTML）当成了多仓直链填了进去，播放器无法解析网页代码。
· 处理： 确保链接以 .json 或 .txt` 结尾，必须是纯数据直链。

5. 现象：多仓文件过大，导致电视端加载超时。
· 原因： 某些用户将包含几百个地址的超大多仓填入电视，老旧的电视盒子内存和 CPU 无法处理如此庞大的数组。
· 处理： 精简您的多仓文件。在本地电脑上编辑 JSON，只保留自己能打开的、最常用的几个合法地址，去除冗余项，提高加载速度。

五、注意事项

· 影视仓与 TVBox 原版在底层核心上是同源的，但各分支开发者对界面的定制不同。如果您发现某个多仓在 A 软件正常，在 B 软件闪退，多半是 JSON 文件中使用了 B 软件不支持的非标准字段。此时只需保留最基础的配置即可。
· 强烈建议新手从“单仓”开始配置。当您完全理解了站源、解析、播放的运作原理后，再通过“多仓”来管理庞大的家庭配置库，这样遇到问题时更容易定位排错。

六、相关下载

以下为本教程配套的纯净版播放器空壳及本地测试配置模板（不含任何侵权片源，仅供技术研究测试多仓加载逻辑）。请自行下载安装。

· 夸克网盘（免提取码）：https://pan.quark.cn/s/506a1f556866
· 百度网盘：https://pan.baidu.com/s/1ZJlsIF4s0Euc71AyDM0hnw
· 百度提取码：6f33
(注：压缩包内包含通用影视仓 APK 安装包及一份 example_store.json 本地多仓格式示例模板，供您参考数据结构。)

七、小结

单仓是数据的实体，多仓是管理的目录。理解了这一层逻辑，您在使用影视仓等进阶版本时就能游刃有余。通过多仓配置，您可以轻松实现家庭媒体库的主备切换与模块化管理。接下来，请继续阅读下一篇教程，我们将解答另一大痛点：如何独立配置电视直播源（IPTV）。