家里老人看电视,最常抱怨的不是"没好节目",而是"找不到台"。
打开智能电视或者电视盒子,先过一堆开屏广告,再滑过推荐位、会员弹窗、猜你喜欢,好不容易进到直播页——底下还有一排"精彩推荐"在滚动,遥控器上下键稍微按错就跳到购物频道去了。
央视频本身是有网页直播的,画质也不错,CCTV 全套频道都在。问题是那一整套网页 UI 对遥控器极不友好:播放器被塞在页面中间,四周全是内容推荐,遥控器焦点还到处乱跑。
Live TV 就是冲着这个痛点做的:它是个极小的安卓 App,本质是给央视频的直播页套了个壳,然后用一段注入脚本把页面上除了视频以外的东西全部隐藏掉,只留全屏画面。整个 APK 只有 33 KB。
一、它是什么
| 项目 | 信息 |
|---|---|
| 应用名 | 电视直播 / Live TV |
| 包名 | org.eldertv.live |
| GitHub | https://github.com/riowang88/live-tv |
| 当前版本 | v1.2(2026-11-02) |
| 安装包大小 | 33 KB(主版本) |
| 开源协议 | 未声明 |
| ⭐ 星标 | 24(小众项目) |
| 支持系统 | 安卓 5.0+(minSdk 21) |
| 内容来源 | 央视频 yangshipin.cn + 央视网 tv.cctv.com |
我把它下载下来拆开看了(反编译 APK 逐行读了源码),下面写的功能全部来自实际代码,不是照着介绍瞎猜的。
二、它是怎么工作的
理解原理很重要,因为这决定了它能做什么、不能做什么。
它其实是个 WebView 套壳 + 脚本注入的结构:
- 启动后打开央视频的直播页
www.yangshipin.cn/tv/home - 页面加载时往里面注入一段 JS 脚本
- 这段脚本给整个页面套上一条 CSS:把所有元素的
visibility设为hidden - 只把当前正在播放的那个
<video>元素单独放出来,定位成全屏
注入脚本里找播放器的逻辑很有意思——它不靠网站的 CSS 类名(网站一改版就失效),而是按面积找页面上最大的 <video> 元素:
function bigVideo() {
var best = null, area = 0, list = document.querySelectorAll('video');
for (var i = 0; i < list.length; i++) {
var v = list[i], a = (v.videoWidth||1)*(v.videoHeight||1) + v.clientWidth*v.clientHeight;
if (a > area) { area = a; best = v; }
}
return best;
}
这个写法比"按类名找"抗改版能力强得多。作者注释里也写了:Deliberately free of site class names: the player is located by geometry and video size.
三、功能详解
1. 全屏纯净播放
页面上除了视频,别的一律不可见。背景强制纯黑,防止露出白底。播放器被强制铺满整个屏幕,object-fit: contain 保证不变形。
它还处理了一个很隐蔽的坑:如果播放器的某个祖先元素带了 transform、filter、contain 这类 CSS 属性,position: fixed 就会失效,播放器会被"困"在那个容器里而不是铺满屏幕。脚本会把祖先链上这些属性全部强制清掉:
var props = ['transform','filter','perspective','contain','will-change','clip-path'];
for (var e = v.parentElement; e && e !== document.documentElement; e = e.parentElement) {
for (var i = 0; i < props.length; i++) e.style.setProperty(props[i], 'none', 'important');
}
这种细节能想到,说明作者是真在电视上试过的。
2. 遥控器按键映射
这是它最核心的体验。按键映射是从源码里抄出来的,可以直接对照:
| 按键 | 播放界面 | 频道列表打开时 |
|---|---|---|
| 上 / 下(19/20) | 无操作 | 无操作 |
| 右(22) | 切换画质(1080P ⇄ 720P ⇄ 540P) | 切换画质 |
| 左(21) | 无操作 | 无操作 |
| 确认 / OK(23/66/160) | 打开频道列表 | 选中频道并切换 |
| 菜单(82) | 打开频道列表 | 选中频道并切换 |
| 上一频道(166) | 上一个台 | 列表光标上移 |
| 下一频道(167) | 下一个台 | 列表光标下移 |
| 返回(4) | 3 秒内按两次才退出 | 关闭列表 |
这个映射非常"老人机"思路——大部分按键都不响应,只留下真正需要的几个。不会出现"按错一下就跳到奇怪页面"的情况。返回键要做二次确认,也是防止误退。
3. 频道列表侧边栏
按 OK 或菜单键,从左侧滑出一个 460dp 宽的侧栏,里面两个部分:
- 顶部一行:当前画质,点一下就能切换
- 下方列表:电视频道列表,带当前正在播出的节目名
列表里的节目名是从央视频的 EPG(电子节目单)接口实时取的,每 5 分钟更新一次。所以列表长这样:
CCTV-1 综合 新闻联播
CCTV-2 财经 经济半小时
CCTV-5 体育 体育新闻
CCTV-13 新闻 焦点访谈
不用切过去就知道在播什么,这是它比"纯换台"好用的地方。
4. 画质三档 + 记忆
画质有 1080P / 720P / 540P 三档,按右键循环切换,屏幕上会弹出提示"清晰度 1080P"。
选定的画质会写进本地配置(SharedPreferences),下次打开还是这个档位,不用每次重设。
getLiveUrlsByVid 方法,在请求流的阶段就把画质参数替换掉。这样才能真正做到"换台后画质不变"。5. 无画面自动切备用线路
这是它最实用的兜底机制:
| 情况 | 等待时间 | 动作 |
|---|---|---|
| 冷启动(首次加载) | 35 秒 | 无画面则切备用线路 |
| 换台(已在页面内) | 20 秒 | 无画面则切备用线路 |
| 播放卡住 | 15 秒无进度 | 尝试重新播放,还不行就切线路 |
备用线路是央视网自己的直播页 tv.cctv.com/live/,比央视频更老但更稳。切过去后可播。
不过要说明一点:备用线路固定 720P,不能切画质。这时候按右键会提示"备用线路固定 720P"。这是个已知限制,不是 bug。
6. 实时网速显示
画面上会显示当前网速,格式是 网速 2.4 MB/s 或 网速 850 KB/s。每秒更新一次,用的是系统流量统计(TrafficStats),不是估算。
对电视盒子特别有用——卡的时候看一眼就知道是自己家宽带的问题还是源的问题。
7. 崩溃自恢复
源码里有 onRenderProcessGone 的处理和 LiveClient(自定义 WebViewClient)。WebView 的渲染进程崩了,App 不会直接闪退,而是能恢复。
电视盒子内存小、长时间开机,这个处理很实际。
四、优点
1. 小到离谱:33 KB
主版本 live-tv-v1.2.apk 只有 33 KB。对比一下,随便一个电视 App 都是 50MB 起步。33KB 意味着:
- 装上去几乎不占空间
- 不会有后台服务、不会有推送、不会有升级弹窗
- 打开速度极快
2. 只申请一个权限
反编译确认,它申请的权限只有一个:
android.permission.INTERNET
没有存储权限、没有位置、没有电话、没有读取应用列表、没有悬浮窗。而且它没有任何 Service,没有任何 BroadcastReceiver——意味着它不会在后台偷偷跑任何东西。
对电视盒子这种"装上就不管了"的设备,这点非常重要。
3. 不抓流、不代理,视频走官方服务器
这是很多人会担心的问题:这种"小工具"是不是在偷偷转播?会不会哪天源就挂了?
这个 App 不是。它打开的就是央视频的官方网页,视频数据直接从央视频的服务器到你电视上,中间没有经过任何第三方服务器。所以:
- 画质是官方的画质
- 频道是官方的频道
- 不会有"源失效"的问题(只要央视频还提供网页直播)
- 不会有人收集你的观看记录(除了央视频自己)
4. 遥控器体验是真为电视设计的
前面那张按键表能看出来,它是按电视遥控器的使用习惯设计的,不是把手机 App 硬搬到电视上。上下键不响应、返回键二次确认、右键切画质——这些细节手机 App 上根本不会考虑。
5. 无广告、无推荐、无弹窗
页面上的东西全被 CSS 隐藏了,自然也就没有广告位、没有会员弹窗、没有"猜你喜欢"。
6. 记住你的选择
上次看的频道、上次选的画质,都存在本地。开机直接回到上次的状态。
五、下载地址
官方下载(唯一渠道): https://github.com/riowang88/live-tv/releases
当前版本 v1.2 的文件:
| 文件 | 大小 | 适用 |
|---|---|---|
live-tv-v1.2.apk | 33 KB | 推荐,现代设备用这个 |
live-tv-v1.2-android5.apk | 78.5 MB | 安卓 5.x 老设备 |
live-tv-v1.2-android4.1.apk | 60 MB | 安卓 4.1 老设备(作者标注"未测试") |
直接下载链接:
- 标准版(33 KB)
https://github.com/riowang88/live-tv/releases/download/v1.2/live-tv-v1.2.apk - 安卓 5 老设备版
https://github.com/riowang88/live-tv/releases/download/v1.2-old-android/live-tv-v1.2-android5.apk - 安卓 4.1 老设备版
https://github.com/riowang88/live-tv/releases/download/v1.2-old-android/live-tv-v1.2-android4.1.apk
这个项目没有在国内 Gitee 或其他镜像发布,只有 GitHub。下载慢的话可以用加速镜像,但注意核对文件大小是否一致。
六、安装方法
电视盒子 / 智能电视(主流做法)
方式一:U 盘安装
- 电脑上下载
live-tv-v1.2.apk,拷到 U 盘(FAT32 格式最稳) - U 盘插到电视或盒子上
- 打开盒子自带的"文件管理"或"媒体中心",找到 apk 文件
- 点它安装。系统会提示"禁止安装未知来源应用"——去设置里允许当前文件管理器安装应用
- 装完在应用列表里找「电视直播」
方式二:电视助手 / 当贝市场类工具
如果盒子上装了这类应用市场,可以用它们的"本地安装"功能,或者手机端推送安装。
方式三:adb 安装(适合折腾党)
adb connect 192.168.1.x:5555 # 盒子开启ADB调试后
adb install live-tv-v1.2.apk
手机 / 平板(想先试试)
手机也能装,但体验不佳——没有遥控器按键,只能靠触摸操作,而界面被隐藏得只剩视频,几乎无法操作。建议只当作验证它能播,长期用还是上电视。
系统要求
| 项目 | 要求 |
|---|---|
| 安卓版本 | 5.0 及以上(minSdk 21) |
| WebView 内核 | Chrome 60 以上 |
| 网络 | 能访问 yangshipin.cn |
怎么看 WebView 版本:设置 → 应用 → 找到「Android System WebView」或「Chrome」→ 看版本号。低于 60 的话,用 android5.apk 那个自带内核的版本。
七、使用技巧
技巧 1:第一次进去等 20~35 秒
App 启动后要先加载央视频网页、找播放器、起播。首次冷启动最长要等 35 秒(代码里的 NO_PICTURE_COLD_MS = 35000),之后换台只要 20 秒内。
这段时间屏幕上可能是黑屏或者只有网速数字。别急着退出,等一等就出来了。如果超过 35 秒还没画面,它会自动切央视网备用线路。
技巧 2:右键是万能的
在整个播放界面里,右键是唯一的功能键——切画质靠它,在列表里也是它切画质。
记住这一条就够了:想调清晰度,按右键。
技巧 3:换台用"上一台/下一台"键最快
电视遥控器上标着 CH+ / CH-(或者 P+ / P-)的键,对应代码里的 166/167。不打开列表直接按,就是上一个台/下一个台,比打开列表选快得多。
打开列表后,这两个键就变成了"光标上移/下移"。
技巧 4:卡的时候先降画质,再考虑换线路
CCTV 的 1080P 直播码率不低。老盒子解码能力弱的话,会出现"网速够但画面卡"。
处理顺序:
- 按右键切到 720P → 看是否流畅
- 还卡就切 540P
- 如果三个都卡,那可能是盒子性能问题,跟画质无关
技巧 5:备用线路别指望画质
一旦切到央视网备用线路,画质就被锁死在 720P 了,按右键只会提示"备用线路固定 720P"。
技巧 6:频道列表能看节目单,善用它
列表里每个频道后面跟着当前正在播的节目名(来自央视频 EPG)。换台前先看一眼在播什么,比盲切省事很多。
节目单每 5 分钟更新一次,不是实时的,所以整点前后的节目名可能还没刷新。
技巧 7:返回键要按两次,这是故意的
在播放界面按返回键,第一次不会退出,3 秒内再按一次才真的退出。这是防误触设计。
如果只是想关掉侧边列表,按一次返回就够了。
技巧 8:卡了就让它自己修
播放卡住超过 15 秒没进度,App 会自己尝试重新播放;重试还不行会切线路。所以遇到卡顿先别急着退,给它 15~20 秒自己恢复。
技巧 9:老设备先试标准版
即使你的盒子比较老,也先试 33KB 的标准版。如果打开是白屏、黑屏不动、或者直接闪退,那才是 WebView 太旧,再换 android5.apk 或 android4.1.apk。
别一上来就装 78MB 的老设备版,白占空间。
技巧 10:这个项目只发安装包,介意就别用
得说清楚:这个仓库里没有源代码,只有一个 4KB 的空白 README。作者只上传了编译好的 APK。
这意味着:
- 你无法验证它到底做了什么(我只能从反编译结果告诉你它现在做了什么)
- 也无法自己编译
- 更无法保证以后更新的版本还是干净的
我的建议:如果你不放心,就只用当前这个 v1.2,不要开启自动更新(它本身也没有自动更新机制,这算是好事)。真要长期用,定期反编译检查一下新版本,或者干脆自己写一个类似的壳——原理上面都写清楚了,注入脚本也就 200 行。
八、适合谁 / 不适合谁
适合:
| 你是 | 因为 |
|---|---|
| 家里有老人看电视 | 遥控器操作极简,没广告没弹窗 |
| 有闲置电视盒子 | 33KB 装上去几乎无感 |
| 只看 CCTV 频道 | 央视频的 CCTV 全套都有 |
| 受不了智能电视广告 | 页面 UI 全隐藏,只剩画面 |
| 想给老人简化操作 | 记住频道和画质,开机即看 |
不适合:
| 你是 | 因为 |
|---|---|
| 想看卫视/地方台/境外台 | 只有央视频的频道,没有其他台 |
| 想看电视回看/点播 | 只有直播 |
| 必须开源可审计才用 | 仓库没有源代码 |
| 用的是原生鸿蒙电视 | 不是安卓,装不了 |
| 追求 4K | 最高 1080P |
九、几句实在话
这个项目很小众,24 颗星,没有源码,也没有正式的开源协议。按我一贯的标准,这种项目我是会先打问号的。
但拆开之后,我确实看到了认真做产品的痕迹:
- 找播放器不用类名而用面积/尺寸,抗网站改版
- 处理了 CSS 祖先链
transform导致fixed失效这个专业坑 - 冷启动和换台用不同的超时时间(35s vs 20s)
- hook 播放器请求而不是切完再切画质
- 从后台回来时重置卡顿计时器,不算上离开的时间
- 上下键故意不响应,防止误操作
- 返回键二次确认
这些都不是"套个 WebView 就完事"能做到的。
如果你只想让家里老人按一个键就能看新闻联播,不折腾、不折腾、再不用折腾——这个 33KB 的小东西,确实把这件事做到了。
相关链接:
- GitHub 项目:https://github.com/riowang88/live-tv
- 下载页:https://github.com/riowang88/live-tv/releases