企业官网建设流程全解析

VsTV 是一款体积不足 5MB、面向智能电视与电视盒子的轻量直播应用，支持遥控器与触屏双操作、多线路合并、组播直连与回看。本文为 VsTV 排错手册，针对鸿蒙变体包装错、开机自启失效、低端盒子卡顿等 10 个高频问题给出原因与解决步骤，帮你快速定位故障。

先看这张快速定位表

Q1：华为智慧屏该装哪个包？鸿蒙变体包怎么选？

每个版本通常发布三个APK（见 README.md 安装包对照表）：

• vstv-<版本>-arm.apk：默认选择，桌面名VsTV，包名com.vesaa.mytv，适合绝大多数电视 / 盒子 / 手机；
• vstv-<版本>-x86_64.apk：x86_64 架构设备专用；
• vstv-<版本>-HarmonyOS.apk：华为智慧屏等需要使用不同包名的场景，桌面名Z视介，包名com.chinablue.tv。

⚠️关键点：HarmonyOS 变体与常规包的数据与更新通道互不相通，两边配置不共享，也不能互相覆盖升级——用常规包升级鸿蒙变体会直接失败。应用内「检查更新」会按安装类型自动匹配对应附件（见 README.md）。

自查步骤：打开系统「设置 → 应用管理」查看 VsTV / Z视介 的包名，再对照上表确认装对；若混装过，卸载后按设备类型重装单一变体即可。

Q2：开机自启失效，重启电视后应用不启动

开机自启依赖系统广播，而部分厂商系统默认会拦截第三方应用的自启动行为（见 README.md）。

解决步骤：

1. 进入电视系统设置，搜索「自启动 / 自启管理」，允许 VsTV（或 Z视介）自启动；
2. 同时在「后台活动 / 应用保活 / 省电策略」中将 VsTV 设为允许后台活动 / 不限制；
3. 重启电视验证：开机后应用应自动进入播放界面。

💡 若系统没有自启动开关（部分品牌隐藏了该入口），可接受「开机后手动点一下图标」，VsTV 秒开，代价很小。

Q3：低端盒子卡顿、掉帧怎么办？

VsTV 已针对 S905 系列等低端盒子深度优化内存占用（见 README.md），但仍受硬件解码能力与片源质量限制。按顺序排查：

1. 确认网络：Wi-Fi 信号弱时优先换网线；运营商 IPTV 建议接光猫iTV 口；
2. 换更低码率的线路：左右键切换同名频道的多线路，或换一份码率更低的直播源；
3. 降低播放压力：避免在后台同时开多个应用，必要时重启盒子释放内存；
4. 仍卡顿则多为解码瓶颈：部分 H.265/HEVC 源在老硬件上无法硬解，应用会尝试软件解码兜底（内置扩展了 FFmpeg 解码器，见 README.md），此时建议改用 H.264 线路。

Q4：装完没频道？——首次必须自己填直播源

这是新手最高频的「故障」：VsTV 首次安装不写入任何默认直播源（见 README.md），它本身也不提供任何直播源或节目内容。

两步配置（电视端设置或网页配置页二选一，两者写入同一份配置）：

1. 遥控器进入设置 → 直播源，填入你的 M3U / TVBox 风格 TXT 等订阅地址；
2. 或手机浏览器访问http://设备IP:1616网页配置页填写（设备 IP 可在设置 → 关于中查看）。

支持的格式与示例见 README.md，涵盖标准 M3U、影视仓/TVBox 风格 TXT、rtp2httpd 播放列表四类。

⚠️ 请仅使用你已获得合法授权的订阅地址。

Q5：网页配置页 http://设备IP:1616 打不开

1616 端口用于提供网页配置页，但网页依赖公共 CDN，网络不通时页面可能加载失败（见 README.md）。

排查清单：

• 手机与电视必须在同一网段（确认设备 IP 是否变化，可在「设置 → 关于」中切换扫码 IP 复核）；
• 路由器若开启了AP 隔离 / 同网段隔离，请临时关闭；
• 电视系统自带的防火墙类功能可能拦截端口，可尝试用电视上另一台设备访问；
• 网页加载慢或空白，多为 CDN 不可达，改用电视端设置界面直接配置即可，两者效果一致。

Q6：节目单（EPG）不显示

1. 进入设置 → 节目单，确认已填写可用的XMLTV 地址；项目提供两套内置模板可作为可选起点（见 README.md）；
2. 用电脑浏览器先打开该 XMLTV 地址验证可访问；
3. 若源站无当日数据或频道名不匹配，节目单同样显示为空——可尝试多节目单切换，或暂时关闭节目单。

Q7：有声音没画面 / 个别频道黑屏

典型原因是视频编码与设备解码能力不匹配：

• 播放器基于 Media3（ExoPlayer），按 URL 自动识别协议并在容器不一致时做兼容回退（见 README.md）；
• H.265/HEVC 源在部分机型上无法硬件解码，会回退软件解码，能否成功取决于机型；
• 解决：左右键切换多线路找 H.264 线路，或更换直播源。

💡 判断小技巧：若同一频道在手机上能正常播放、只在盒子上黑屏，基本可以锁定为盒子解码能力问题。

Q8：udp:// 或 rtp:// 组播源播不了

VsTV 内置原生组播协议栈与 MulticastLock 锁，无需 udpproxy 转发（见 README.md），但前提是设备真正处在IPTV 专网：

1. 网线接光猫iTV 口，或按运营商要求配置VLAN；
2. 确认电视/盒子的 IP 属于 IPTV 专网网段（通常与光猫 iTV 口网关不同网段于普通 Wi-Fi）；
3. 填入udp://@239.x.x.x:xxxx或rtp://239.x.x.x:xxxx后直接播放即可，应用会自动获取组播锁并启用 2MB 接收缓冲区（操作说明见 README.md）。

⚠️ 只连普通 Wi-Fi 时组播几乎必然失败，这不是应用问题。

Q9：「检查更新」点了没反应

Android 11 及以上系统默认禁止应用安装未知来源 APK，更新或外部安装会静默失败（见 README.md）。

解决步骤：

1. 进入系统设置 → 安全 / 隐私 → 安装未知应用；
2. 为 VsTV（或负责安装的来源）授予允许安装未知应用权限；
3. 回到应用内重新执行检查更新。更新会从 Release 附件中自动匹配与当前安装类型一致的 APK（见 README.md）。

Q10：频道太多找不到？用多线路 + 精选模式

这不是故障，而是 VsTV 的两项核心体验功能（见 README.md）：

• 多线路合并：添加多个订阅源后，同名频道（如 CCTV1）会自动聚合为「线路 1/2/3…」，左右键快速切线；线路失败还会自动尝试下一条；
• 精选（老人/儿童）模式：在选台列表长按 OK 键将常用频道加入精选，再进入设置 → 精选设置勾选「只看精选列表」。此后上下换台只在精选内循环，界面隐藏其他内容，长辈找台一步到位。

小结与参考资料

VsTV 的问题 90% 集中在装错变体包、没填直播源、系统权限未放开三类，对照本文的 10 个问题按序排查基本都能解决。更多功能细节（换台顺序、字幕支持、时移回看等）见完整功能一览：

• 项目说明与功能文档：README.md
• 开源许可：LICENSE

💡 提示：配置与直播源均由用户自行管理，请仅使用合法授权的订阅地址。