功能

播放器该做的事,一件不落

壹影不做内容,只把「接口给的东西,稳稳放到屏幕上」这一件事拆开做透:怎么读接口、怎么找片、怎么播、怎么跳过不想看的、怎么看完整。

01 / 接口与站点

先认接口,再谈内容

影视 App 的体验上限,一半由接口质量决定。壹影的做法是:把接口当成可插拔的一等公民,格式尽量跟生态对齐,换源不用换 App。

TVBOX 风格配置

导入常见的 TVBOX / CatVod 影视配置:多仓结构、站点列表、分类与筛选规则、解析地址都按原样读取,不需要手工改写成另一套格式。

直播源

直播与点播分开管理。m3u / txt 形式的频道列表可直接载入,频道分组、台标与线路切换沿用同一套焦点与手势逻辑。

三类爬虫引擎

接口里写的爬虫,按语言分别交给 Java、QuickJS(JavaScript)与 Chaquopy(Python)执行,与生态里已有的接口实现保持兼容。

导入方式

三种都支持,按手边条件选一种:

  • 远程 URL——填一个返回 JSON 的地址,最常用;
  • 本地文件——把配置 JSON 放进设备存储再选中,适合离线或自建;
  • 二维码——在另一台设备上生成,电视端扫一下就完成。

配置支持多份并存:可以同时留一个主用接口和一个备用接口,接口失效时切换过去,收藏与历史不受影响。

03 / 播放内核

两条播放路径,覆盖面更宽

同一个片源,在不同设备上能不能播,往往取决于解码器与容器支持。壹影同时打包了 Media3 与 MPV 两条播放路径,遇到前者处理不了的编码、音轨或字幕,可以切到后者。

Media3 路径

走系统与 Exo 系解码,功耗与起播速度占优,适合绝大多数 HLS 源与常规编码。广告过滤的清单解析也挂在这条路径上。

MPV 路径

自带解码与渲染栈,对少见编码、异常封装、多音轨与内嵌字幕的容忍度更高。代价是占用更大,适合当作兜底而不是默认。

两条路径共用同一套播放界面与进度记忆:切换内核不会丢当前进度,回来还是那一秒。

04 / 视频广告过滤

贴片广告不该占你的时间

很多源的广告不是插在页面里,而是直接拼进 m3u8:正片清单前面挂几个独立分片,播放器照单全收。壹影在解析清单时就把这类分片摘掉,再交给播放器。

怎么判断

  • 规则命中——维护一份针对常见贴片特征的匹配规则;
  • URL 特征——分片路径里的广告标识、异常目录与参数;
  • 时间轴连续性——正片的 PTS 应当连续;广告分片插进来会在时间轴上留下断点,据此定位并切除。

三条并行,规则没覆盖的新源也有机会被后两条兜住。

正片清单里混进的贴片

#EXTINF:5.0, https://cdn.example.com/ad/15s_01.ts

示意:广告作为独立分片挂在正片清单前部,时长短、路径带 ad 标识、与前后分片的时间轴不连续——三个特征里命中任意一个即可标记。

05 / 弹幕

一个人看,也不像一个人

兼容常规弹幕接口,也可以填自建 API。按片名与集数自动匹配,匹配不上时手动指定。渲染走独立图层,不阻塞视频解码。

电视端播放画面,弹幕以白色文字横向滚动覆盖在视频上方

播放中的弹幕

独立图层 · 不阻塞解码

能调的东西

  • 字号、透明度、滚动速度、显示区域占比;
  • 屏蔽词与关键词过滤;
  • 按集数自动切换弹幕池;
  • 一键关闭,不影响播放与进度记录。

大屏上的弹幕默认比手机克制:行数更少、字号更大、速度更慢,避免远距离观看时糊成一片。

06 / 输入

遥控器和手指,是两种语法

把手机界面投到电视上,问题不在清晰度,而在「下一步在哪」。壹影把两端的导航从根上分开实现,共享业务、不共享屏幕。

电视:焦点是一条链

上下左右移动可预测,焦点环始终可见,卡片放大不推挤整页布局。返回键的路径固定:从播放退到详情,从详情退到列表,不会一次退太远。

手机:滚动是一段路

纵向滚动、顶部横向分类、点击热区按手指尺寸设计,刘海与系统手势安全区单独避让。不出现焦点边框,也不出现遥控器按键提示。

代码层面,TV 的焦点链、FocusRequester、D-pad 事件与手机的滚动容器、手势、软键盘适配互不引用;两端的卡片尺寸、导航结构与屏幕方向各自硬编码,不做「一套布局两套缩放」。

07 / 记忆

看不完的,下次还在

收藏、观看历史与续播进度都保存在本机,不上传。换集、换线路、换内核之后仍然对得上——因为记录的是「哪部片、第几集、第几秒」,不是某条临时播放地址。

收藏

跨接口保留。主用接口失效、切到备用接口之后,收藏的片仍能从新接口里找回来。

历史

按时间倒序,记录最近看的片与集数,可直接续播。历史可以单条删除或整体清空。

续播

退出播放时写入进度,回来从断点继续。同一部片在不同线路之间切换,进度跟着走。

08 / 外观与维护

看得舒服,改得动

竖版 / 横版海报

首页海报墙可在竖版与横版之间切换。竖版信息密度高,横版更适合宽屏远看,按客厅距离选。

五种界面语言

简体中文、繁體中文、English、Tiếng Việt、ไทย。语言跟随系统,也可在设置里固定。

内置更新

启动时读取发布清单,有新版本时在应用内提示,可直接下载对应 ABI 的安装包,不用回浏览器找。

TV 端单独的目标版本

电视包固定 targetSdk 28:更高的目标版本会让爬虫运行库以不允许的方式在进程内加载,2 GB 内存的盒子会直接崩溃。手机包不受此限制。

边界与限制,先说清楚

壹影不提供、不内置、不附带任何影视内容、直播源或可用接口。装好之后是空的,需要你自己导入合法的接口配置。

播放质量取决于接口:源站限速、分片缺失、编码异常,App 侧只能兜底,不能创造。聚合搜索的站点越多,单次搜索耗时越长——这是并发与内存之间的取舍,不是可以两头都占的优化。

两端安装包不能互换:TV 包装在手机上不会得到手机界面,反之亦然。下载页已按设备分开,按需选择。