智能TV大全SMART TV GUIDE 下载中心
中文资料

TVBox 与配置：中文说明与原始出处

下面是根据引用资料整理的中文操作说明和关联教程，可在本站阅读。它们是本站整理，并非原网站的完整译本。

查看全部中文资料

项目资料

来源：github.com · 整理 2026-09-15

TVBox 打开后没有频道和影片，是不是软件没装好？

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

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

以 q215613905/TVBoxOS 为参考；其他分支菜单与配置能力可能不同。

查看完整问答与其他依据

TVBox 的配置地址能直接填 M3U 吗？直播地址和 JSON 有什么区别？

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

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

TVBoxOS 指定参考实现；功能不得推定适用于全部同名应用。

查看完整问答与其他依据

TVBox 的 java、python、32 位、64 位安装包应该怎么选？

应先看电视系统架构，再看配置是否依赖 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 运行环境。

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
TVBox 更新提示签名不一致、应用未安装，怎样保留原来的设置？ TVBox 怎么备份配置、收藏和播放记录，备份文件保存在哪里？ TVBox 配置加载失败，浏览器却能打开这个网址，是什么原因？ 自建 TVBox JSON 配置能导入，但站点不显示或少了几个怎么办？ TVBox 提示 Spider 或 JAR 加载失败，应该检查哪些地方？ TVBox 配置里的 ./ 和 ../ 是什么意思，移动 JSON 后为什么失效？ TVBox 配置已经更新，为什么仍像在运行旧的 JAR？ TVBox 能导入多线路配置吗，urls 和 sites 有什么区别？ TVBox 怎样读取 U 盘或本地 JSON，提示读取本地配置失败怎么办？ 不用遥控器打字，怎样用手机或电脑把配置地址推送给 TVBox？ 手机打不开 TVBox 的 9978 地址，同一个 Wi-Fi 也连不上怎么办？ TVBox 改完点播配置后直播也变了，怎样保留独立直播地址？ TVBox 导入很多站点，首页为什么只显示其中一个？ TVBox 搜索不到某个站点的内容，怎样检查搜索范围？ TVBox 聚合搜索一直转圈、结果出来很慢，怎样缩小排查范围？ TVBox 详情页的快速搜索与首页搜索，为什么结果不一样？ TVBox 某个站点没有年份、地区、类型筛选，能在设置里强行打开吗？ TVBox 怎么切换 IJK、EXO 或外部播放器，为什么改了默认仍没变？ TVBox 的 IJK 硬解码和软解码怎么选，花屏时怎么测试？ TVBox 有声音但黑屏，SurfaceView 和 TextureView 可以怎么排查？ TVBox IJK 缓存播放要不要开，缓冲慢是不是缓存越大越好？ TVBox 怎么切换国语粤语音轨，提示没有音轨怎么办？ TVBox 怎样加载本地字幕，内置字幕和外挂字幕有什么不同？ TVBox 字幕太早、太晚、太小，在哪里调时间和字号？ TVBox 画面被拉宽、字幕被切掉，画面缩放怎么恢复？ TVBox 怎样跳过片头片尾，为什么还没看完就自动下一集？ TVBox 怎么设置倍速，声音变快后如何恢复正常速度？ TVBox 播放历史变少、同名影片只剩一条，在哪里检查？ TVBox 的清理缓存和电视系统里的清除数据，有什么区别？ TVBox 能打开后直接进入直播吗，能代替电视开机自启动吗？ TVBox 提示正在嗅探但始终不播放，切换系统 WebView 有用吗？

本站相关教程

TVBox 社区版从安装到遥控器操作，先了解 TVBox 的基本使用方式。 查看TVBox 社区版的设备兼容信息、项目来源、下载入口与电视安装步骤。TVBox 社区版 电视安装教程：下载到首次使用适用于Android TV / 安卓机顶盒。按照来源核对、安装与首次设置的顺序，完成 TVBox 社区版 的电视端使用准备。TVBox 新手指南：安装、设置与第一次播放认识播放器、版本和配置，建立清晰的使用顺序。电视直播，按你家的设备来选。按设备选择电视直播观看方法，查看 IPTV、有线电视、DTMB、官方直播、手机投屏及 Kodi、VLC、TVBox 播放教程，查找央视与卫视入口。TVBoxOS 直播地址导入：M3U、TXT 与 JSON 示例这个 TVBoxOS 分支提供独立直播输入框，可以直接读取 M3U、TXT、数组 JSON 列表，也可读取含 lives 配置的 JSON。
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS

CatVodOpen 历史发布位置（本次返回 404）

来源：github.com · 整理 2026-09-15

猫影视 CatVodOpen 原项目打不开，还能照旧教程导入 TVBox 配置吗？

本次访问历史 CatVodOpen 发布地址返回 404，无法据此核实当前维护状态或推荐所谓最新版。旧猫影视 TV、CatVodOpen 与 TVBox 不应视为同一配置格式；是否兼容必须对照你实际安装版本的维护说明。

  1. 记录应用关于页面中的完整名称与平台，区分电视版、手机和桌面客户端；同名打包并不等于同一项目。
  2. 先保留现有配置副本，再查该版本说明是否明确接受 TVBox JSON、脚本包或某种专用配置；没有说明就不要直接替换。
  3. 历史仓库打不开时，将状态记为“来源待确认”；缺失文件、配置报错与服务失效应分别记录，不能用不明整合包替代诊断。

历史 catvod/CatVodOpen 与 CatVodTVSpider 地址在本次核验返回 404；未推断其已经永久停更。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/catvod/CatVodOpen/releases

okjack 当前公开仓库列表

来源：api.github.com · 整理 2026-09-15

OK影视 Pro、普通版和模拟器版有什么区别，能照网上功能表选择吗？

这些名称常见于下载转载，但功能、激活方式与设备适配会随具体发行版变化。本次未取得可完整核验的当前维护者版本表，不能把转载说法当保证；应先核对同一版本的原始说明再决定安装哪一种。

  1. 从现有应用关于页找到维护者入口，核对同一发布日期的版本说明。
  2. 分别确认电视遥控器、手机触控或电脑模拟器的适配，以及新增功能的使用条件。
  3. 先保留普通版备份，实际验证需要的功能后再决定是否迁移。

OK影视渠道与兼容性核验，2026-09-15；没有把 FongMi 5.6.3 功能表当作 OK影视当前功能。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://api.github.com/users/okjack/repos

TVBoxOS：M3U、TXT 与 JSON 直播列表解析实现

来源：github.com · 整理 2026-09-15

TVBox 的配置地址能直接填 M3U 吗？直播地址和 JSON 有什么区别？

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

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

TVBoxOS 指定参考实现；功能不得推定适用于全部同名应用。

查看完整问答与其他依据

TVBox 已显示频道名称，点进去却一直转圈怎么办？

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

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

已成功载入列表的 TVBoxOS；排查结论需通过实际对照确认。

查看完整问答与其他依据

本站相关教程

TVBoxOS 直播地址导入：M3U、TXT 与 JSON 示例这个 TVBoxOS 分支提供独立直播输入框，可以直接读取 M3U、TXT、数组 JSON 列表，也可读取含 lives 配置的 JSON。
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/util/live/TxtSubscribe.java

q215613905/TVBoxOS · build.gradle

来源：github.com · 整理 2026-09-15

TVBox 的 java、python、32 位、64 位安装包应该怎么选？

应先看电视系统架构，再看配置是否依赖 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 运行环境。

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 更新提示签名不一致、应用未安装，怎样保留原来的设置？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/build.gradle#L25-L97

TVBoxOS · pyramid 模块 minSdk 与 Python 配置

来源：github.com · 整理 2026-09-15

TVBox 的 java、python、32 位、64 位安装包应该怎么选？

应先看电视系统架构，再看配置是否依赖 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 运行环境。

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/pyramid/build.gradle#L1-L25

TVBoxOS · 固定 Chaquopy 12.0.1 插件版本

来源：github.com · 整理 2026-09-15

TVBox 的 java、python、32 位、64 位安装包应该怎么选？

应先看电视系统架构，再看配置是否依赖 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 运行环境。

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/build.gradle#L18-L26

q215613905/TVBoxOS · BackupDialog.java

来源：github.com · 整理 2026-09-15

TVBox 更新提示签名不一致、应用未安装，怎样保留原来的设置？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 怎么备份配置、收藏和播放记录，备份文件保存在哪里？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 的清理缓存和电视系统里的清除数据，有什么区别？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/dialog/BackupDialog.java

q215613905/TVBoxOS · ModelSettingFragment.java

来源：github.com · 整理 2026-09-15

TVBox 怎么备份配置、收藏和播放记录，备份文件保存在哪里？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 配置里的 ./ 和 ../ 是什么意思，移动 JSON 后为什么失效？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 配置已经更新，为什么仍像在运行旧的 JAR？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
TVBox 能导入多线路配置吗，urls 和 sites 有什么区别？ TVBox 怎样读取 U 盘或本地 JSON，提示读取本地配置失败怎么办？ TVBox 改完点播配置后直播也变了，怎样保留独立直播地址？ TVBox 导入很多站点，首页为什么只显示其中一个？ TVBox 的 IJK 硬解码和软解码怎么选，花屏时怎么测试？ TVBox 有声音但黑屏，SurfaceView 和 TextureView 可以怎么排查？ TVBox IJK 缓存播放要不要开，缓冲慢是不是缓存越大越好？ TVBox 画面被拉宽、字幕被切掉，画面缩放怎么恢复？ TVBox 播放历史变少、同名影片只剩一条，在哪里检查？ TVBox 的清理缓存和电视系统里的清除数据，有什么区别？ TVBox 能打开后直接进入直播吗，能代替电视开机自启动吗？ TVBox 提示正在嗅探但始终不播放，切换系统 WebView 有用吗？
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/fragment/ModelSettingFragment.java

q215613905/TVBoxOS · ApiConfig.java

来源：github.com · 整理 2026-09-15

TVBox 配置加载失败，浏览器却能打开这个网址，是什么原因？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

自建 TVBox JSON 配置能导入，但站点不显示或少了几个怎么办？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 提示 Spider 或 JAR 加载失败，应该检查哪些地方？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
TVBox 配置里的 ./ 和 ../ 是什么意思，移动 JSON 后为什么失效？ TVBox 配置已经更新，为什么仍像在运行旧的 JAR？ TVBox 能导入多线路配置吗，urls 和 sites 有什么区别？ TVBox 怎样读取 U 盘或本地 JSON，提示读取本地配置失败怎么办？ TVBox 导入很多站点，首页为什么只显示其中一个？ TVBox 详情页的快速搜索与首页搜索，为什么结果不一样？ TVBox 某个站点没有年份、地区、类型筛选，能在设置里强行打开吗？ TVBox 怎么切换 IJK、EXO 或外部播放器，为什么改了默认仍没变？

本站相关教程

TVBoxOS 直播地址导入：M3U、TXT 与 JSON 示例这个 TVBoxOS 分支提供独立直播输入框，可以直接读取 M3U、TXT、数组 JSON 列表，也可读取含 lives 配置的 JSON。
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/api/ApiConfig.java#L193-L257

q215613905/TVBoxOS · ApiDialog.java

来源：github.com · 整理 2026-09-15

不用遥控器打字，怎样用手机或电脑把配置地址推送给 TVBox？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

手机打不开 TVBox 的 9978 地址，同一个 Wi-Fi 也连不上怎么办？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 改完点播配置后直播也变了，怎样保留独立直播地址？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

本站相关教程

TVBoxOS 直播地址导入：M3U、TXT 与 JSON 示例这个 TVBoxOS 分支提供独立直播输入框，可以直接读取 M3U、TXT、数组 JSON 列表，也可读取含 lives 配置的 JSON。
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/dialog/ApiDialog.java

q215613905/TVBoxOS · index.html

来源：github.com · 整理 2026-09-15

不用遥控器打字，怎样用手机或电脑把配置地址推送给 TVBox？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/res/raw/index.html

q215613905/TVBoxOS · RemoteServer.java

来源：github.com · 整理 2026-09-15

手机打不开 TVBox 的 9978 地址，同一个 Wi-Fi 也连不上怎么办？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/server/RemoteServer.java#L60-L75

q215613905/TVBoxOS · ControlManager.java

来源：github.com · 整理 2026-09-15

手机打不开 TVBox 的 9978 地址，同一个 Wi-Fi 也连不上怎么办？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/server/ControlManager.java

q215613905/TVBoxOS · SearchActivity.java

来源：github.com · 整理 2026-09-15

TVBox 搜索不到某个站点的内容，怎样检查搜索范围？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 聚合搜索一直转圈、结果出来很慢，怎样缩小排查范围？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/activity/SearchActivity.java

q215613905/TVBoxOS · SearchHelper.java

来源：github.com · 整理 2026-09-15

TVBox 搜索不到某个站点的内容，怎样检查搜索范围？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 详情页的快速搜索与首页搜索，为什么结果不一样？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/util/SearchHelper.java#L61-L85

q215613905/TVBoxOS · SearchCheckboxDialog.java

来源：github.com · 整理 2026-09-15

TVBox 搜索不到某个站点的内容，怎样检查搜索范围？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 聚合搜索一直转圈、结果出来很慢，怎样缩小排查范围？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/dialog/SearchCheckboxDialog.java

q215613905/TVBoxOS · FastSearchActivity.java

来源：github.com · 整理 2026-09-15

TVBox 聚合搜索一直转圈、结果出来很慢，怎样缩小排查范围？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/activity/FastSearchActivity.java

q215613905/TVBoxOS · DetailActivity.java

来源：github.com · 整理 2026-09-15

TVBox 详情页的快速搜索与首页搜索，为什么结果不一样？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/activity/DetailActivity.java#L1620-L1679

q215613905/TVBoxOS · SourceViewModel.java

来源：github.com · 整理 2026-09-15

TVBox 某个站点没有年份、地区、类型筛选，能在设置里强行打开吗？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 提示正在嗅探但始终不播放，切换系统 WebView 有用吗？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/viewmodel/SourceViewModel.java

q215613905/TVBoxOS · VodController.java

来源：github.com · 整理 2026-09-15

TVBox 怎么切换 IJK、EXO 或外部播放器，为什么改了默认仍没变？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 的 IJK 硬解码和软解码怎么选，花屏时怎么测试？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 怎么切换国语粤语音轨，提示没有音轨怎么办？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
TVBox 画面被拉宽、字幕被切掉，画面缩放怎么恢复？ TVBox 怎样跳过片头片尾，为什么还没看完就自动下一集？ TVBox 怎么设置倍速，声音变快后如何恢复正常速度？ TVBox 提示正在嗅探但始终不播放，切换系统 WebView 有用吗？
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/player/controller/VodController.java#L664-L749

q215613905/TVBoxOS · PlayerHelper.java

来源：github.com · 整理 2026-09-15

TVBox 怎么切换 IJK、EXO 或外部播放器，为什么改了默认仍没变？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 的 IJK 硬解码和软解码怎么选，花屏时怎么测试？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 有声音但黑屏，SurfaceView 和 TextureView 可以怎么排查？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
TVBox IJK 缓存播放要不要开，缓冲慢是不是缓存越大越好？ TVBox 画面被拉宽、字幕被切掉，画面缩放怎么恢复？
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/util/PlayerHelper.java#L165-L194

q215613905/TVBoxOS · FileUtils.java

来源：github.com · 整理 2026-09-15

TVBox IJK 缓存播放要不要开，缓冲慢是不是缓存越大越好？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 的清理缓存和电视系统里的清除数据，有什么区别？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/util/FileUtils.java

q215613905/TVBoxOS · PlayFragment.java

来源：github.com · 整理 2026-09-15

TVBox 怎么切换国语粤语音轨，提示没有音轨怎么办？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 怎样加载本地字幕，内置字幕和外挂字幕有什么不同？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 字幕太早、太晚、太小，在哪里调时间和字号？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
TVBox 怎样跳过片头片尾，为什么还没看完就自动下一集？
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/fragment/PlayFragment.java#L650-L690

q215613905/TVBoxOS · SubtitleDialog.java

来源：github.com · 整理 2026-09-15

TVBox 怎样加载本地字幕，内置字幕和外挂字幕有什么不同？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据

TVBox 字幕太早、太晚、太小，在哪里调时间和字号？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/dialog/SubtitleDialog.java

q215613905/TVBoxOS · HistoryHelper.java

来源：github.com · 整理 2026-09-15

TVBox 播放历史变少、同名影片只剩一条，在哪里检查？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/util/HistoryHelper.java

q215613905/TVBoxOS · HomeActivity.java

来源：github.com · 整理 2026-09-15

TVBox 能打开后直接进入直播吗，能代替电视开机自启动吗？

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

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

适用于 q215613905/TVBoxOS 2026-09-14 提交 ab11d289；其他 TVBox 分支、旧版及第三方打包版需核对各自界面。

查看完整问答与其他依据
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/activity/HomeActivity.java

TVBoxOS 设置页：配置地址标签

来源：github.com · 整理 2026-09-15

本站相关教程

TVBoxOS 直播地址导入：M3U、TXT 与 JSON 示例这个 TVBoxOS 分支提供独立直播输入框，可以直接读取 M3U、TXT、数组 JSON 列表，也可读取含 lives 配置的 JSON。
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/res/layout/fragment_model.xml#L93

TVBoxOS 配置弹窗：直播输入、选择与确定

来源：github.com · 整理 2026-09-15

本站相关教程

TVBoxOS 直播地址导入：M3U、TXT 与 JSON 示例这个 TVBoxOS 分支提供独立直播输入框，可以直接读取 M3U、TXT、数组 JSON 列表，也可读取含 lives 配置的 JSON。
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/res/layout/dialog_api.xml#L136

TVBoxOS 首页直播和设置入口

来源：github.com · 整理 2026-09-15

本站相关教程

TVBoxOS 直播地址导入：M3U、TXT 与 JSON 示例这个 TVBoxOS 分支提供独立直播输入框，可以直接读取 M3U、TXT、数组 JSON 列表，也可读取含 lives 配置的 JSON。
查看原始出处（外部网站）

原始页面由资料发布者提供，部分网络可能无法访问。

打开原始页面

https://github.com/q215613905/TVBoxOS/blob/ab11d289e09963a9daf65ca7f6b7a9a8cbe184e1/app/src/main/java/com/github/tvbox/osc/ui/fragment/UserFragment.java#L368