VsTV 让你在 智能电视、电视盒子、平板或手机 上收看直播频道：选台、换台、多线路、节目单、精选频道、比例与音量等常见需求都可在应用内完成。首次安装不会写入默认直播源，需在 设置 或浏览器访问 http://设备 IP:1616 自行配置订阅地址与节目单。本应用不提供任何直播源或节目内容，请仅使用你已获得合法授权的地址。

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

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

---

• 🚀 极度轻量与响应：全包体积不足 5MB，剔除所有冗余库。针对低端盒子（如 S905 系列）深度优化内存占用，秒速启动，操作丝滑不卡顿。
• 🛰️ 原生组播支持 (专为电信/联通/移动 IPTV 优化)：
  • 核心突破：内置原生组播协议栈，支持 udp:// 和 rtp:// 直流。
  • 无需转发：不再需要额外的 udpproxy 或组播服务器转发，直接插入网线/连接 Wi-Fi 即可流畅播放 4K 组播源。
  • 超低延迟：独家 MulticastLock 锁技术，防止 Android 系统静默丢包，换台响应提升 50% 以上。
• 🔗 多源合一与智能合并：
  • 支持配置多个订阅源。通过「扩展频道」逻辑，不同来源的同名频道会自动合并为多线路，实现全网源无缝汇总，打造属于自己的全能频道库。
• 👨‍👩‍👧‍👦 老人 / 儿童精选模式：
  • 操作极简：支持一键将频道加入「精选」。
  • 专注模式：开启「只看精选」后，屏蔽所有复杂列表，仅保留心仪频道，换台仅在精选内循环，彻底解决长辈「找台难」的问题。
• ⏲️ 全能时移回看：
  • 完美适配运营商标准 catchup 模板，支持最高 7 天历史节目回看。
  • 播放过程中支持进度条拖动与一键返回直播。

---

🛠️ 重点功能操作说明

1. 如何使用运营商组播 (UDP/RTP)？

1. 在直播源订阅中直接填入 udp://@239.x.x.x:xxxx 或 rtp://239.x.x.x:xxxx 地址。
2. 确保电视/盒子连接在 IPTV 专网（通常需接光猫 iTV 口或配置 VLAN）。
3. VsTV 会自动获取组播锁并开启 2MB 超大接收缓冲区，无需任何额外配置即可享受零卡顿 4K 体验。

2. 如何实现多源合并？

1. 在设置中添加多个直播源（如：源 A 是央视高清，源 B 是地方频道）。
2. VsTV 会自动按频道名称进行聚合。如果多个源包含同名频道（如「CCTV1」），选台界面会将其显示为「线路 1/2/3...」，左右键即可快速切线。

3. 如何开启「老人模式」？

1. 标记精选：在选台列表中，长按 OK 键将频道加入精选。
2. 开启锁定：进入 设置 → 精选设置，勾选 「只看精选列表」。
3. 效果：此后上下换台将仅在精选频道中切换，UI 界面也会隐藏非精选内容，简洁纯净。

4. 长按确认键：快速切换直播源（约 v2.1.11+）

在全屏 或分屏播放时，长按遥控器确认键，可打开 默认直播源快速切换：在 当前使用的订阅地址 与 设置里曾保存过的直播源历史 之间选择并切换（仅切换、不添加新地址；历史至少再有一条时才会出现可选列表）。适合在多个 M3U / 订阅之间临时换源而无需先进入设置。

---

首次配置说明

• 直播源：无内置默认订阅。安装后请在 设置 → 直播源 或 网页配置页 填写你的 M3U / tvbox 风格 TXT 等地址；换源、请求头等与播放相关的配置均由你自行提供。
• 节目单：提供上述 两套 EPG 模板 作为可选起点，你可在设置中改为自己的 XMLTV 地址或关闭节目单。
• 订阅地址来源：请仅使用你已获得合法授权的订阅地址；请自行核验来源合法性、服务条款与可用性。

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

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

• 公开可访问的节目单数据源维护者 — 特此感谢

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

---

适用环境

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

使用本应用时建议了解

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

---

直播源支持

VsTV 支持常见的电视直播订阅格式，下面是最常用的 4 类：

• 标准 M3U 直播源（最通用）

  • 典型结构：#EXTM3U + #EXTINF + 播放地址。
  • 适用场景：大多数公网/内网 IPTV 订阅。
  • 简例：
    • http://example.com/live.m3u
    • https://example.com/iptv/playlist.m3u8

• 影视仓/TVBox 风格直播源

  • 兼容 分组名,#genre# + 频道名,地址 结构（常见于“影视仓直播源”“TVBox 直播源”）。
  • 支持单频道多线路（地址 1#地址 2）与分辨率后缀（如 地址$1920×1080，会自动忽略 $ 后描述）。
  • 简例：
    • 央视频道,#genre#
    • CCTV1,http://a.example/live1.m3u8#http://b.example/live1.m3u8

• TXT 直播源

  • 本质上与上面的 TVBox/影视仓风格同类，常见扩展名为 .txt。
  • 适用场景：社区维护的分组文本订阅、家庭自建文本列表。
  • 简例：
    • http://example.com/channels.txt

• rtp2httpd 播放列表

  • 可直接填写 rtp2httpd 输出的播放列表 URL，VsTV 会按 M3U 方式读取。
  • 若列表里是相对路径（如 /rtp/...、./xx.ts），VsTV 会自动按订阅地址做绝对化后播放。
  • 适用场景：家里开通运营商 IPTV 后，通过软路由或 Docker 部署 rtp2httpd，在局域网内统一分发播放列表。
  • 简例：
    • http://192.168.1.1:5140/playlist.m3u

播放协议识别

播放器基于 Media3（ExoPlayer），根据频道 URL 自动识别协议类型；若服务端返回容器与推断不一致，播放器会在同一 URL 上尝试兼容回退（如 HLS → DASH → Smooth Streaming → 渐进式）。

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

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

内置：mediax / FFmpeg 扩展软解

• 相对上游 Jellyfin 默认配置，启用了更多 FFmpeg 解码器（如 h264 / hevc / vp9 / av1 / opus 等），以提升不同设备与片源组合下的解码兼容性。

---

功能一览

• 上下换台、数字选台、换台顺序可设置
• 节目单（当天）、多节目单与历史切换
• 时移回看（节目单 / 快捷面板等；依赖 M3U 与源站能力）
• 多订阅源、多线路、失败自动试下一线路
• 频道精选（精选频道）
• 画面比例、播放器相关选项
• 浏览器网页配置（同网段访问 http://设备 IP:1616）
• 应用内检查更新（自动匹配对应 Release 附件）
• 开机自启（视系统策略）
• WebVTT 字幕（HLS #EXT-X-MEDIA:TYPE=SUBTITLES）
• SRT / DVB Subtitle / PGS 蓝光字幕（Media3 内置解码）
• ASS/SSA 字幕（无内置解码器，暂不支持）
• TS 内嵌 CEA-608 字幕（Media3 内置 Cea608Decoder）

---

下载与安装

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

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

应用内 检查更新：2.0.0+ 按安装类型与设备架构匹配附件——常规包优先 …-arm.apk 或（x86/x86_64）…-x86_64.apk；HarmonyOS 变体（包名 com.chinablue.tv）仅匹配 …-HarmonyOS.apk。旧版本升级到 2.0.0 的首轮更新逻辑见 CHANGELOG 中 2.0.0 说明。

---

使用说明（摘要）

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

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

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

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

---

更新日志

CHANGELOG.md

README 摘录（v2.1.12）：长按确认键可快速切换直播源（详见上文「重点功能操作说明 → 5」）。

---

声明与免责

1. VsTV（仓库标识 vstv）仅作为通用播放器工具按 「现状」 提供，作者及贡献者 不对 因使用本软件造成的任何直接、间接、偶然或后果性损害承担责任，包括但不限于：设备故障、数据丢失、流量费用、服务中断或内容合规争议等。
2. 应用 不内置、不提供、不分发任何直播源或节目内容；用户需自行导入并仅使用已获得合法授权的地址。
3. 播放内容来自用户配置的第三方地址，本应用 不控制、不审核、不托管、不缓存分发 相关内容；应用仅提供本地播放能力。
4. 用户应自行确认其订阅地址、节目内容与使用行为符合所在地法律法规及服务条款；由此产生的风险与责任均由用户自行承担。
5. 本声明不排除适用法律规定的强制性责任条款；若你不同意上述内容，请 不要使用 本软件。

---

其他致谢

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

• mytv-android 及贡献者
• my-tv
• 参考设计稿