qingju-tv

项目概述

老旧电视往往因为系统太旧、内存太小而装不上新应用，青聚的做法是反过来适配设备：这款 Kotlin 短剧客户端专为 Android 5.1、ARMv7、1GB 内存的电视打造，已在小米 L43M7-EA 上实测遥控播放、1080P 与倍速。它保留剧架、排行榜、分类、收藏与历史界面，用系统解码器播放，不依赖任何服务器部署。

项目	内容
平台	Android TV，Android 5.0 及以上（最低 API 21）
实测设备	小米 L43M7-EA（Android 5.1.1 / ARMv7 / 1GB 内存）
技术栈	Kotlin、ExoPlayer/Media3、TextureView
许可	GPL-3.0-only

1GB 内存的老电视也能顺畅连播 1080P 短剧。

主要功能

• 遥控器操作：确认键暂停/继续，菜单键呼出控制栏并聚焦暂停按钮，正确处理按下、抬起与长按重复事件
• 清晰度切换：480P / 720P / 1080P 三档上限，切画质保留播放位置与暂停状态
• 画面调整：原比例、铺满裁剪、拉伸，以及 125%/150% 放大裁剪，选择会保存
• 跨集预取：同一 ExoPlayer 保留当前集与下一集队列，后台预取下一集并预热 1MiB 数据，跨集不重建解码器
• 容错重试：播放失败 10 秒后有限重试一次，不下载整剧、不合并大文件

遥控器操作

• 播放中按确认键暂停或继续，菜单键打开控制栏
• 控制栏内左右选择上一集、下一集、选集、倍速、画面与清晰度
• 控制栏隐藏时，左右键快退/快进 10 秒，上下键呼出控制
• 返回键进入剧集详情页

安装与升级

1. 从 Releases 下载 QingjuTV-0.4.0-android5.apk
2. 将 APK 复制到 U 盘安装，或用 ADB 侧载：adb install -r app-debug.apk
3. 包名为 local.qingju.tv，可覆盖更新本项目旧版本，不会覆盖红果官方应用
4. 自行构建需要 JDK 17、Android SDK Platform 36 与 Gradle 8.14.3，执行 ./gradlew :app:assembleDebug

系统要求

项目	要求
操作系统	Android 5.0 及以上
架构	兼容 32 位 ARM（ARMv7），纯 JVM 应用无 JNI
解码	使用系统解码器，依赖设备自身能力

注意事项

• DNS 误拦截：若片单正常但播放失败，检查路由过滤是否把 log5-applog-lf.fqnovel.com 解析到了 0.0.0.0，可仅对电视 IP 添加该域名的过滤例外
• 连续播放：切集间隔取决于网络与片源编码变化，不保证每次零间隔
• 封面兼容：Android 5 不支持的封面格式会显示占位图
• 签名说明：发布包为调试签名测试版，正式分发请使用自己的签名密钥