TVBOX 风格配置
导入常见的 TVBOX / CatVod 影视配置:多仓结构、站点列表、分类与筛选规则、解析地址都按原样读取,不需要手工改写成另一套格式。
壹影不做内容,只把「接口给的东西,稳稳放到屏幕上」这一件事拆开做透:怎么读接口、怎么找片、怎么播、怎么跳过不想看的、怎么看完整。
影视 App 的体验上限,一半由接口质量决定。壹影的做法是:把接口当成可插拔的一等公民,格式尽量跟生态对齐,换源不用换 App。
导入常见的 TVBOX / CatVod 影视配置:多仓结构、站点列表、分类与筛选规则、解析地址都按原样读取,不需要手工改写成另一套格式。
直播与点播分开管理。m3u / txt 形式的频道列表可直接载入,频道分组、台标与线路切换沿用同一套焦点与手势逻辑。
接口里写的爬虫,按语言分别交给 Java、QuickJS(JavaScript)与 Chaquopy(Python)执行,与生态里已有的接口实现保持兼容。
三种都支持,按手边条件选一种:
配置支持多份并存:可以同时留一个主用接口和一个备用接口,接口失效时切换过去,收藏与历史不受影响。
片名只有一个,能播的地方可能有十几处。聚合搜索并发询问各站点,结果按来源分组呈现,并标出条目数量与可用性——判断哪条线路值得点,不用来回试。
聚合搜索是所有操作里最重的一步:它要在短时间内创建大量脚本引擎,每个引擎都带自己的运行时与缓存。引擎不释放,内存就只涨不落——低配盒子上表现为整机卡死,然后被系统回收。
0.1.22 起,搜索过程改为按站点即时释放,只保留少量活跃引擎;每 10 个站点做一次兜底回收,超时的站点强制释放。代价是搜索总耗时略增,换来的是内存曲线不再随站点数线性爬升。
同一个片源,在不同设备上能不能播,往往取决于解码器与容器支持。壹影同时打包了 Media3 与 MPV 两条播放路径,遇到前者处理不了的编码、音轨或字幕,可以切到后者。
走系统与 Exo 系解码,功耗与起播速度占优,适合绝大多数 HLS 源与常规编码。广告过滤的清单解析也挂在这条路径上。
自带解码与渲染栈,对少见编码、异常封装、多音轨与内嵌字幕的容忍度更高。代价是占用更大,适合当作兜底而不是默认。
两条路径共用同一套播放界面与进度记忆:切换内核不会丢当前进度,回来还是那一秒。
很多源的广告不是插在页面里,而是直接拼进 m3u8:正片清单前面挂几个独立分片,播放器照单全收。壹影在解析清单时就把这类分片摘掉,再交给播放器。
三条并行,规则没覆盖的新源也有机会被后两条兜住。
#EXTINF:5.0,
https://cdn.example.com/ad/15s_01.ts
示意:广告作为独立分片挂在正片清单前部,时长短、路径带 ad 标识、与前后分片的时间轴不连续——三个特征里命中任意一个即可标记。
兼容常规弹幕接口,也可以填自建 API。按片名与集数自动匹配,匹配不上时手动指定。渲染走独立图层,不阻塞视频解码。
大屏上的弹幕默认比手机克制:行数更少、字号更大、速度更慢,避免远距离观看时糊成一片。
把手机界面投到电视上,问题不在清晰度,而在「下一步在哪」。壹影把两端的导航从根上分开实现,共享业务、不共享屏幕。
上下左右移动可预测,焦点环始终可见,卡片放大不推挤整页布局。返回键的路径固定:从播放退到详情,从详情退到列表,不会一次退太远。
纵向滚动、顶部横向分类、点击热区按手指尺寸设计,刘海与系统手势安全区单独避让。不出现焦点边框,也不出现遥控器按键提示。
代码层面,TV 的焦点链、FocusRequester、D-pad 事件与手机的滚动容器、手势、软键盘适配互不引用;两端的卡片尺寸、导航结构与屏幕方向各自硬编码,不做「一套布局两套缩放」。
收藏、观看历史与续播进度都保存在本机,不上传。换集、换线路、换内核之后仍然对得上——因为记录的是「哪部片、第几集、第几秒」,不是某条临时播放地址。
跨接口保留。主用接口失效、切到备用接口之后,收藏的片仍能从新接口里找回来。
按时间倒序,记录最近看的片与集数,可直接续播。历史可以单条删除或整体清空。
退出播放时写入进度,回来从断点继续。同一部片在不同线路之间切换,进度跟着走。
首页海报墙可在竖版与横版之间切换。竖版信息密度高,横版更适合宽屏远看,按客厅距离选。
简体中文、繁體中文、English、Tiếng Việt、ไทย。语言跟随系统,也可在设置里固定。
启动时读取发布清单,有新版本时在应用内提示,可直接下载对应 ABI 的安装包,不用回浏览器找。
电视包固定 targetSdk 28:更高的目标版本会让爬虫运行库以不允许的方式在进程内加载,2 GB 内存的盒子会直接崩溃。手机包不受此限制。
壹影不提供、不内置、不附带任何影视内容、直播源或可用接口。装好之后是空的,需要你自己导入合法的接口配置。
播放质量取决于接口:源站限速、分片缺失、编码异常,App 侧只能兜底,不能创造。聚合搜索的站点越多,单次搜索耗时越长——这是并发与内存之间的取舍,不是可以两头都占的优化。
两端安装包不能互换:TV 包装在手机上不会得到手机界面,反之亦然。下载页已按设备分开,按需选择。