飞牛TV 弹幕版 🎯
基于飞牛影视 API 的第三方 Android TV 客户端，支持弹幕、自动连播、TV 遥控器优化操作。
浏览器插件版：https://club.fnnas.com/forum.php?mod=viewthread&tid=64164
浏览器Docker版：https://club.fnnas.com/forum.php?mod=viewthread&tid=64655
📺 效果展示
📥 下载与使用
方式一：直接下载 APK
从 Releases 页面下载最新版本的 APK 安装包，在 Android 电视/手机上安装即可使用。
国内加速链接
方式二：本地构建
1. 克隆项目
git clone https://github.com/rgcaafe/fnos_tv_danmu.git
cd fnos_tv_danmu
2. 编译（需要 Android SDK）
Windows (gradlew.bat)
.\gradlew assembleRelease
Linux / macOS
./gradlew assembleRelease
3. 编译完成后 APK 位于：
app/build/outputs/apk/release/FNTV_release_*.apk
注意：本地构建需要安装 Android Studio 并配置好 Android SDK（API 33）。如果使用 Windows 系统，构建时部分依赖可能需要科学上网。
📦 功能特点
- 弹幕支持 — 集成 Danmu API，自动匹配番剧弹幕，支持搜索手动选择剧集
- 继续观看 — 记录播放进度，首页快速续播
- 剧集自动连播 — 播放完成后自动播放下一集
- TV 遥控器优化 — 全界面 DPAD 焦点导航，适配电视遥控器
- 倍速播放 — 支持 0.5x ~ 2.0x 播放速度
- 播放比例 — 适应 / 拉伸 两种模式
- 硬解/软解切换 — 支持硬件解码与软件解码
- 锁定模式 — 锁定后隐藏控制栏，防止误触
- 自动更新 — 内置更新检测，支持 CDN 加速下载安装
🛠 技术栈
- 开发语言: Java
- 播放器: ExoPlayer 2.18.7
- 网络请求: Retrofit2 + OkHttp3
- 弹幕渲染: 自定义 Canvas 弹幕引擎
- 最低支持: Android 4.4 (API 19)
- 目标 SDK: Android 12 (API 32)
🔐 登录说明
登录账号密码为 飞牛影视的账号密码，非本应用的独立账号。
- 服务器地址格式：
http://<你的NAS地址>:<端口>
- 默认端口通常为
5666
- 支持勾选"记住密码"实现自动登录
🙏 致谢
⚠️ 声明
本项目为第三方客户端，与飞牛影视官方无关。使用前请确保遵守相关服务条款。
❓ 常见问题
Q：弹幕无法加载？
- 确保已在"设置"中正确配置弹幕服务器地址（默认
http://<NAS>:9321）
- 检查弹幕服务是否正常运行
- 可通过弹幕面板的"弹幕搜索"手动选择剧集
Q：自动匹配弹幕不准确？
- 自动匹配基于文件名，可能会匹配错误的弹幕数据
- 匹配失败时可使用搜索面板手动选择，或重新播放再次匹配
Q：遥控器无法操作？
- 控制栏显示时，方向键在按钮间移动焦点
- 按
↑ 移到弹幕/锁定按钮，再按一次隐藏控制栏
- 按
← 返回移除焦点，再按一次退出播放（需确认）
Q：播放卡顿？
- 尝试在设置中切换"解码模式"为硬解或软解
- 检查网络连接质量
Q：如何更新？
- 设置页 → 检查更新，支持 CDN 加速下载安装
- 也可手动下载 APK 安装
📄 License
GNU General Public License v3.0
本项目基于 GPLv3 协议开源。
