OK影视（FongMi/TV）配置使用教程
目录
一、项目简介
OK影视（项目名 FongMi/TV）是一个面向 Android TV / 安卓电视盒子 的轻量级影视播放前端。原作者/核心开发者为 GitHub 用户 @FongMi，项目完全开源、代码公开透明。
- 定位：Android TV / 安卓盒子的轻量播放前端（"万能播放壳子"）。
- 开源地址：https://github.com/FongMi/TV
- 一句话概括：把影视 App 做成"浏览器 + 顶级播放器"的组合，看什么由你自己决定。[citation:1]
二、它是什么，不是什么
| 问题 | 说明 |
|---|---|
| 它生产影视内容吗？ | 不生产。 本身只是一个播放壳子。 |
| 它内置资源吗？ | 没有内置资源。 需要填入"配置接口"才会生成对应的影视界面。 |
| 换源要重装吗？ | 不用。 换配置接口即可，App 无需重装。 |
| 它合法吗？ | 开源软件本身合规；内容的合规性完全取决于你使用的配置接口。 |
三、核心特性
- 专为遥控器设计，长辈也能用 —— 采用 Android TV 原生风格：大卡片、大字体、十字导航。区别于把手机 UI 硬塞进电视的 App，家里老人基本不用教就能按得动。[citation:1]
- 播放能力极强 —— 内置 ExoPlayer + 软解兜底。很多老盒子播不动的 4K、乃至部分特殊编码格式，它能硬解或软解，拖动进度条几乎无卡顿。[citation:1]
- 配置即所得（最关键） —— 不绑定任何资源方。填入由懂行的站长或自建用户维护的"配置接口"，App 即自动生成对应界面；换源只需换配置。[citation:1]
四、适用人群与准备工作
4.1 适合谁用
- 技术玩家：研究 Android TV 开发、爬虫架构、播放器封装。[citation:1]
- 电视发烧友：手里有 N1、外贸盒子、投影仪，想榨干设备性能。[citation:1]
- 家庭用户：只想安安静静看个剧，不想被套娃会员反复割韭菜。[citation:1]
4.2 设备与系统要求
| 项目 | 建议 |
|---|---|
| 设备 | Android 电视 / 安卓盒子 / 投影仪（如 N1、外贸盒子等） |
| 系统版本 | Android 5.2（Lollipop）及以上 |
| CPU 架构 | 按设备架构选择对应 APK（常见 arm64-v8a / armeabi-v7a / x86） |
| 输入设备 | 标配遥控器即可；初次配置建议临时接鼠标或先用手机推送 |
提示：不确定盒子架构时，可优先尝试
arm64-v8a版本；若无法安装或运行崩溃，再换armeabi-v7a版本。
五、下载与安装
5.1 下载 APK
- 打开开源地址 https://github.com/FongMi/Release/tree/fongmi/apk。
- 在附件（Assets）中按架构下载对应的
.apk文件（如app-arm64-v8a-release.apk）。 - 加速下载地址 https://ghfile.geekertao.top/https://github.com/FongMi/Release/blob/fongmi/apk/leanback-arm64_v8a.apk
5.2 安装到电视/盒子（任选其一）
| 方式 | 适用场景 | 要点 |
|---|---|---|
| U 盘安装 | 盒子支持 USB | 把 APK 拷入 U 盘，插到盒子，用自带文件管理器打开安装 |
| 手机推送 | 手机与盒子同局域网 | 手机下载 APK，通过"文件管理器/快传"等推送到盒子安装 |
| 远程推送（ADB） | 已开启开发者/USB 调试 | 电脑执行 adb connect <盒子IP>:5555 后 adb install xxx.apk |
安装前请先在盒子设置中开启"允许安装未知来源应用"；部分盒子还需在"账号与安全"里放开安装权限。
六、配置接口（核心步骤）
OK影视是"空壳"，必须填入配置接口地址才能生成可看的影视界面。这一步是整套流程的关键。
6.1 配置流程（5 步）
- 打开已安装的 OK影视 App。
- 进入 设置 / 配置 页面（遥控器按菜单键或右上角设置图标）。
- 找到"配置地址 / 接口地址"输入框，填入可用的配置接口 URL。
- 保存并点击"更新 / 刷新配置"，等待接口拉取完成。
- 返回首页，即可看到由该接口生成的影视分类与资源界面。
6.2 常用配置接口参考
以下为社区公开维护的示例接口，可用性随网络与维护情况变化，以实际测试为准；教程不对外部接口的稳定性与合法性作保证。请优先选择有持续维护、口碑较好的接口。
| 接口/维护者 | 说明 | 配置地址（示例） |
|---|---|---|
| 饭太硬 | 社区较常用接口之一 | http://www.饭太硬.com/tv |
| 肥猫 | 资源覆盖较广 | http://肥猫.com/tv |
| 王二小 | 轻量稳定型 | http://王二小.com/tv |
| 摸鱼 | 日常维护活跃 | http://摸鱼.com/tv |
| 天微 | 适配 OK影视较好 | http://天微.com/tv |
| 高天流云加速 | 带加速线路 | http://高天流云.com/tv |
⚠️ 上表中的中文域名仅为示意写法，实际填写请以维护者公布的完整可用 URL 为准；若某个接口失效，可到相关社区/论坛查找最新地址后替换即可（无需重装 App）。
6.3 多接口/换源
- 支持切换多个配置接口：在配置页修改地址后重新更新即可。
- 建议先把可用的接口地址记录下来，失效时可快速切换，不必重新摸索。
七、日常使用指南
| 场景 | 操作 |
|---|---|
| 浏览首页 | 十字导航 + 大卡片，按方向键选择分类/影片 |
| 切换播放源 | 进入影片详情/播放页，选择"换源/线路"切换可用源 |
| 搜索影片 | 按遥控器"语音/搜索"键或界面搜索图标，输入片名 |
| 播放操控 | 方向键快进快退、确认键暂停/播放、菜单键调出更多选项 |
| 收藏/历史 | 支持收藏与播放记忆，下次打开可续播 |
由于内置 ExoPlayer + 软解兜底，多数 4K 与特殊编码格式可直接硬解/软解，拖动进度条基本无卡顿。[citation:1]
八、常见问题排查
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 打开后空壳、无任何资源 | 未填配置接口 / 接口失效 | 检查并重新填写可用接口地址，点"更新配置" |
| 有画面无声音 | 音频编码/输出不兼容 | 尝试切换播放源/线路；在设置中切换音频输出或软解 |
| 接口加载失败/超时 | 网络不通或接口暂时不可用 | 检查盒子网络；更换/测试其他接口地址 |
| 部分影片无法播放 | 该源失效或编码不支持 | 换源/换线路；确认盒子架构与解码能力 |
| 无法安装 APK | 未开启未知来源/架构不匹配 | 开启"未知来源安装"权限；换对应架构的 APK 重试 |
九、合规与温馨提示
- OK影视是开源软件，代码公开透明，不含任何非法内容。[citation:1]
- 由于它是"空壳"，内容的合规性完全取决于你使用的配置接口。
- 请务必遵守所在地的法律法规，仅限用于个人学习、测试，或观看已获得授权的资源。[citation:1]
