快速上手

从空白到能看,只有一步是必须的

装好之后的壹影是空的——它没有内容,需要一个接口。除此之外的操作都可以慢慢摸。这一页按顺序讲一遍,遇到问题直接跳到最后一节。

一 · 导入接口

打开应用,第一次启动会停在空首页。进入「配置」,三种导入方式选一种。

方式一:远程 URL(最常用)

把接口地址填进去,确认后应用会拉取配置并解析站点列表。地址通常长这样:

https://example.com/tvbox/config.json

这里的地址只是格式示例,不是可用接口。你需要准备自己的合法配置。

方式二:本地文件

把配置 JSON 放进设备存储,在配置界面选择本地文件。适合没有稳定网络、或接口只在局域网内可用的场景。

方式三:二维码

在另一台设备上把地址生成二维码,电视端用摄像头或手机扫码导入。省去在遥控器上敲长 URL 的麻烦。

多份配置并存

可以同时保留多份配置:一份主用、一份备用。切换配置不会清空收藏与历史——它们记的是影片本身,不是某个接口的临时条目。

接口是前提,不是附赠

壹影不提供任何接口地址。网上流传的「公共接口」大多不稳定、随时失效,且内容来源不明——这类接口能不能用、合不合法,需要你自己判断。

二 · 首页与分类

接口可用之后,首页会按配置里的站点渲染海报墙。顶部是分类,下方是按推荐或最新排列的行。

电视端

  • 遥控器左右切换分类,上下在海报行之间移动;
  • 焦点落到卡片上会放大,但不推挤其他卡片的位置;
  • 确认键进入详情,返回键退回上一级。

手机端

  • 上下滑动浏览,顶部横向分类可左右滑;
  • 点卡片进详情,系统返回手势退回;
  • 底部导航在收藏、历史、设置之间切换。

竖版与横版海报

首页海报墙有两种样式:竖版信息密度高,一屏能看到更多片;横版单张更大,适合远距离观看。在设置里切换,两种样式下的焦点与点击行为一致。

四 · 详情与选集

详情页把「这部片有什么」摊开:海报、年份、演员、简介,以及最关键的线路与剧集。

线路切换

同一个片往往有多条线路,画质、速度、完整性各不相同。线路按钮横向排列,当前选中的有明显描边。线路切过去,剧集列表跟着换,已看进度按集号对齐。

选集

剧集以网格呈现,选中态有边框。剧集多时提供倒序,从最新一集往前排——追更的时候省一次长距离移动。

收藏

详情页可以直接加入收藏。收藏记录跨接口保留:换了配置,仍能从新接口里把这部片找回来。

五 · 播放

点剧集即进入播放。控制条在需要时出现,几秒无操作后自动隐藏。

  • 进度——拖动或按方向键快进快退;退出时自动记录位置;
  • 内核——某条线路画面异常、只有声音、或字幕不出来时,切换到另一条播放内核再试;
  • 广告过滤——默认开启。清单里能识别的贴片会被跳过,起播位置直接落在正片;
  • 弹幕——可在播放中开关,也可以只调透明度;关闭弹幕不影响播放与进度。

切集、切线路、切内核都不会丢进度:记录的是「第几集、第几秒」,与具体播放地址无关。

六 · 直播

直播与点播分开管理。载入频道列表后,频道按分组排列,切换分组与切换频道都是同一种焦点移动。

  • 频道列表支持 m3u 与 txt 两种常见格式;
  • 同一频道有多条线路时,可以在播放中换线;
  • 直播不写入观看历史,避免把历史列表刷满。
设置

值得动手改的几项

其余保持默认即可。不同版本的菜单命名可能略有差异,按含义找。

播放内核

默认走 Media3。遇到少见的编码、多音轨或字幕问题,切到 MPV 再试。

海报样式

竖版 / 横版。电视远看选横版,想一屏多选几部就竖版。

广告过滤

默认开启。个别源被误伤(正片开头被切掉)时,可以针对该源临时关掉。

弹幕

字号、透明度、速度、显示区域与屏蔽词。电视端默认比手机克制。

界面语言

跟随系统,或固定为简中、繁中、English、Tiếng Việt、ไทย。

检查更新

读取发布清单,有新版本时给出提示并直接下载对应 ABI 的包。

七 · 常见问题

装上了,首页是空的

正常。没导入接口就没有内容。进「配置」填一个可用地址。

提示「应用未安装」或「解析包出错」

多半是 ABI 选错了。换另一个架构的安装包重试;也可能是下载不完整,重新下载一次。

搜索特别慢,或者某个源一直转圈

站点越多,搜索越久。可以在配置里去掉长期不可用的站点。一直转圈的那一组是源站响应慢,不影响其他组的结果。

某部片点进去黑屏 / 只有声音

先换线路,再换播放内核。两条都试过仍不行,说明该源的编码或分片本身有问题,App 侧兜不住。

弹幕不出来

弹幕需要单独配置接口。没配就只显示视频,不影响播放。配了仍为空,通常是该片在弹幕库里匹配不到,可以手动指定。

应用内更新失败

确认能访问发布清单地址。若长期失败,到 GitHub Releases 手动下载对应 ABI 的包覆盖安装,数据不会丢。

电视上很卡,内存不够

优先用 arm64-v8a 包;把长期失效的站点从配置里删掉;播放时关掉不用的弹幕与后台应用。2 GB 内存的盒子上,搜索期的峰值内存已被压到 281 MB 左右。