TVBox 与同类软件常见问题解答

Kodi 不会安装后自动提供频道。使用 M3U 列表需安装并启用 IPTV Simple Client，再配置可访问的列表。空栏目应先检查插件与列表加载，而不是反复重装主程序。

1. 进入插件管理，从官方仓库的 PVR 客户端分类安装 IPTV Simple Client。
2. 打开插件配置，按列表位置选择本地文件或远程地址，并填入自己的可用 M3U 列表。
3. 启用插件并等待加载，再进入电视栏目；仍为空时检查列表内容和地址访问状态。

频道列表与节目单是两份不同的数据：M3U 指向节目流，XMLTV 提供排期。频道能播放只能证明视频地址可用。应确认 EPG 来源、有效日期与频道标识匹配；只填直播列表通常无法自动获得完整节目单。

1. 在 IPTV Simple 配置里检查是否已经设置服务方提供的 XMLTV 节目单地址或文件。
2. 打开源文件确认包含当前日期的节目，比较 M3U 的 tvg-id 与节目单频道标识。
3. 保存并刷新节目数据；只有部分频道为空时，核对这些频道的映射，不清空全部设置。

先确认设备时间和节目单时区，再判断是否需要 EPG 偏移。所有节目统一差几小时与个别频道排期错误不是同一问题；在原始时间已经正确的情况下再叠加偏移，反而会造成重复修正和更大误差。

1. 检查电视或盒子的日期、自动校时和所在地时区是否正确。
2. 比较当前直播节目与 XMLTV 标注的时间，确认偏差是全部频道一致还是个别频道异常。
3. 只有稳定的整体偏差时才调整 IPTV Simple 的 EPG 时间偏移，刷新后复核多个频道。

这些能力取决于流媒体提供方和使用的输入插件。单纯能播放直播，不代表存在历史存档；时移通常也只覆盖缓冲或服务允许的窗口。先查该频道提供哪些能力，再配置对应插件，不能靠任意回看参数生成节目。

1. 向播放源提供方确认频道是否提供时移、回看地址及允许的时间范围。
2. 核对 IPTV Simple 使用的输入插件与该流格式是否匹配。
3. 只在已支持的窗口内测试暂停和跳转；没有存档服务时改用官方平台的回看入口。

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

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

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

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

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

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

网页地址通常返回播放器页面，并不等于可直接播放的媒体地址。VLC 的网络播放需要它支持的媒体流或列表，某些网站还依赖登录、脚本或专用播放协议。网页在浏览器可播放，不保证 VLC 能处理同一链接。

1. 先判断链接打开后是网页、媒体文件还是播放列表，不按文件名外观直接下结论。
2. 播放源明确提供媒体地址时，在 VLC 网络串流入口填写完整地址并保持必要参数。
3. 只有网页入口的服务，优先使用官方网页、客户端或投屏；不要把网页错误当作电视硬件故障。

这种现象可能与视频解码或硬件加速兼容有关，MKV 只是封装格式，不能单凭后缀判断是否支持。先用其他文件做对照，再一次只改变一个加速选项；软件解码可作为排查手段，但高码率视频可能更卡。

1. 更新到设备可用的正式 VLC 版本，分别测试同一文件和已知正常的视频。
2. 在设置的视频硬件加速中比较自动、仅解码加速或禁用，每次修改后重新打开文件。
3. 记录有效设置和视频编码；禁用后能播但卡顿时，换用设备更容易解码的版本进行比较。

乱码优先检查字幕文本编码；完全显示方块还可能与字体缺字有关。先分清文字字幕与图片字幕，再调整相应选项。改语言偏好只影响选哪条字幕，通常不能修复字幕文件本身使用了错误编码的问题。

1. 在播放界面确认选择了正确的中文字幕轨道或外部 SRT 字幕。
2. 外部文字字幕乱码时，到 VLC 字幕设置检查文本编码，按文件实际编码调整或将文件另存为 UTF-8。
3. 重新载入视频验证；若内容是图片字幕，改编码无效，应换用匹配的视频或字幕版本。

先确认不是整段播放在卡顿，再调整音频延迟。固定偏差可以通过音轨菜单补偿，偏差不断增大则还要检查文件和播放状态。调节时以拍手、关门等清楚的声音作为参照，每次少量修改更容易判断方向。

1. 打开 VLC 播放中的音频与字幕菜单，找到音频延迟，先将旧偏移重置。
2. 选有明确发声动作的片段，小幅增加或减少延迟，直到声音与动作对齐。
3. 切换视频后复查，避免把某一文件的偏移用于所有内容；按需开启单视频延迟保存。

直通会把编码音轨交给后面的电视或功放解码，因此接收设备必须支持该格式。设备不支持时盲目开启直通会造成无声。先以关闭直通、由播放器解码的方式验证，再根据整条音频连接链路配置支持项。

1. 查看电视或功放实际支持的音频格式，并核对声音通过电视扬声器、HDMI 还是其他接口输出。
2. 在 Kodi 音频设置中暂时关闭直通，测试普通音轨和目标音轨是否恢复声音。
3. 需要功放解码且链路支持时，再启用直通并只勾选接收端确实支持的格式。

如果只在开始或结束时短暂黑屏，随后正常播放，可能是自动匹配刷新率引发显示模式切换。Kodi 官方说明这类切换会让显示设备短暂空白。持续黑屏、反复断连或其他应用也异常，则需要继续排查连接。

1. 检查 Kodi 的视频设置是否开启自动调整显示刷新率。
2. 暂时关闭该选项，对照播放同一文件，看短暂黑屏是否消失。
3. 确认原因后按观看偏好选择保留自动匹配或固定输出；持续异常时再检查设备的格式兼容。

在已经登录同一服务器的手机或网页客户端中，打开设置里的 Quick Connect，再输入电视显示的临时代码。电视是等待授权的一端，代码不是让你填写到服务器地址栏；过期后应回到电视获取新代码。

1. 在电视 Jellyfin 登录页面选择 Quick Connect，保持显示六位代码的页面打开。
2. 用已登录同一服务器的手机或浏览器进入设置中的 Quick Connect，输入该代码并确认。
3. 等待电视完成登录；提示过期或无效时生成新代码，并确认服务器管理员未关闭此功能。

字幕格式也影响播放方式。客户端不能直接处理某类字幕时，服务端可能需要把字幕烧录进视频，播放负担随之变化。先通过切换字幕轨道确认是否由字幕触发，再选择设备支持较好的字幕或客户端设置。

1. 播放同一段视频，分别测试关闭字幕、文字字幕和原来的字幕轨道，记录差异。
2. 优先选择匹配内容且客户端支持的文字字幕，例如已有的 SRT，而不是直接降低所有影片画质。
3. 查看播放信息是否在切换字幕后改变；保留文件编码、字幕格式和客户端版本供进一步排查。

填写运行 Jellyfin 服务器的电脑或 NAS 地址及实际端口。电视上的 localhost 指向电视自身，通常不能代表另一台电脑；默认 HTTP 端口为 8096，但管理员可能修改过。

1. 在服务器电脑确认 Jellyfin 正在运行，先打开本机管理页面。
2. 查服务器的局域网地址和实际端口，在电视填写对应完整地址。
3. 电视与服务器保持可互通；只在家里观看时先完成局域网连接，不需要为了测试开放公网端口。

自动发现与实际播放使用的网络机制不同。发现广播受子网、网络隔离等影响，而手动连接服务器地址可能仍然有效；手动连接成功不必强求自动列表显示。

1. 确认电视和服务器是否在同一子网，避免访客 Wi-Fi 或隔离网络。
2. 使用服务器实际地址与端口手动添加，验证登录和播放。
3. 需要自动发现时再按官方文档核对局域网发现流量与防火墙；不要为修复发现而关闭整个防火墙。

Jellyfin 从 10.9 起将 DLNA 移到官方插件，不再随基础服务默认包含。只有客户端能登录 Jellyfin，并不代表服务器已经启用了 DLNA 发现服务。

1. 在服务器管理界面确认是否安装官方 DLNA 插件。
2. 安装后按提示重启 Jellyfin，再让电视与服务器处于同一可互通局域网。
3. 核对容器网络和发现设置；若电视能使用 Jellyfin 客户端，也可直接走客户端连接。

客户端不支持原始格式、码率受限等情况会触发转码。硬件加速需要受支持的显卡、驱动和服务器配置，勾选一个选项并不保证整个流程都使用 GPU。

1. 在服务器播放信息中确认当前是直接播放还是转码，并查看触发原因。
2. 尝试客户端支持的音视频格式与合理码率，观察是否减少转码。
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. 若仅某站点受影响，核对扩展的嗅探规则与请求要求；网页改版、登录条件或服务限制需要站点适配，不能靠随意添加解析地址保证修复。

leanback 是面向电视和遥控器的界面，mobile 面向手机触控。把手机版装进电视后，出现竖屏或焦点难操作，应先核对安装包类型；只改横屏设置不能把手机版变成完整电视版。

1. 在电视的应用信息中记录当前版本，并保存已有配置。
2. 从维护者发布仓库选 leanback 包；手机或平板则选 mobile。
3. 再按设备支持的 ABI 选位数，安装后用方向键和确认键检查焦点。

安装包要匹配 Android 系统支持的 ABI。电视用了 64 位芯片，也可能只提供 32 位应用环境。维护者提供 arm64-v8a 与 armeabi-v7a 包，应查系统支持列表来选择。

1. 用设备信息工具查看“支持的 ABI”，记录是否包含 arm64-v8a。
2. 仅列出 armeabi-v7a 的设备选对应 32 位包。
3. 若仍无法安装，再检查最低 Android 版本、已有应用签名和存储空间。

FongMi 5.6.3 最低要求为 Android 7.0（API 24），不支持 Android 4.4、5.1、6.0。旧文章提到 kitkat 或老系统专版，不能证明当前主版本也兼容。

1. 在电视“设置→关于”查看 Android 版本，不只看厂商系统名称。
2. 低于 Android 7.0 时不要反复安装同一个新版 APK。
3. 若考虑旧版，核对该具体版本的来源及兼容要求；也可使用受支持的外接盒子。

维护者说明不同签名的 APK 不能直接覆盖安装。即使名称和版本号相同，自编译包或二改包也可能使用另一签名。应先备份配置和个人记录，再判断是否更换发行渠道，避免卸载后丢失数据。

1. 先记录版本、下载来源，并在原应用内完成备份。
2. 优先从原有可信发行渠道取得同签名更新包。
3. 需要换包时先确认备份能保留到应用外，再按新项目的恢复说明操作。

维护者发布的影视是可配置播放应用，本身不附带节目来源。只要界面能够正常打开，没有站点或频道通常还需要添加自己的点播或直播配置，也可以先用本地视频验证播放功能。

1. 先从文件管理器打开一段自己的本地视频，确认播放器能工作。
2. 在设置中添加来源清楚、可自行维护的点播配置或直播列表。
3. 配置加载报错时记录错误文本，并核对地址是否返回真正的配置内容。

点播站点和直播列表由不同配置结构管理。点播配置中的 sites 不等于直播频道；直播需要 lives 内容，或者另外导入独立 LiveConfig。一个地址能显示影片分类，并不能证明它同时提供直播。

1. 检查自己的点播 JSON 是否实际包含 lives 数组。
2. 没有 lives 时，在直播配置入口添加自己的直播列表或独立直播配置。
3. 重新进入直播页，确认当前选中的是刚添加的配置。

当前维护者文档列出 M3U、TXT、JSON 直播格式。可以把自己的列表作为直播配置的 url，也可以用 JSON 直接定义分组与频道。列表格式、频道地址和网络可达性要分别检查，不能只改文件后缀。

1. 先确认文件实际内容符合 M3U、TXT 或 JSON 中的一种格式。
2. 在自己的 LiveConfig 中用 lives 数组填写列表名称与 url。
3. 先用一个已确认可访问的自有频道测试，再逐步添加分组。

节目单与视频流是两份数据，直播可播不代表 XMLTV 数据也可用。应分别核对节目单地址、频道标识和时区；频道名称或 tvg-id 对不上，节目表就可能为空，时间设置错误也会让当前节目错位。

1. 检查配置的 epg 地址返回的是有效节目单，而非网页或错误页。
2. 把列表内的频道标识与 XMLTV 对应条目逐项对照。
3. 确认电视系统时间及直播配置 timeZone，刷新后观察同一频道。

节目单只描述播出安排，不包含历史视频。回看还需要来源服务提供可按时间访问的节目，并使用相匹配的 catchup 配置。给普通直播地址补一段回看参数，并不会让服务端自动生成昨天的节目。

1. 先向自有或已订阅服务确认回看权限与保留时长。
2. 按该服务文档填写 catchup 类型、地址模板和时间格式。
3. 用保留期内的一档节目测试；实时直播也失败时先修复直播连接。

Live 配置中的 boot 表示该直播配置载入后自动进入直播。它属于应用内的启动流程，不等于厂商系统允许软件随电视开机运行。设置了 boot 但电视仍停留在桌面，应检查两层不同的行为。

1. 在当前选中的直播配置中核对 boot 值。
2. 手动启动影视，观察配置加载后是否进入直播。
3. 只有应用内跳转正常后，再检查电视系统是否提供该应用的开机启动选项。

站点存在、是否显示和是否参与搜索是不同设置。维护者字段中 searchable 控制搜索，hide 控制站点列表隐藏；站点扩展还必须真正实现搜索能力。改显示名称不能修复一个不提供搜索的扩展。

1. 核对该站点自己的 searchable 和 hide 字段。
2. 先在该站点内用一个准确标题测试，判断是不是跨站搜索的问题。
3. 如果扩展未实现搜索或接口返回错误，按维护者说明更新扩展并保留错误信息。

主配置内的相对路径会按主配置的位置展开。把 JSON 移到别的目录后，原来的 ./spider.jar 可能已指向错误位置；文档还特别区分外部数组及直播列表内部的地址，不能假定它们会再次自动展开。

1. 逐个核对失败文件相对于主 JSON 的真实位置。
2. 先把一个失败路径改成自己服务器上的完整 URL 验证。
3. 按维护者示例整理目录后再恢复相对路径，并检查服务器是否返回实际文件。

Java 站点用 csp_ 类名并依赖 JAR；JS、Python 站点指向对应脚本。全局 spider 可供站点共用，站点 jar 可以覆盖它。它们是扩展入口，配置须与扩展作者的接口约定一致。

1. 先确认扩展类型和所需文件，不要仅凭文件名字改 type。
2. Java 扩展核对类名和 JAR 是否配套；脚本扩展核对 api 路径。
3. 只用一个站点做最小验证，成功后再并入完整配置。

当前项目支持外部 SRT、SSA、ASS 字幕，并提供播放中的字幕选择与局域网推送。选中后没有显示，要区分文件无法读取、字幕轨未启用和时间轴不匹配，不能只反复切换视频地址。

1. 播放自己的视频后打开字幕选择入口，选择可读取的对应字幕文件。
2. 跳到字幕文件中确实有对白的时间，确认字幕轨已启用。
3. 再检查文件编码及字幕对应的影片版本，必要时换一份简单 SRT 做对照。

维护者的 5.6.3 发布说明明确列出双字幕、字形设置及 libass 支持，电视和手机端都有相关更新。旧教程或旧安装包可能没有同样入口；还需有可用字幕轨，开启功能不会自动生成翻译字幕。

1. 先在关于页核对版本和发行渠道。
2. 从该项目发布仓库查看对应版本更新说明后再升级。
3. 播放带字幕的视频，在字幕选择及设置中检查可用轨道、字体和渲染选项。

音轨选择只会列出当前媒体和播放引擎识别到的轨道。可以在播放时切换，但文件只含一种语言时，软件不能补出另一条配音。若有多轨却没有声音，再检查电视输出方式及该音频编码的兼容性。

1. 播放视频并打开音轨选择，查看轨道的语言与格式信息。
2. 选取目标音轨后停顿数秒，确认播放已切换。
3. 没有目标语言时核对源文件；选中仍无声时用立体声轨道作对照。

当前播放器工厂会对 DRM 媒体或 smb 协议优先使用 Exo；mpv 未就绪时也会回退到 Exo。因此出现不同播放引擎不一定是设置失效，应先看媒体协议和引擎可用性，再判断是否需要报错。

1. 记录实际媒体协议及是否使用 DRM。
2. 用自己的普通 HTTP 视频或本地视频对照测试 mpv。
3. 仅非强制场景仍无法使用时，再核对安装包与 mpv 引擎是否匹配。

有声无画可能涉及视频解码或渲染路径。当前电视端提供解码与渲染设置；应先用一段确认正常的视频作对照，每次只改一个选项并重新播放。若只在某一格式发生，记录编码比盲目重装更有用。

1. 用自己的普通 H.264 视频确认应用和显示输出正常。
2. 在播放设置中切换硬解与软解，重新打开同一问题视频。
3. 仍黑屏时再单独测试渲染模式，并记录设备型号、格式与有效组合。

当前手机版同步界面支持设备发现、刷新和扫码。目标电视必须运行影视且其局域网服务可访问；同一个路由器名称并不能保证设备互通，访客网络隔离或旧设备地址都可能让列表空白。

1. 让手机与电视连到可以互访的家庭网络，并打开两端影视。
2. 在同步界面刷新设备；必要时按应用提供的二维码连接。
3. 核对电视显示的实际 IP 与端口，清除失效设备项后重新发现。

同步有双向、仅接收和仅发送之分。强制历史同步会先删除接收端对应配置的历史，强制收藏同步会先清空接收端收藏，再合并传入记录。因此选择方向和强制方式前，应先备份并明确需要保留哪端数据。

1. 先备份两端个人数据，明确来源设备和接收设备。
2. 先选择合适方向做普通同步，用一条记录验证结果；不要随意长按触发强制同步。
3. 只有确认可替换接收端数据并保留备份后，再按对应版本说明使用强制方式，完成后检查收藏与进度。

当前 History 同步会比较同名项目的记录时间，并结合配置与条目标识合并，不是把整个列表逐项无条件覆盖。两端同名影片、不同站点或错误系统时间，都值得一起核对，避免把正常合并误判为网络失败。

1. 确认两端系统时间准确，并记录影片对应的站点和配置。
2. 在来源设备播放到一个新位置，正常退出播放以保存记录。
3. 重新执行普通同步，再核对目标端同名项目的最新记录。

本次核验的 BackupManager 最多保留 7 份备份，文件名按日期生成并使用 .tv 后缀。同一天再次备份会写入同名文件，所以不能把应用自动备份当作长期、多时间点的归档系统。

1. 在应用备份列表中核对日期与最近成功状态。
2. 重要迁移前把备份另存到自己的电脑或存储位置。
3. 需要多个时间点时为导出的副本增加清楚的时间说明，再进行后续操作。

备份会检查当前配置是否为空；恢复检查的则是备份文件内的配置，并不要求新安装应用先有配置。恢复文件需要能解压并解析为本项目的有效备份，把其他软件的文件改成 .tv 后缀不能解决问题。

1. 执行备份失败时，先确认当前应用已有正常保存的配置。
2. 执行恢复失败时，检查备份文件的完整性、生成版本与配置内容；新设备无需为了恢复先添加配置。
3. 保留原始备份，使用本项目恢复入口；若仍失败，记录错误，不覆盖唯一副本。

127.0.0.1 指的是正在使用浏览器的设备自身。手机访问电视时应输入电视端影视显示的局域网 IP 和端口。服务会从 9978 到 9998 尝试可用端口，不能一律假定每台设备都使用 9978。

1. 先在电视启动影视，找到它显示的实际 HTTP 地址。
2. 手机连到可互访的家庭网络，完整输入该地址及端口。
3. 地址变化后重新获取；不要把局域网控制端口映射到公网。

推送入口把 URL 交给应用播放流程，并不保证任意视频网站页面都能转换为视频。媒体直链、需要登录的网页和带临时鉴权的链接有不同前提；先用自己的可播放媒体地址测试，才能判断连接是否正常。

1. 先从手机推送一个自己的有效媒体 URL，并看电视是否进入播放。
2. 只有网页链接失败时，核对该网页是否需要登录或专门的服务支持。
3. 保留电视实际错误提示及链接类型，不把“已发送”当作解码已成功。

维护者文档说明 /action 的 OK 通常只代表事件已派发；未知命令、缺少参数或没有播放服务时，也可能返回 OK。自动化程序应再检查播放状态和电视画面，不能只凭一个字符串判定操作成功。

1. 确认指令名称、必要参数和表单编码，避免把 JSON 请求体当普通表单。
2. 先在电视实际播放一段媒体，再执行暂停等最小指令。
3. 用 /media 状态和电视画面交叉验证，字幕则核对文件能否被电视读取。

当前电视播放设置会按所选引擎显示 mpv 相关选项；处于 Exo 模式时部分选项会隐藏，Vulkan 还要满足设备支持条件。因此选项缺失要先核对版本、引擎和硬件能力，不能照另一台设备的截图强开。

1. 确认使用的是本项目支持 mpv 的对应版本。
2. 在播放设置切换引擎后，再查看 mpv.conf 与 gpu-next 项。
3. Vulkan 仍未出现时核对设备支持；修改高级配置前保存原值，异常时恢复。

DLNA 投放用于把媒体交给另一台设备播放；历史与收藏同步则交换应用个人记录，是两条不同流程。投屏能成功不代表目标设备安装了同款影视，也不意味着它能接收 FongMi 的收藏数据库。

1. 只想在电视播放当前媒体时选择可用的 DLNA 目标。
2. 需要继续观看记录或收藏时，先确认两端是支持该同步机制的影视版本。
3. 从同步入口单独操作并核对方向，完成后再检查记录。

本次读取 FongMi/Release 只见 fongmi 分支，没有旧教程中的 okjack。旧地址不能继续当作当前 OK影视下载入口，应回到已安装版本标注的维护者渠道核对公告，不要猜测替代下载包。

1. 在已安装 OK影视的关于页记录版本和发布者信息。
2. 对照原维护者公告确认当前下载入口，不用旧文章的同名跳转按钮代替。
3. 下载前核对手机或电视版本、系统要求及签名；需要换发行包时先备份。

同类界面、共同技术来源或相似包名，都不能证明两个发行包可以互相覆盖。当前 FongMi 仓库的版本要求与说明只适用于其自身；切换到 OK影视或反向迁移时，还要核对签名、配置扩展和备份兼容性。

1. 分别记录两个安装包的发布渠道、版本号和包名。
2. 先在原应用内备份，把配置地址和重要记录另行保存。
3. 按目标项目实际迁移说明验证；不要直接假定一方备份可由另一方完整恢复。

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

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

最低系统版本由具体安装包决定。旧专版曾支持老电视，不代表所有当前 OK影视包都兼容。FongMi 主版本的 Android 7.0 要求也不能套给 OK影视，须核对准备安装的具体版本。

1. 在电视关于页确认真实 Android 版本和支持的 ABI。
2. 从该专版自己的维护者说明或 APK 信息核对最低系统要求。
3. 缺少版本依据时不要把转载的“全机型通用”当承诺；先备份并保留原有可用包。

本次检索尚未确认影视仓当前维护者的独立官网或可验证发布仓库，下载站写着“官方版”不能代替证明。影视仓和 TVBox 也不能仅凭名称判断能否覆盖安装；Android 更新还取决于包名、签名及版本关系。

1. 先在已安装应用的信息或关于页面记录完整名称、版本号与原下载渠道，保留现有配置。
2. 要求发布者提供可追溯的维护者主页、更新记录及 APK 校验信息；第三方转存文件不能自行认定为原作者发布。
3. 如果系统提示签名不一致或更新冲突，停止覆盖并确认是否属于另一分支；不要为了安装先卸载导致配置丢失。

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

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

Filmly 对应网易爆米花，开发者是网易，并不是迅雷影音。它围绕你导入的网盘、NAS、本地或媒体服务器文件建立媒体库；TVBox 的配置地址不能直接当成网易爆米花的网盘或服务器账号填写。

1. 从网易爆米花官网进入下载页，核对开发者与平台；Android TV 和 Apple TV 分别选择对应客户端。
2. 先明确视频实际存在哪个网盘、共享目录或媒体服务器，再选择应用中同名的文件源类型。
3. 通过对应服务的授权或账号连接导入自己的影片；需要的是媒体库管理时使用海报墙，不要寻找 TVBox 的 JSON 接口入口。

Android 电视与 Apple TV 的安装方式不同。网易官方提供 Android TV 安装包，可按电视的应用安装流程使用；Apple TV 应在自己的 App Store 搜索网易爆米花，不能使用安卓 APK。

1. 先在电视系统信息中确认系统，Android 电视、安卓盒子与 Apple TV 不要混选安装包。
2. Android 设备从官网选择 TV 包，复制到 U 盘后打开 APK；如电视允许局域网投送，也可按对应品牌教程传入同一安装包。
3. Apple TV 直接进入 App Store 搜索网易爆米花并安装；安卓安装完成后在“我的应用”启动，再按页面引导登录。

先确认媒体库确实导入了含视频的文件夹。网易当前公开帮助使用手机端完成网盘授权和文件夹选择，再同步至其他设备；安装电视版本身不会自动生成影片，授权成功也不等于已选中需要导入的目录。

1. 手机登录网易爆米花，在右上角加号选择对应网盘，登录并确认允许访问的授权范围。
2. 勾选实际存放影片的文件夹后完成导入；注意子文件夹中的视频也会进入扫描范围。
3. 在电视使用同一账号等待同步；新增视频可放进已勾选目录，再在手机点击刷新。仍为空时核对网盘账号与目录是否选错。

网易官方提供手机端手动编辑影片信息的方法，既能处理没有识别出海报的文件，也能纠正匹配到另一部电影或电视剧的问题。修改会同步到其他端；搜索时应使用完整片名，再单独确认电视剧的季和集。

1. 在手机打开出错影片的详情页，进入右上角“更多”，选择“手动编辑”。
2. 输入完整而准确的电影或剧名，先去掉分辨率、季号和多余标点；中文不好匹配时可按官方建议尝试英文片名。
3. 选择正确结果并完成；电视剧继续核对季、集编号。返回电视检查同步结果，不要仅为换海报重复导入整套文件夹。

网易官方建议先降低分辨率做对照，确认能正常播放后再逐级提高。电视播放界面按遥控器下键可调出菜单，进入清晰度选项；如果低分辨率仍不能播放，应提交具体文件和设备情况，而不只是反复重装。

1. 进入影片播放界面，按遥控器“下”键打开播放菜单，找到清晰度并选择可用的较低分辨率。
2. 从头播放和拖动进度各测试一次；低清正常后逐级上调，记录从哪一级开始出现黑屏或缓冲。
3. 低清也失败时，在电视版“我的”提交反馈，附机型、应用版本、文件来源和表现；网速、码率及解码能力都可能影响播放。

网易提供可唤起手机应用的服务器配置链接，但它只是填入连接信息，不会自动创建服务器。自动跳转受手机系统规则影响；官方页面说明可点击“已安装”继续，配置中的地址、端口和编码仍需分别正确。

1. 先在 iOS 或 Android 手机、平板安装网易爆米花，再打开你自己服务器生成的官方格式导入链接。
2. 若浏览器没有唤起应用，在中转页面点击“已安装”；进入应用后核对文件源类型、服务器地址、端口与路径。
3. 用户名、密码、路径包含特殊字符时按官方要求进行 URL 编码。演示 example.com 链接不能实际连接，含密码的二维码也不要公开分享。

迅雷影音官网分别提供 TV 通用版、旧版和安卓 4.1 版入口。应先按电视系统版本及官方标注选择，不能只看文件名中的版本数字；桌面 Windows 安装程序也不能当成电视安装包使用。

1. 在电视设置查看 Android 系统版本和现有迅雷影音版本，再从 tv.xunlei.com 的 TV 区域选择安装包。
2. 一般先查看通用版的适配说明；旧系统遇到系统版本不满足时，再核对官网专门列出的安卓 4.1 入口，不要混装来历不明修改版。
3. 升级前保留账号与片库设置；提示应用冲突时核对旧包来源，完成安装后用一个小视频验证打开、声音和遥控器操作。

迅雷影音官方介绍的是云盘直连、影音库整理和跨端播放记录，并不是 TVBox 配置导入。使用时应连接自己对应的云盘账号与目录；不同平台和版本的入口可能不同，不应将软件官网链接误填成影片地址。

1. 从迅雷影音官网取得与你设备相符的版本，在客户端检查是否有目标云盘的连接入口。
2. 按客户端引导授权自己的账号，并选择实际存放视频的目录；先用少量文件确认能够识别与播放。
3. 需要跨设备续播时核对两端登录账号，再检查播放记录。若当前 TV 版本没有同名功能，先查看官方更新说明，不套用 Windows 的按钮位置。

Nova 的 WebDAV 连接框把协议、主机、端口和路径分开填写。服务器地址栏只放域名或 IP，不要把完整 URL 连同目录一起粘进去；HTTPS 对应 webdavs，路径则放在单独的 path 输入项中。

1. 将已有可用地址拆成四部分：例如 https://nas.example.com:443/dav，主机是 nas.example.com，端口是 443，路径是 /dav。
2. 在协议下拉框选择 webdavs，再填主机、实际端口和以斜杠开头的路径，核对该服务的用户名与密码。
3. 群晖常见 WebDAV 端口与普通网站不同，应以 NAS 实际设置为准。先在同一网络测试一个目录，确认账号有读取权限再添加片库。

不必一律切换。Nova 当前 FAQ 将 jcifs-ng 作为优先、较稳健的默认实现，并说明较新版本已优化吞吐；smbj 是可试的另一实现，只支持 SMB2 及以上。旧教程“默认 SMB 一定慢”的结论不能直接套用。

1. 先记录 Nova 版本、NAS 的 SMB 协议范围，以及同一文件的码率；用本地播放作对照，区分解码慢还是网络读取慢。
2. 保持当前默认客户端完成一次测试，再在你的版本提供相关选项时对比 smbj；NAS 只开 SMB1 时不能靠 smbj 连接。
3. 一次只改一项，比较缓冲次数与稳定性；如需测试 WebDAV 或 SFTP，先配置好服务和读取权限，不为追求吞吐关闭账号认证。

Nova 官方说明 UPnP 对远程外挂字幕存在兼容限制，不能因为同目录有 SRT 就认定一定会传给播放器。可以改用能直接读取文件的 SMB 共享做对照，并确认字幕与影片命名、权限都正确。

1. 先确认视频是否从 UPnP 或 DLNA 分类进入，并查看影片是否已有内嵌字幕可供选择。
2. 将一个同名 SRT 与影片放在 NAS 同一目录，通过已授权的 SMB 共享打开同一文件，对比字幕是否出现。
3. SMB 正常而 UPnP 不正常时，检查媒体服务器是否支持传递字幕；若都不显示，再检查字幕编码、扩展名和文件读取权限。

Nova 支持遵循 Kodi 格式的 NFO 信息文件，但不要据此假设 Kodi 的所有标签和功能都完全兼容。官方特别说明识别 ID 使用 TMDB；已有 NFO 的封面地址失效或使用旧 HTTP 链接，也可能影响海报读取。

1. 挑一部识别错误的影片测试，在影片旁准备相应的 NFO，先确认片名、年份和 TMDB 标识对应正确作品。
2. 按 Nova 文档检查 NFO 和本地海报文件的命名及目录位置，随后重新读取该影片信息。
3. 旧 NFO 引用在线图片时确认地址真实可访问；有 HTTPS 对应地址再修正，不要不经验证批量替换整个媒体库。

Nova 私密模式会阻止记录续播点。对于同一网络共享，官方提供的跨设备方式是在有写入权限的目录保存续播 XML 文件，两台设备读取同一位置；只有读取权限时，不能保证这种共享文件同步方式生效。

1. 先检查是否启用了私密模式，关闭后播放一段视频并正常退出，观察本机能否恢复进度。
2. 两台电视使用同一网络共享路径；如采用共享文件同步，确认使用的账号能在该影片目录创建续播文件。
3. 在电脑显示隐藏文件，检查影片旁是否出现 .影片文件名.archos.resume.xml，再到另一台设备测试；不愿授予写权限时可查看官方说明的 Trakt 方式。

Nova 提供应用封装、系统封装以及 AC3 重编码方式，选择取决于电视、盒子、HDMI/ARC/eARC 和音响整条连接链。强制直通不会增加硬件的解码能力；出现无声时应先回到普通解码输出建立正常基线。

1. 记录连接方式：盒子直连功放，或先接电视再经 ARC/eARC 到音响；查看文件音轨格式与音响支持列表。
2. 关闭强制直通并测试普通输出；恢复声音后，再逐个测试当前版本提供的系统封装或其他直通模式。
3. 普通 ARC 无法承载多声道 PCM 时，可按官方说明测试 AC3 重编码。每次只改一种模式，若仍无声恢复原设置并保留测试结果。

Nova 的播放性能受设备硬解能力影响。旧设备不支持某种 HEVC 编码时，回退软件解码可能明显卡顿；不支持杜比视界的显示设备播放此类文件也可能异常。先排除强制软件解码，再用普通视频对照。

1. 在 Nova 设置检查 Software decoding，确认没有无意强制使用软件解码，再测试同一文件。
2. 用普通 H.264 视频与问题 HEVC 文件作对比，并在本地存储测试，避免把网络读取不足误判为解码问题。
3. 若只有杜比视界文件异常，且显示设备不支持该规格，可测试设置中的 Disable dolby vision；这属于兼容输出，不会让电视获得杜比视界能力。

可以用 Nova 管理片库，再让 Just Player 播放。维护者说明 Nova 可开启“允许使用其他视频播放器”；这样能补足片库与网络浏览入口，但字幕、进度等外部播放体验仍需实测。

1. 先安装两个应用，并在 Nova 中确认你的本地或网络影片可以正常找到。
2. 在 Nova 开启允许使用其他视频播放器的选项，再选择一部影片，按系统或应用提示选 Just Player。
3. 分别测试音轨、外挂字幕与返回片库；网络权限或字幕没有被一起传递时，应保留原路径作对照，不要假设所有历史记录和元数据都会自动互通。

Just Player 官方说明没有专门填写网络地址的界面，而是接收其他应用打开或分享的兼容链接。应从浏览器、文件管理器或来源应用调用它；HLS 等流媒体格式受支持，但网页页面地址不等于可播放的视频直链。

1. 先确认你持有的是可播放媒体链接，例如自己的 HLS 地址，而不是只有标题和播放器的普通网页。
2. 在提供该链接的应用中选择打开方式，尝试 Just Player；没有出现时可选择链接文本，使用系统“分享”菜单。
3. 若系统没有将它列为处理应用，记录 Android 版本与调用方；官方说明 Android 12 及以上可能有调起限制，可换能正常传递媒体 URI 的来源应用测试。

Just Player 可长按底部的打开文件按钮加载外挂字幕；首次可能要求选择视频根目录。Android TV 的文件选择能力存在限制，官方还提供另一条路径：先从外部文件管理器打开视频，再把字幕文件也交给 Just Player。

1. 先打开要看的视频，长按文件夹或打开文件按钮，按系统提示选择视频目录并授予访问权限。
2. 如果电视无法选择字幕，在可访问同一目录的文件管理器中先用 Just Player 打开视频，再返回文件管理器打开 SRT 并选择同一播放器。
3. 字幕会用于最近选择的视频；检查字幕文件确实对应当前影片，随后在字幕轨道菜单选择它，而不是同时打开另一部电影。

Just Player 使用 Android 的字幕偏好设置控制常见字幕的字体、大小和颜色。可以长按播放器的字幕按钮快捷进入系统页面，也可在系统无障碍设置中查找字幕；部分复杂 ASS 样式并不会完整呈现。

1. 播放一段有字幕的视频，长按字幕按钮，看看能否跳转到系统 Caption preferences 或字幕偏好。
2. 在系统设置调整字号、字体和背景颜色，返回播放界面核对实际效果；没有快捷入口时从无障碍菜单进入。
3. 若 SRT 正常而复杂 ASS 的位置或特效不正确，检查官方列出的 ASS 样式限制；增大系统字号不能修复所有特效兼容问题。

Just Player 本身以播放为主。手机上可借系统文件选择器及文档提供程序访问网络存储，但官方明确提醒 Android TV 不支持同一套文档提供程序方式；电视上应通过网络文件管理器或 Nova 将影片交给它。

1. 在电视安装能够访问你家 NAS 的文件管理器，先用账号登录共享目录，确认能看到并读取视频。
2. 选中视频后使用“打开方式”调用 Just Player；或者在 Nova 建立网络片库，再开启使用外部播放器。
3. 如能显示文件却不能播放，核对调用方是否传递了可读取的 URI 与凭据。不要把手机版 SMB 文档提供程序的操作直接当成所有电视适用教程。

Just Player 可以尝试发现部分 HTTP/HTTPS 视频旁的同名字幕，但这不等于任意网盘或带临时授权的链接都会自动匹配。先用同一服务器、同一目录且基本文件名相同的视频与 SRT 测试，再检查字幕地址能否独立读取。

1. 把自己的视频与字幕放在同一目录，例如 video.mkv 和 video.srt；先避免复杂名称，确认基础匹配。
2. 分别检查视频与字幕地址的访问权限，特别是带有效期、重定向或登录要求的链接，两者可能并不能共用授权。
3. 自动加载失败时，可按官方外部字幕流程手动打开字幕；记录调用来源和服务器形式，不要不断更换视频文件来解决字幕链接权限问题。

Just Player 把部分高级选项放在长按齿轮后进入的设置中，也可从系统应用信息进入相关设置。自动匹配帧率、解码器优先级和隧道播放需要设备配合，并非打开所有开关就能提升所有视频的画质与流畅度。

1. 使用遥控器聚焦齿轮按钮并长按确认键，查找高级设置；若当前界面无法长按，可查看系统应用信息提供的设置入口。
2. 先记录默认值，根据具体问题只调整一项，例如对比解码器优先级或自动帧率匹配，然后用同一视频测试。
3. 启用隧道播放或切换刷新率后若出现黑屏、音画异常，恢复原值；它们依赖显示设备和解码路径，不能替代硬件规格。

Just Player 在 Android TV 上可长按 Resize 或画面尺寸按钮进入缩放模式，再用方向键上、下精细调节。黑边常与影片和屏幕比例不同有关，裁剪能铺满屏幕，也会切掉一部分画面，应按观看内容选择。

1. 播放视频后找到画面尺寸按钮，先对比适应屏幕与裁剪，确认黑边是否来自正常宽高比。
2. 在 Android TV 长按该按钮进入 Zoom 模式，用遥控器上、下键调整倍率，观察字幕与人物边缘是否被切掉。
3. 如果画面中的台标或字幕本来就靠边，优先保留完整画面；退出放大后检查下一部影片，避免沿用过大的裁剪倍率。

MKV 是封装名称，内部编码可以不同。Just Player 对部分旧编码及 10-bit AVC 有限制，也能调用 MediaInfo 查看信息；先取得编码、位深和音轨，再判断是否属于设备兼容问题。

1. 从 MediaInfo 官方渠道安装工具，打开出错文件查看视频编码、Profile、位深、分辨率以及音轨格式。
2. 在 Just Player 长按视频标题可快捷调用 MediaInfo；若调用失败，直接在 MediaInfo 中打开同一文件。
3. 用兼容的普通 H.264 文件做对照，将具体编码和设备信息一起提交问题。不要因为另一个 MKV 能放，就认定所有 MKV 都应使用同一解码能力。

接收成功与画面显示是两步。LogVar 的接入说明提醒，部分兼容版本默认关闭弹幕显示；先检查播放页的“弹”按钮。没有自动匹配结果时，再手动搜索片名和剧集。

1. 先确认当前版本已按扩展文档完成接入，而非仅安装 OK影视。
2. 看到已推送提示后打开播放页的“弹”开关，观察显示状态。
3. 没有匹配结果时使用小白弹幕按钮搜索准确片名，再选择对应集数。