fnOSTV Android：让旧电视盒子重新拥有好用的飞牛影视体验
在很多家庭里，旧款 Android 电视盒子和电视设备并没有真正退役。它们还能开机、还能播放视频，也还能承担客厅娱乐中心的角色。问题在于，越来越多的新应用开始依赖更高版本的 Android、更重的运行环境和更复杂的前端框架，旧设备常常被迫停在“能用，但不好用”的状态。
fnOSTV Android 正是为这类设备准备的一款轻量级飞牛影视客户端。它面向 Android 4.2 及以上系统，用原生 Java Android 实现核心功能，尽量减少不必要的运行负担，让旧电视盒子也能获得更稳定、更顺手的影视浏览和播放体验。
**项目地址：**https://github.com/XDORG-N1/fnOSTV.git
为什么做 fnOSTV Android
飞牛影视本身提供了丰富的媒体管理能力，但在旧设备上，如果完全依赖 WebView 或桌面端方案，体验往往不够稳定：页面加载慢、遥控器操作不顺、播放兼容性不一、长时间使用容易卡顿。
fnOSTV Android 的目标很明确：
- 让旧 Android TV 设备继续发挥价值
- 提供更适合遥控器操作的原生界面
- 减少 WebView 依赖，提升稳定性
- 优化本地媒体库浏览和播放流程
- 为家庭影音场景提供轻量、可维护的客户端方案
它不是一个追求复杂功能堆叠的大而全应用，而是一个面向旧设备、客厅遥控器和本地影视库的实用型客户端。
原生轻量客户端
当前版本已经从早期 WebView 壳升级为原生 Android 客户端路线。登录、首页、设置、媒体库、文件浏览、收藏、最近播放和播放器都在 Android 端直接实现。
这意味着应用可以更好地适配电视设备：
- 界面更贴近遥控器操作
- 页面切换更轻
- 本地状态更容易保存
- 播放流程更可控
- 旧设备运行压力更低
项目采用 Java Android 实现，不使用 Kotlin、Compose 或 AndroidX，尽量保持对旧系统和旧构建环境的兼容。
核心功能
fnOSTV Android 当前已经支持一套完整的基础观影流程。
原生登录与会话恢复
应用支持通过 fnOS 连接流程完成原生登录，并保存 token。用户配置好服务器地址、账号和密码后，后续可以自动恢复会话，减少重复登录操作。
飞牛影视风格首页
首页参考飞牛影视的视觉风格，提供适合电视端浏览的入口布局，包括：
界面尽量保持简洁、直接，避免旧设备在复杂 UI 上产生额外负担。
本地媒体库管理
用户可以在设置页中添加本地媒体库，配置名称、分类和目录路径。应用会通过 fnOS 文件接口扫描目录下的视频文件，并保存为本地媒体索引。
媒体库能力包括：
- 添加媒体库
- 编辑媒体库
- 删除媒体库
- 扫描媒体目录
- 本地索引保存
- 分类浏览
- 搜索与首页展示
扫描深度默认限制为 4 层，最多索引 1000 个视频，避免旧设备长时间卡顿。
文件库浏览
除了媒体库索引，应用也支持文件库目录浏览，可以识别媒体文件，并提供播放入口。对于尚未完成媒体库整理的用户，也可以直接通过文件目录访问视频内容。
收藏与最近播放
fnOSTV Android 支持本地收藏和最近播放记录，方便用户继续观看或快速回到常看的内容。
内置播放器
播放器是项目的重点之一。当前播放链路优先使用 LibVLC，失败后回退 IJKPlayer，如果内置播放器仍无法处理，则交给系统外部播放器。
默认播放链路：
- 优先使用 LibVLC
- VLC 初始化或播放失败时切换到 IJKPlayer
- IJK 硬解失败时自动尝试软解
- 内置播放器失败后调用外部播放器 Intent
播放器支持：
- 播放 / 暂停
- 快进 / 快退
- 进度条
- 倍速切换
- 画面适应 / 铺满
- 清晰度源切换
- 播放诊断日志
针对远程流，应用默认提高网络缓存，尽量减少旧设备播放时的卡顿和缓冲中断。
适合哪些用户
fnOSTV Android 特别适合以下场景：
- 家里有旧 Android 电视盒子
- 希望在电视**问飞牛影视内容
- 想要比 WebView 更稳定的原生体验
- 主要使用遥控器操作
- 重视轻量、稳定和兼容性
- 希望本地媒体库可以被扫描、分类和继续观看
如果你的设备性能不高、系统版本较旧，但仍希望承担家庭影视播放任务，fnOSTV Android 会是一个很合适的选择。
系统与构建信息
当前版本信息：
- 包名：
com.fnostv.android4
- 版本号：
0.1.0
- Version Code：
1
- 最低系统：Android 4.2 / API 17
- 目标系统：Android 9 / API 28
- 技术栈：Java Android
- 播放核心：LibVLC + IJKPlayer
常用构建命令：
scripts\build-debug.cmd
scripts\build-release.cmd
**项目地址：**https://github.com/XDORG-N1/fnOSTV.git
