安卓手机影视播放器(空壳 · 自行配置) —— 基于开源播放器框架二次开发的竖屏版本。
针对手机竖屏使用场景做了大量体验与稳定性改造:竖屏布局与手势、播放内核选择与回退、 搜索链路可靠性、配置解析容错、起播与缓冲控制等。
本软件自身不含任何内容源:不内置视频源、不提供任何数据地址、不涉及内容获取渠道。 所有内容来源均由使用者自行配置并自行负责。
- 包名:
com.github.tvbox.osc - 版本:
1.0.0 - 平台:Android(手机竖屏)
- 编译:
compileSdk 33/minSdk 24/targetSdk 28
播放
- ExoPlayer / ijkplayer 双内核,播放页可切换,硬解失败自动回退
- 缓冲水位按设备档位分档(低配设备自动收敛,避免 OOM)
- 磁盘缓存(可开关)、起播看门狗、取链重试与同址换协议重试
- 续播进度记录、片头提示、连播倒计时
界面与交互(竖屏专项)
- 竖屏布局与手势:分类栏滑动 + 右侧自研惯性(指数衰减,非线性插值)
- 分类 Tab 分帧创建、滑动中限流落地,避免卡顿与断触
- 海报图片独立请求通道 + 可见区域预取
数据与搜索
- 多站点并发搜索,结果收敛后统一落地;假空结果被结构性排除
- 配置解析容错、多线路切换、首页冷启动缓存
工程
- Gradle 构建 + 源码级回归闸门(近 900 条静态断言)+ 安装包 dex 符号校验
安装包在 Releases 页,直接下载最新 .apk 安装即可。
本仓库为个人学习与技术存档用途,不接受 issue / PR。
本工程的脚本模块以加固 jar 形式分发,其解密后的内层 dex 会写入可写目录再加载。
Android 10+ 对 targetSdk >= 29 的应用强制 W^X 限制,会导致该内层 dex 偶发加载被拒,
进而触发加固层自检失败并主动退出。28 是当前加固方案的兼容性最优解。
| 组件 | 版本 |
|---|---|
| JDK | 11(AGP 7.2.2 要求) |
| Gradle | 7.3.3(含 wrapper) |
| Android Gradle Plugin | 7.2.2 |
| Android SDK | platform 33 + build-tools 33.0.2 |
# 1. 准备 JDK 11(或在 gradle.properties 里指定 org.gradle.java.home)
# 2. 指向本机 Android SDK
echo "sdk.dir=/path/to/Android/Sdk" > local.properties
# 3. 构建
./gradlew assembleRelease产物输出到 app/build/outputs/apk/release/。
注:
gradle.properties中的kotlin.compiler.execution.strategy=in-process是为低内存机器 (Kotlin 守护进程原生内存分配失败)保留的稳妥设置,内存充足时可改回默认。
签名库在 keystore/(TVBoxOSC.jks,另有备份 TVBoxOSC_custom_backup.jks):
口令 TVBoxOSC、别名 tvboxosc。scripts/build_l1box.sh / sign_l1box.sh 已配好这对参数;
用 gradlew 手动构建时,把 jks 放到工程目录并对应修改签名参数。
升级安装必须同一签名 —— 换签名库会导致已装用户必须卸载重装。
app/ 主模块(竖屏 UI、搜索、订阅、播放页逻辑)
player/ dkplayer 播放器模块(缓冲接管、内核选择)
quickjs/ JS 引擎
crash/ 崩溃捕获
TabLayout/ 分类 Tab 组件
ViewPager1Delegate/ 分类栏滑动委托
tools/fakeboot/ 桌面 JVM 桩类(用于免真机跑订阅解析用例)
scripts/ 构建、质量闸门与真机日志分析脚本
docs/ 开发过程文档(方案、验证记录、踩坑)
scripts/ 里是本项目开发期使用的构建、质量闸门与真机日志分析脚本,作为参考提供。
其中出现的 <工作区> / <本机> 是路径占位符(原为本机绝对路径),使用前请替换为你自己的路径;
build_l1box.sh 假定工作区下存在 FreeBox-src/ 目录结构,与当前仓库布局不同,直接跑需要微调。
docs/ 是开发过程的完整记录:方案设计、真机验证结论、踩坑与已否决方案。
其中设备序列号、局域网地址、私有接口域名与本机路径已做脱敏处理。
本仓库同时是一份可独立重建的项目记忆。换电脑或隔很久再回来时,按这个顺序读:
| 顺序 | 文档 | 说明 |
|---|---|---|
| 1 | 项目交接总纲 | 30 秒速览 → 换机后如何跑起来 → 24 个批次完整沿革 → 35 条硬教训 → 文档与工具索引 → 工作纪律。读完就能上手 |
| 2 | 项目长期记忆 | 长期维护的收敛记忆(测试纪律、版本沿革、硬教训原文) |
| 3 | 文件目录(全量说明) | 逐个文件说明用途,附「我要改 X → 该去哪个文件」导引 |
| 4 | 工作日志 | 08-19 ~ 09-30 逐日全过程记录(29 份,含每天的判定与踩坑) |
| 5 | 全部开发文档 | 150 份专题文档(判定书 / 交付说明 / 测试清单 / 踩坑记录),按 00_总纲与索引 ~ 90_归档过时 分类 |
一句话:
docs/里那 150 份不是顺手写的注释,而是每次改动先取证 → 再判定 → 才动手留下的完整证据链。 想改任何逻辑之前,先按上面的顺序扫一遍 —— 尤其是总纲里的「硬教训」,每一条都对应过一次真实的返工。
本项目是纯粹的播放器客户端框架,自身不含任何内容。
- ❌ 不内置任何视频源、影视资源、解析接口或订阅地址(默认配置
home_config.json中sites为空) - ❌ 不提供任何获取内容的渠道;文档中不推荐、不引导、不暗示任何第三方内容源
- ❌ 不破解任何平台的会员/付费内容,不规避任何技术保护措施
- ❌ 不收费
- ❌ 仓库中不含设备标识、个人路径、私有接口地址(均已脱敏)
- ✅ 仅作为个人学习 Android 开发、播放器内核与网络协议技术的练习与存档
所有内容来源均由使用者自行配置,与本项目作者无关;使用者应自行确认其来源的合法性。 本项目仅供学习与技术交流,请于下载后 24 小时内删除。
本项目作者不提供、不维护、不推荐任何第三方内容源。任何以本项目名义提供内容源的行为,均与本项目无关。
本项目基于开源项目 TVBoxOSC(AGPL-3.0)二次开发,自 2026 年 8 月起做了大量修改: 竖屏布局与手势、播放器内核与缓冲控制、搜索链路可靠性、订阅解析容错、起播与缓存策略等。
按 AGPL-3.0 的要求,本项目同样以 AGPL-3.0 发布,完整许可证见 LICENSE; 播放器、字幕解析等子组件的原有版权声明均已在源码中保留。