关于

一个播放器,两份界面,一套业务

壹影 OneFilm 是基于 FongMi/TV 的 fongmi 分支二次开发的 Android 影视播放器。这一页说明它由什么构成、边界在哪、以及你需要知道的许可与隐私事实。

它是什么

一个外壳。它把「接口返回的影片信息」变成「电视上能点、能播、能记住进度」的界面,但不生产也不分发内容。

它同时面向两类设备,并且认真对待两者的差异:电视是横屏、遥控器、远距离观看;手机是竖屏、手指、贴身使用。两端的界面实现互相独立,共享的只有数据、网络、播放会话与设置存储。

它不做的事:不提供接口、不内置片源、不做账号体系、不上传观看记录、不弹广告。

技术构成

能用 Kotlin 写的地方,都用 Kotlin 写

应用层

Kotlin + Jetpack Compose,Gradle 多模块工程。TV 与手机各自独立的宿主、资源与 UI 源集,共享业务模块。最低支持 Android 7.0。

接口与爬虫

CatVod 风格配置解析,爬虫按语言分派到 Java、QuickJS 与 Chaquopy(Python)三个运行时执行,与生态里已有的接口实现保持兼容。

播放

Media3 与 MPV 两条播放路径并存:前者功耗与起播占优,后者对少见编码与多音轨更宽容。两条路径共用播放界面与进度记录。

为什么电视包锁 targetSdk 28

爬虫运行库需要在进程内加载本地库;在更高的目标版本上,这个加载方式会被系统拒绝,2 GB 内存的盒子直接崩溃。因此电视包固定 28,手机包不设此限制。

与上游的关系

项目源自 FongMi/TV 的 fongmi 分支,保留其接口生态、播放内核与大部分底层能力,在此基础上重做了两端界面、播放器面板、配置中心、首页数据源与内存管理。

上游的 main 分支与本项目走的是不同路线,两者的配置格式虽然同源,界面与交互已经分叉。上游仓库不接受本项目的改动回推,本项目也不跟随上游的界面变更。

仓库里另有一个独立的 website/ 目录,是上游技术文档站的延续,讲爬虫编写与接口格式;本站在 oenfilmweb/,面向使用者。两者内容不重叠。

许可

本项目继续使用 GNU General Public License v3.0。这意味着你可以自由使用、研究、修改与再分发,但再分发时必须同样开源,并保留原作者版权声明。

源代码在 Viciy2023/Onefilm。二次打包并公开分发的版本,需要一并提供对应源码——这是 GPL 的要求,不是可选项。

隐私说明

没有账号,没有登录,没有云同步。收藏、观看历史、续播进度、接口配置全部保存在本机,卸载即清除。

会联网的三件事

  • 你配置的接口——请求由你填写的地址发起,数据流向由该地址决定,与本项目无关;
  • 更新检查——启动时读取发布清单以判断是否有新版本,这会向发布用的 CDN 暴露 IP 与客户端版本;
  • 崩溃统计——应用集成了崩溃上报,崩溃发生时会上传堆栈、设备型号与系统版本,用于定位问题。不上传观看内容、接口地址或本地记录。

本站

这个官网是纯静态页面:不使用 Cookie、不加载第三方脚本、不做访问统计。唯一的外部请求是页面主动拉取发布清单以显示当前版本号与下载地址。

免责声明

壹影 OneFilm 不提供、不内置、不附带、不推荐任何影视内容、直播源或可用接口。应用安装后为空壳,全部内容来自使用者自行配置的第三方接口。

使用者应确保所配置接口的内容来源合法,并自行承担使用行为产生的全部责任。开发者不对第三方接口的可用性、内容合法性、稳定性或安全性作任何担保。

请勿将本应用用于侵犯著作权、传播违法内容或其他违反所在地法律法规的用途。如你所在地区对这类软件有使用限制,请遵守当地规定。

页面中出现的影片名称、海报与接口地址均为开发测试时的演示内容,与任何实际服务无关。

反馈渠道

问题与建议走 GitHub Issues:Viciy2023/Onefilm/issues。

提之前请先确认两件事:装的是哪一端(TV / 手机)、哪个 ABI;问题能否在换线路或换内核后复现。带上这两条,排查会快很多。

不接受的内容:接口地址分享、片源求取、绕过付费的请求。这类问题与项目定位冲突,不会处理。

致谢

这个项目站在不少开源工作的肩上:

  • FongMi/TV——本项目的上游,接口生态与播放内核的基础;
  • AndroidX Media3——主播放路径;
  • mpv / libmpv——兜底播放路径;
  • Coil——图片加载;
  • QuickJS 与 Chaquopy——脚本爬虫运行时。

以及所有提交过 Issue、帮忙复现过崩溃的使用者。