Skip to content
gooooddayyPublic

About

L1box · TVBox竖屏版手机版(空壳 · 自行配置)· 安卓影视播放器· 追剧客户端 · AGPL-3.0

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

L1Box

安卓手机影视播放器(空壳 · 自行配置) —— 基于开源播放器框架二次开发的竖屏版本。

针对手机竖屏使用场景做了大量体验与稳定性改造:竖屏布局与手势、播放内核选择与回退、 搜索链路可靠性、配置解析容错、起播与缓冲控制等。

本软件自身不含任何内容源:不内置视频源、不提供任何数据地址、不涉及内容获取渠道。 所有内容来源均由使用者自行配置并自行负责。

  • 包名: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。

为什么 targetSdk 停在 28

本工程的脚本模块以加固 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/ 与 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; 播放器、字幕解析等子组件的原有版权声明均已在源码中保留。

致谢

About

L1box · TVBox竖屏版手机版(空壳 · 自行配置)· 安卓影视播放器· 追剧客户端 · AGPL-3.0

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages