TVBox 配置与播放常见问题解答

不一定。TVBoxOS 项目通过配置描述内容来源，空界面也可能只是还没有可用配置。应先确认安装版本、配置类型及提供方说明；软件安装成功与内容来源可访问是不同环节，安装包本身并不保证内置节目。

1. 在设置中查看软件版本与现有配置状态，核对它是否属于所用教程对应的 TVBox 分支。
2. 根据配置提供方的说明填写地址，先确认该地址返回的是所需配置内容。
3. 保存并重新载入；若出现明确解析错误，先检查格式与地址，不重复下载来源不明的安装包。

要看具体分支和输入栏。项目 JSON 可以包含多类内容字段，M3U 则是直播列表；站内参考的 TVBoxOS 支持多种列表解析。不能因为两者都是网址，就把列表填进只接受项目配置的位置。

1. 先对照站内 TVBoxOS 教程确认软件分支、配置弹窗与直播输入栏。
2. 根据手中内容是项目 JSON 还是 M3U/TXT 直播列表，选择对应入口。
3. 列表文件核对扩展格式与实际正文一致，保存后进入直播页面检查频道分组是否载入。

显示频道名只说明列表已经被识别，不表示其中的视频地址此刻可用。地址失效、接入条件、格式兼容或网络异常都可能导致加载失败。先对单个地址做对照，再决定是更新来源还是调整播放器，避免直接清空配置。

1. 比较多个频道，记录是全部无法播放还是少数节目异常。
2. 从同一份列表取一个自己可使用的媒体地址，在 VLC 等播放器的网络串流功能中测试。
3. 所有播放器都失败时向来源方核对地址和访问条件；只有当前播放器失败时再按版本说明检查播放内核。

应先看电视系统架构，再看配置是否依赖 Python。该提交将 Java、Python 与 32/64 位分别打包；64 位处理器不等于电视系统能运行 64 位应用，包名相似也不能代替兼容性检查。

1. 确认电视的 Android 版本与 ABI；32 位为 armeabi-v7a，64 位为 arm64-v8a，不能仅看处理器介绍。
2. 该提交声明 java32/python32 最低 API 19，java64/python64 最低 API 21；Python 插件为 12.0.1，其他打包版需核对 APK。
3. 配置明确依赖 Python 时选对应构建；把普通 Java 包重命名，不会增加 Python 运行环境。

先确认新旧 APK 的包名、签名来源和版本要求。Android 的普通覆盖更新要求应用身份与签名兼容；同名的不同作者打包版可能无法互相覆盖。保留数据的稳妥顺序是先备份，再使用同一发布渠道的兼容更新包。

1. 记录当前应用的完整名称、版本和发布者；在下载页确认新包属于原来的分支与签名渠道，而不是只看“TVBox”几个字。
2. 先运行应用内备份，把备份目录复制到电脑或 U 盘并保留当前 APK；没有备份前，不要把卸载作为第一步。
3. 若必须更换签名，按新项目的迁移说明操作；备份是否能跨分支恢复还取决于数据库与设置格式，不能保证全部迁移。

该提交提供应用内备份与恢复，备份目录位于外部存储根目录的 tvbox_backup，下一级按时间区分。备份包含应用数据库和设置数据；它不会自动把远程服务器上的配置、视频或所有外部依赖一起离线保存。

1. 进入设置中的备份功能，按提示授予存储权限后执行备份；完成后确认目录内实际生成了时间子目录，而不只看按钮是否点过。
2. 把整个时间子目录复制到电脑或 U 盘保留；源码使用 sqlite 与 hawk 两部分数据，不要只拷走其中一个文件。
3. 恢复前先备份新设备现有数据，再按同一分支的恢复入口选择备份；远程地址失效、站点撤下或登录过期仍需另行处理。

浏览器能打开网页，不代表返回的是所需的配置正文。常见情况包括仓库文件展示页、登录页、错误页或跳转后的 HTML；配置读取需要符合当前分支格式的数据，HTTP 请求成功也不等于解析成功。

1. 在电脑浏览器查看最终地址与返回正文；确认内容是配置对象，而不是带导航栏的 GitHub 文件展示页或账号登录页面。
2. 从配置维护者提供的原始文件入口获取地址，核对协议、路径、大小写和查询参数；不要把教程文章网址当成配置地址。
3. 若同一地址手机可读、电视不可读，继续检查电视时间、域名解析和网络连接；若返回正文已是错误页，应先修复服务端地址。

该提交会跳过缺少 key、type 或 api 的站点，并按 key 保存站点。缺字段、把数组写成对象或重复 key，都可能造成站点列表不完整；站点显示名相同与内部标识冲突也要分别检查。

1. 用 JSON 校验工具检查括号、引号、逗号和数据类型，确认顶层 sites 是数组；先保留一个自建测试站点缩小排查范围。
2. 逐个检查站点的 key、type、api；key 使用稳定且唯一的值，不要把多行配置都复制成同一个内部标识。
3. 修复后重新加载配置，比较站点数量和首页数据源列表；如果字段齐全但内容为空，再检查对应接口或扩展是否返回了分类。

Spider/JAR 是部分站点使用的扩展代码依赖，配置地址能访问并不能证明它也下载成功。应把配置读取、JAR 文件取得、扩展兼容和站点请求分开检查；更换播放器通常不能解决扩展还没有加载成功的问题。

1. 检查配置的 spider，以及单独站点可能声明的 jar，确认实际地址返回有效文件，没有变成 404、登录页面或空内容。
2. 核对扩展维护者要求的客户端分支和版本；同样写成 type 3 的站点，也可能依赖不同扩展接口，不能任意混用。
3. 记录完整加载错误，备份设置后尝试应用内清理缓存并重新加载；如错误来自新扩展本身，向维护者提供客户端版本与报错。

相对路径以配置文件地址为基准。把 JSON 单独搬到其他目录或服务器后，./your.jar、../目录/文件等依赖地址也会改变；即使 JSON 能读取，扩展和图片仍可能指向不存在的位置。

1. 列出配置中以 ./ 或 ../ 开头的依赖，将它们按配置文件的新目录逐一解析，检查每个最终地址是否能直接读取。
2. 迁移时保留原目录层级，或把依赖改成维护者提供的完整地址；修改前保存一份原始配置，方便比较路径变化。
3. 本地文件也要保留依赖目录，并确认 TVBox 有权限访问；仅通过文件选择器复制一个 JSON 不代表其相邻文件也一并复制。

该提交有 JAR 缓存逻辑，并支持在 spider 值中携带 ;md5; 校验信息。服务器只替换文件内容而地址不变时，客户端可能仍使用缓存；是否重新下载还受到缓存设置、文件时间和校验值等条件影响。

1. 先确认配置正文确实更新，核对维护者公布的 JAR 地址与校验值；有校验值时，应与服务器上的新文件对应。
2. 保存当前配置后，使用应用内清理缓存并重新打开，让客户端重新取得依赖；不要直接清除整个应用数据来代替清缓存。
3. 若重新获取后依旧报错，分别核对下载内容和扩展兼容性；缓存更新成功不会自动修复服务端发布了错误文件的问题。

此提交能识别含 urls 数组且没有 sites 的配置集合，并保存线路选择列表；sites 则描述一份配置中的站点。因此不能笼统说所有 TVBox 都不支持多线路，旧版及其他分支需另行核对。

1. 先核对安装包对应分支与构建日期；若使用旧版教程或不同作者的多仓格式，不能仅凭文件扩展名为 JSON 判断兼容。
2. 自建集合中使用 urls 数组列出名称和地址；其中每条地址还必须能够独立加载，集合可读不代表所有线路都有效。
3. 导入后先选中首条含非空地址的记录，并不预先探测网络可用性；再到设置选择其他线路，并检查直播配置是否需要调整。

该提交在配置窗口提供本地文件选择，并把可访问路径转换为本地配置地址；某些文档来源会先复制到应用能够读取的位置。文件选择成功、存储权限允许以及依赖文件可读取，是三个需要分别确认的条件。

1. 进入配置地址窗口，使用对应的本地文件入口选择自己的 JSON；按电视系统提示授予文件或存储访问权限。
2. 出现读取失败时，先把完整配置目录复制到电视可访问的公共存储目录再选一次，并核对文件没有被额外加上 .txt 后缀。
3. 若 JSON 引用了同目录 JAR 或图片，也一并保留并检查相对路径；不同电视对 U 盘文档路径的提供方式可能不同。

该提交的配置窗口会显示本机地址与二维码，手机或电脑浏览器可打开局域网页面填写配置。这里传送的是配置地址或播放请求，并不是在给电视远程安装 APK；电视上的 TVBox 要先打开并保持可连接。

1. 让手机、电脑与电视接入能互相访问的家庭局域网，打开电视 TVBox 的配置地址窗口，读取当次显示的二维码或地址。
2. 在浏览器打开该地址，进入配置区域，把自己的完整点播或直播配置地址粘贴到对应输入框后提交，不要放进播放推送框。
3. 回到电视确认配置已更新并检查站点列表；若电视重连网络或重启路由器，应重新读取屏幕地址，不能一直沿用旧 IP。

以电视当次显示的完整地址为准。此实现默认从 9978 端口启动，端口被占用时还会继续尝试其他端口；此外，访客网络、终端隔离或不同路由器网段，都可能让连接同名 Wi-Fi 的设备无法互访。

1. 保持 TVBox 打开，重新查看配置窗口地址，完整输入 http 协议、电视 IP 和实际端口；不要把手机自己的 IP 填进去。
2. 确认手机未通过蜂窝数据访问内网地址，电视和手机不处于互相隔离的访客网络；有线电视与无线手机也可以互通，前提是路由配置允许。
3. 在同一路由器下用另一台电脑访问作对照；如果电视重启后端口或地址改变，更新保存的链接，再检查路由器的设备隔离设置。

此提交的配置窗口同时保存点播和直播地址，但当点播地址发生变化时，保存逻辑会先把直播地址同步为新的点播地址。因此同时修改两个输入框不一定得到预期结果；需要分两次确认并检查最终保存值。

1. 先记录原有独立直播地址，完成点播配置切换并确认保存，让应用加载新的点播内容。
2. 再次打开配置窗口，保持点播地址不变，只修改直播地址，然后确认保存；重新进入窗口核对它没有被再次覆盖。
3. 切换历史配置或多线路后也检查直播地址，因为这些入口同样可能同步更新；若使用其他分支，应以该分支实际保存行为为准。

站点已经导入，不代表首页会同时列出所有站点的内容。此提交分别设置首页数据源与首页列表数据：前者决定使用哪个站点，后者决定展示推荐、历史等内容。首页空白时应先确认选中的站点和列表模式。

1. 进入设置的首页数据源，检查目标站点是否存在，并选择一个能正常返回分类和内容的站点作对照。
2. 再核对首页列表数据的选项；如果展示历史，而设备尚未产生播放记录，不能据此认定整份配置没有加载。
3. 如果只有某个站点空白，到该站点分类或搜索入口继续验证；全部站点都不存在时，回到配置结构与加载错误排查。

搜索范围既受站点配置中的 searchable 开关影响，也受用户勾选的搜索站点影响。此提交还会按配置地址保存搜索选择；站点能在首页打开，不代表它已经允许并参与全局搜索，需要依次核对两层开关。

1. 打开搜索页面的站点选择窗口，检查目标站点是否被勾选；切换配置后再确认当前配置对应的选择状态。
2. 如果目标站点根本不出现在可选列表，自建配置时核对 searchable；该提交会跳过明确关闭搜索的站点。
3. 先用确定存在的简短片名测试，再检查站点自己的搜索接口是否正常返回；勾选开关不能给没有搜索能力的扩展增加功能。

聚合搜索需要逐个站点取得结果，站点多、接口慢或扩展等待都会增加时间。此提交使用有限并发执行搜索，不能把全部等待都归为电视性能差；先缩小参与搜索的站点，比同时更换所有网络和播放器设置更易定位。

1. 在搜索站点选择中只保留少量确认可用的站点，用同一个关键词重新搜索，观察首批结果是否明显加快。
2. 逐步加回其他站点，记录是哪一组使等待增加；同时核对该站点在首页和独立搜索时是否也缓慢。
3. 需要反馈时记录关键词、站点数量、客户端版本与超时表现；播放器负责播放阶段，通常不会直接修复站点搜索请求的等待。

详情快速搜索围绕当前片名寻找候选内容。该提交同时检查 searchable 和 quickSearch，并处理标题关键词；它与手动输入的全局搜索入口不同，站点范围或搜索词不同，结果也可能不同。

1. 先比较详情页使用的标题与手动输入的关键词，留意季数、年份、标点和别名造成的差异。
2. 对自建站点配置分别检查 searchable 与 quickSearch；前者允许普通搜索，不意味着后者一定也已经打开。
3. 需要精确查找时退回全局搜索，输入简短片名并限定站点；候选结果仍要核对年份、集数和具体版本，避免选错同名作品。

分类筛选需要客户端允许显示，也需要站点或扩展返回相应的筛选数据。filterable 并不是自动生成影片年份与地区的开关；如果站点没有提供这些字段，单纯修改一个数字不能凭空补出完整筛选列表。

1. 先在同一客户端切换到确实提供筛选数据的站点，判断是客户端界面问题，还是仅目标站点缺少对应能力。
2. 自建配置时核对该站点的 filterable、type 和扩展要求；此提交对部分 Python 标识有独立处理，不能照搬所有旧配置说明。
3. 界面允许筛选但选项仍为空时，检查接口或扩展返回数据；向站点维护者反馈具体分类与期望字段，避免反复重装客户端。

全局默认播放器与当前影片保存的播放设置不是同一层。该提交的播放控制栏可以切换当前播放器，长按还能打开选择列表；外部播放器只会在检测到对应应用等条件满足时出现，不是点一下就会自动安装。

1. 先在当前播放控制栏查看正在使用的播放器，点击切换，或长按播放器按钮打开列表，再重播同一视频对照。
2. 需要今后默认使用某个内核时，再到设置修改默认播放器；已保存的影片设置或站点指定 playerType 仍可能影响当前选择。
3. 使用 VLC、Kodi 或 MX 等外部播放器前先安装对应应用，再重新启动 TVBox 检查列表；外部播放后的字幕和进度能力取决于调用支持。

IJK 硬解与软解的效果取决于视频编码、芯片与驱动。硬解常用于减轻处理器负担，软解可作兼容性对照，但不保证高分辨率流畅；切换到 EXO 后，IJK 选项也不等于在控制 EXO。

1. 记录发生问题的同一段视频，确认当前播放器是 IJK，再分别测试硬解与软解，比较画面、声音和播放速度。
2. 软解能正常显示但明显卡顿时，降低视频分辨率或码率继续测试；这更有助于区分解码兼容与设备性能限制。
3. 如两种方式均失败，再用 EXO 对照，并记录视频编码和电视型号；不要每次同时更换配置、线路和解码方式，否则难以判断原因。

有声音而画面异常时，也可检查渲染方式。该提交提供 SurfaceView 与 TextureView 两种设置，涉及画面显示路径；它与取得播放地址属于不同阶段，不能当成所有黑屏的统一解法。

1. 先确认视频已经开始播放并有声音，记录问题只出现在小窗、全屏、切换界面后，还是从第一帧起就一直黑屏。
2. 在设置的默认渲染方式中切换 SurfaceView 与 TextureView，再重新打开同一段视频；同时记下当前播放器与解码选项。
3. 只有某种组合正常时保留该组合；若所有组合均失败，继续用已知可用的视频检查编码能力，并核对是否根本没有取得视频流。

此提交提供 IJK 缓存播放开关，但缓存不是带宽加速器。首次获取数据仍受网络和服务端限制；本地存储、播放内核与具体视频也会影响效果。应该用同一视频对照判断，不要把开启缓存当作所有卡顿的固定答案。

1. 先确认当前确实使用 IJK，并观察卡顿时是下载速度不足、画面掉帧还是特定位置重复停顿，这几类问题处理方向不同。
2. 检查电视可用存储，在保持同一片源和网络的条件下分别测试开关状态；必要时用较低码率视频对照网络与解码压力。
3. 缓存异常可用应用内清理缓存后重试；如果其他设备在同一网络播放同一服务也很慢，应继续检查网络或服务端而不是不断改缓存。

切换语言的前提是当前视频确实包含多条音轨，而且所用内核能识别。该提交在 IJK 与 EXO 路径读取音轨信息并提供选择；单音轨视频不会通过设置变成双语，换到外部播放器时则要使用外部应用自己的音轨菜单。

1. 先让视频成功起播，再打开播放控制栏的音轨入口，查看实际列出的语言或轨道名称，选择后等待声音恢复。
2. 只有一项或提示没有音轨时，用同一文件在其他支持轨道信息的播放器核对；流媒体服务也可能只下发了当前一种语言。
3. IJK 与 EXO 的识别结果不同时分别测试并记录版本；若需要另一语言但文件本身没有对应音轨，应换成包含该音轨的视频版本。

内置字幕是视频内部的字幕轨道，外挂字幕则是单独的字幕文件。该提交分别提供内置字幕选择、本地文件和远程字幕入口；先分清字幕来源，才能判断是没有轨道、文件未读到，还是所选内核不支持对应格式。

1. 视频起播后打开字幕设置；有内置字幕时进入轨道列表选择，需要自己的字幕文件时使用本地文件选择入口。
2. 确认字幕与影片版本、集数和时长一致，文件可被 TVBox 读取；从手机传过去后仍需在电视中选中该文件。
3. 不显示时分别核对字幕是否已关闭、轨道是否存在以及文件内容是否有效；使用外部播放器时，到外部应用内重新确认字幕选择。

字幕设置提供时间调整与字号选项，该提交的时间按钮以半秒为步进；实际效果还取决于字幕类型和播放内核。固定偏移可调延迟，越播偏差越大的字幕则可能匹配了不同剪辑或帧率版本，单次平移无法完全解决。

1. 选择一句容易对照的对白，在字幕设置中以小幅度调整时间，边播放边观察方向，直到这一处基本同步。
2. 再检查影片前、中、后几个位置：若都相差同样时间，继续微调；若偏差持续扩大，应重新选择与视频版本匹配的字幕。
3. 字号、位置等选项逐项调整；EXO 内置字幕与外挂字幕的显示实现不同，某项不可用时检查字幕类型，不要据此认定文件坏了。

该提交提供默认、16:9、4:3、填充、原始和裁剪等比例模式。填充与裁剪可能改变画面覆盖方式；要先恢复默认再判断片源本身的比例，不能为了消除黑边就认为所有视频都应该强制拉成 16:9。

1. 在当前播放控制栏打开比例选项，先恢复默认并观察人脸、圆形物体和画面边缘是否正常，避免把黑边本身当成播放错误。
2. 若只有这一部片异常，核对该视频的原始比例；若整个电视界面也被切边，再去电视图像设置检查画面适配或扫描模式。
3. 需要改变今后的默认比例时，再到应用设置修改默认画面缩放；此前保存的当前影片设置也要一并核对。

片头片尾跳过时间设置不合适，会导致开头被跳过或结尾提前结束。该提交可以按当前播放位置记录片头时间，并提供片头片尾重置；不同版本、特别篇或片长不同的剧集不一定适合共用同一组跳过值。

1. 出现提前结束时，先在播放控制栏重置片头片尾时间为零，再重播问题剧集，确认是否由跳过设置造成。
2. 需要设置片头时，把进度移到真正的正片起点后使用片头按钮；片尾则按当前界面提示设置，并核对显示的时间。
3. 遇到特别篇、长短不一的集数或换了剪辑版本，重新检查跳过值；不要把带预告或花絮的末尾都当成可以跳过的片尾。

该提交的倍速按钮可以打开速度选择，长按按钮会恢复 1 倍速。倍速是否流畅还取决于播放内核、解码与网络供给；高倍速下容易卡顿并不自动说明视频文件损坏，外部播放器的速度也可能需要单独调整。

1. 在当前播放控制栏打开倍速列表，先从较接近正常速度的选项测试，观察画面和声音是否同步。
2. 需要恢复时选择 1.0 倍，或在此提交的界面长按倍速按钮；重开同一影片后再确认保存的速度是否符合预期。
3. 高倍速卡顿时退回 1 倍作对照，并检查网络与解码能力；已经跳转到 VLC、Kodi 等外部应用时，在外部应用里修改速度。

该提交有保留历史记录数量和历史合并选项。记录减少可能来自数量限制，类似条目合并则与合并规则有关；这与搜索关键词历史又是不同的数据。先核对相关设置，再判断是否真的发生了数据库或备份恢复问题。

1. 进入设置查看保留历史记录数量，确认当前上限是否小于自己的实际观看条目；首页显示的数量也不一定等于全部历史。
2. 检查历史合并开关，观察同名或关联记录是否按当前规则合并；需要比较多个站点记录时，先记录原状态后再做对照。
3. 换设备、恢复备份或更换分支后缺失记录时，核对使用的备份时间与应用包名；清空应用数据或卸载之前先保存备份。

应用内清理缓存针对当前实现指定的缓存与扩展缓存，并会回到主页或重启应用；系统清除数据则会重置应用保存的数据。两者影响范围不同，遇到加载问题时不要在没有备份的情况下把清除数据当作同一个按钮使用。

1. 先记录配置地址、当前版本并做应用内备份；尝试应用自己的清理缓存入口，等待它完成后重新加载。
2. 清缓存后仍失败时，记录具体报错继续区分网络、配置和扩展问题，不要因为没有立刻恢复就连续执行清除数据。
3. 确需完整重置时，先把备份复制到应用之外并确认可用；不同电视系统的按钮名称接近，应仔细看清是缓存还是全部数据。

此提交提供应用默认进入直播或点播的选项，可用于已经配置好直播的设备。但“打开应用后进入直播”和“电视开机自动启动应用”是两件事；后者还受电视桌面、系统自启动权限和厂商策略影响。

1. 先手动进入直播，确认独立直播配置能正常加载并有可用频道；直播本身失败时，不要先排查启动入口。
2. 在应用设置中找到默认进入直播或点播的选项，切到直播后完整退出应用再打开，验证实际启动行为。
3. 如需电视开机后自动打开 TVBox，再检查该品牌的桌面和自启动设置；应用里的这一开关并不等于自动取得系统开机启动权限。

嗅探负责取得播放地址，播放器负责后续解码；卡在前一阶段时，换 IJK 或 EXO 不一定有效。此提交保留系统 WebView 与 XWalkView 选项，但可用性取决于构建、组件和站点规则。

1. 先确定是停在取得播放地址之前，还是地址已取得但黑屏；保留提示文字，并用同配置中不依赖该嗅探流程的自有测试内容对照。
2. 检查电视系统 WebView 是否可正常运行；只有当前构建提供并能安装对应组件时，才按界面提示测试另一种 WebView。
3. 若仅某站点受影响，核对扩展的嗅探规则与请求要求；网页改版、登录条件或服务限制需要站点适配，不能靠随意添加解析地址保证修复。