VsTV 让你在 智能电视、电视盒子、平板或手机 上收看直播频道：选台、换台、多线路、节目单、精选频道、比例与音量等常见需求都可在应用内完成。首次安装不会写入默认直播源，需在 设置 或浏览器访问 http://设备 IP:1616 自行配置订阅地址与节目单。稳定源建议 自行注册 后使用 Mursor、APTV 等社区常用服务提供的列表（以各平台说明为准）。

公开发布以 Releases 为准：首个下载版本为 1.0.0 起；后续可在应用内检查更新或手动下载新版 APK 覆盖安装（需系统允许安装未知应用）。

仓库与发行文件名常用标识 vstv，与包名、应用展示名一并区分于其他同名产品。

---

• 性能与体验：精简冗余逻辑与无用代码路径，降低维护面与包体负担，冷启动与日常操作更轻快。
• 直播源兼容：面向 M3U 等主流 IPTV 订阅；订阅中带 tvg-logo 时，选台列表会 自动加载台标（Coil 缓存）。地址在设置或网页中配置，应用不内置直播列表。
• 节目单模板：内置 APTV 的 EPG 与 老张的 EPG 两套 节目单地址模板（便于首次选择）；你仍可改为任意可用的 XMLTV 地址。支持 XML 与 gzip（.gz） 拉取，无需手工解压。开启 EPG 后由 WorkManager 在后台按间隔自动刷新缓存（需联网），与「未到设定钟点前不拉取」的规则一致。
• 老人 / 儿童友好模式：把常看的台加入 精选，在设置中开启 「只看精选」 后，界面与换台顺序仅保留精选列表内频道，隐藏其余列表，减少误操作。
• 在线升级：应用内 检查更新，新版本可直接下载安装，省去 U 盘拷贝（请在系统中允许本应用安装未知来源应用）。

其他亮点（节选）：精选会固化 播放地址与拉流请求头快照，删除订阅后仍可从精选直接播放；多线路 失败自动尝试下一条；同网段 网页配置（http://设备 IP:1616） 与电视端设置实时同步。

---

首次配置说明

• 直播源：无内置默认订阅。安装后请在 设置 → 直播源 或 网页配置页 填写你的 M3U 等地址；换源、请求头等与播放相关的配置均由你自行提供。
• 节目单：提供上述 两套 EPG 模板 作为可选起点，你可在设置中改为自己的 XMLTV 地址或关闭节目单。
• 获取稳定列表：建议在 Mursor、APTV 等平台 自行注册账号，按官方说明获取个人订阅链接后再填入本应用；具体条款、可用性与合规性以各服务商为准。

致谢（节目单模板与社区）

内置可选 节目单 模板所指向的数据与维护者（排名不分先后）：

• 老张的 EPG（节目单数据）— 特此感谢
• APTV 的 EPG（节目单数据）— 特此感谢

以及项目演进中参考或受益的开源与社区（见文末「其他致谢」）。

---

适用环境

• 设备：国产及常见品牌电视 / 盒子（如 TCL、海信、酷开、华为智慧屏、荣耀、小米电视等），多为厂商定制 Android；部分鸿蒙设备通过 Android 兼容层运行。
• 网络：不依赖 Google Play 或谷歌账号；常见环境无 GMS，多通过 U 盘、远程推送、网页或文件管理器 安装 APK。
• 系统要求：Android 5 及以上；实际播放效果依赖设备解码能力与片源质量。

使用本应用时建议了解

说明
在电视桌面出现图标：已同时适配电视与手机类桌面入口
允许 http 明文地址，便于常见 IPTV / 节目单链接
应用内 检查更新 会从本仓库 Release 拉取与当前安装包类型匹配的 APK
1616 端口 提供网页配置页；网页依赖公共 CDN（如 jsDelivr），请确保网络可访问
Android 11+ 需在系统中允许本应用 安装未知应用，否则更新或外部 APK 可能无反应
开机自启 依赖系统广播；部分品牌需在系统设置中允许 自启动 / 后台活动 才可能生效

---

播放协议与地址格式

应用内播放器基于 Media3（ExoPlayer），根据 播放地址的 URL 自动判断类型（Util.inferContentType）。订阅（M3U）里每一行的 频道流地址 若符合下表，一般会走对应协议；若服务端返回的容器与推断不一致，播放器会 在同一 URL 上依次尝试 HLS → DASH → Smooth Streaming → 渐进式，以兼容部分后缀标错的源。

协议	常见后缀 / URL 特征	说明
HLS	.m3u8，或路径中含 m3u8 等	IPTV 直播最常见
DASH	.mpd	MPEG-DASH 清单
Smooth Streaming	.ism、.isml，或常见 Manifest 路径	微软平滑流
RTSP	rtsp://	如监控或部分广电 RTSP 源
渐进式（单文件）	无上述特征时的 直链，如 .mp4、部分 .mkv 等	整文件渐进下载播放

解码：使用带 扩展渲染器 的工厂，便于在部分设备上启用 软件解码 兜底（例如部分 H.265/HEVC 场景），实际能否播放仍取决于 片源编码 与 机型硬件/系统。

当前未接入：UDP/RTP 组播（如 udp://）等需独立组播协议栈的地址；应用侧 HTTP(S) 拉流为主。

---

功能一览

• 上下换台、数字选台、换台顺序可设置
• 节目单（当天）、多节目单与历史切换
• 多订阅源、多线路、失败自动试下一线路
• 频道精选（精选频道）
• 画面比例、播放器相关选项
• 浏览器网页配置（同网段访问 http://设备 IP:1616）
• 应用内检查更新（常规包）
• 开机自启（视系统策略）

---

下载与安装

在 Releases 下载 APK（从 1.0.0 起提供公开构建）。每个版本通常包含 两个 安装包，请按需选择：

文件	适用说明
vstv-<版本>-all-sdk21.apk	默认选择：桌面显示 VsTV，包名 com.vesaa.mytv，适合大多数电视 / 盒子 / 手机。
vstv-<版本>-all-sdk21-HarmonyOS.apk	华为智慧屏 / 需不同包名 时使用：桌面名 Z 视介，包名 com.chinablue.tv，与上表 数据与更新通道不互通，请勿混用升级包。

应用内 检查更新 仅匹配 常规包；若安装的是 HarmonyOS 变体，请自行到 Release 页下载带 HarmonyOS 后缀的包升级。

---

使用说明（摘要）

遥控器：上下换台，左右切多线路，OK 确认，菜单/帮助/长按 OK 或双击屏幕打开设置等（与常见视频应用习惯接近）。触屏：滑动模拟方向键，点击为确认，长按 / 双击对应长按 OK / 菜单。

设置：在播放界面按上述手势进入；关于 位于设置网格最后一项，内含本机 网页配置地址、切换扫码用 IP 与 二维码。

网页配置：浏览器打开 http://<电视 IP>:1616，可修改直播源、节目单等（与电视端设置写入同一配置）。

更细的操作项（多源、多线路规则、节目单格式等）与历史版本变更见 CHANGELOG.md。

---

更新日志

CHANGELOG.md

---

声明与免责

1. VsTV（仓库标识 vstv）按 「现状」 提供，作者及贡献者 不对 因使用本软件造成的任何直接、间接、偶然或后果性损害承担责任，包括但不限于：设备故障、数据丢失、流量费用、版权纠纷、服务中断或内容不合规等。
2. 应用 不内置直播订阅；内置仅为 可选节目单模板 等默认项，相关链接多来自互联网公开信息，仅供个人学习、研究与连通性测试；不保证 合法性、稳定性、完整性或持续可用。你必须自行判断 并确保在当地法律允许范围内使用。
3. 播放内容由 第三方地址 提供，本应用 不存储、不二次分发 节目流；不提供 破解、绕权或任何违法内容获取方式。
4. 更换为你自己的订阅地址后，你应对该地址及播放内容承担全部责任。
5. 本声明不排除适用法律规定的强制性责任条款；若你不同意上述内容，请 不要使用 本软件。

---

其他致谢

以下为对有关开源项目及作者的致谢与参考来源（与上文「节目单模板与社区」区分）。VsTV 本仓库独立维护，与下列项目之间不构成 Git 意义上的上游/下游或自动同步关系；此处仅表达感谢与说明灵感来源。

• mytv-android 及贡献者
• my-tv
• 参考设计稿
• IPV6 直播源
• live