BiliTV

## 原生 Android TV 版本（繁体中文支持）

后续会专注于优化原生版

[BiliTVNative](https://github.com/Hyper-Beast/BiliTVNative)


原生版截图
<img width="2048" height="1104" alt="image" src="https://github.com/user-attachments/assets/9d57c6c7-d1ed-4960-b86b-de475949f88b" />






# BiliTV 📺

一款专为 Android TV 设计的第三方哔哩哔哩客户端，使用 Flutter 开发。从图标到开屏动画到全部代码100%由AI开发，本人只负责提出需求和测试，测试设备有限，仅测试了索尼电视（armv7,安卓9）和redmi G Pro 27U（armv8,澎湃OS2）显示器，理论支持的最低安卓版本为安卓5，其他设备请自行测试。

更新功能是我自己内测使用，开源版本未实装

## ✨ 功能特色


### 截图展示
<img width="189" height="139" alt="image" src="https://github.com/user-attachments/assets/52b04c2a-85b6-4e35-bc3b-10e6bd588a4e" />
<img width="1193" height="666" alt="image" src="https://github.com/user-attachments/assets/7d779704-6709-49a3-957a-4253403bd71e" />
<img width="1203" height="668" alt="image" src="https://github.com/user-attachments/assets/b6784e77-96c5-40da-b567-9e8c6574b704" />
<img width="1069" height="569" alt="image" src="https://github.com/user-attachments/assets/209de939-bc94-4dc3-a8fd-1d9c57c4378d" />
<img width="1080" height="558" alt="image" src="https://github.com/user-attachments/assets/aeb84e09-7388-4ab6-b9be-b0da0340ddde" />






### 🎬 视频播放
- **多编解码器支持** - H.264 / H.265 / AV1 硬件解码，自动选择最优编码
- **DASH 视频流** - 高质量视频 + 独立音轨播放
- **多画质切换** - 支持 4K/1080P+/1080P/720P/480P 等多种画质
- **实时弹幕** - 完整弹幕体验，支持开关、透明度、字体大小、显示区域调节
- **弹幕倍速同步** - 弹幕飞行速度随播放倍速自动调整
- **播放进度记忆** - 自动保存播放进度，下次打开自动续播
- **自动连播** - 支持多P视频自动播放下一集，播完自动播放推荐
- **快进预览** - 拖动进度条时实时预览画面（雪碧图预览）
- **多P雪碧图支持** - 切换分P时自动加载对应预览图

### 📱 用户功能
- **二维码登录** - 使用手机扫码快速登录
- **动态页面** - 查看关注UP主的最新动态
- **观看历史** - 自动记录并同步云端历史，显示"已看完"状态
- **搜索功能** - 支持关键词搜索，保存搜索历史（最多10条）
- **推荐视频** - 首页展示个性化推荐内容
- **分区浏览** - 动画、游戏、音乐、科技等多分区内容
- **分区管理** - 自定义首页分区顺序和启用状态

### 🎮 TV 遥控器优化
- **完整遥控器支持** - 方向键导航、确认键选择、返回键退出
- **焦点系统** - 清晰的焦点高亮，便于遥控器操作
- **快速切换** - 侧边栏一键切换首页/动态/搜索/历史/用户
- **播放器快捷键** - 左右快进快退、上下调节音量、确认暂停

### 🔌 插件系统
- **空降助手** - 基于 SponsorBlock 数据库自动跳过广告、赞助、片头片尾
- **视频过滤** - 按关键词/UP主屏蔽不想看的视频，过滤低质量内容
- **弹幕屏蔽** - 按关键词屏蔽弹幕，支持精确匹配和模糊匹配
- **插件中心** - 统一管理插件开关和配置

### ⚙️ 设置选项

#### 播放设置
- **首选编解码器** - 选择 H.264/H.265/AV1 或自动
- **自动连播开关** - 可选择是否自动播放下一个视频
- **快进预览** - 开启/关闭拖动进度条时的预览

#### 界面设置
- **启动动画** - 开启/关闭应用启动动画
- **迷你进度条** - 播放器底部常驻进度条
- **默认隐藏控制栏** - 播放时自动隐藏控制条
- **播放器时间显示** - 右上角常驻时间
- **分区排序** - 自定义首页分区顺序

#### 存储设置
- **清除缓存** - 清除图片缓存和搜索记录
- **清除播放记录** - 清除本地播放进度

## 🛠️ 技术栈
- **Flutter 3.10+** - 跨平台 UI 框架
- **video_player + ExoPlayer** - 视频播放引擎，支持 DASH 格式
- **canvas_danmaku** - 弹幕渲染引擎
- **cached_network_image** - 图片缓存（限制 200MB，内存缓存 500张）
- **shared_preferences** - 本地数据存储
- **keframe** - 列表渲染性能优化
- **http** - 网络请求

## 📦 编译

```bash
# 获取依赖
flutter pub get

# 编译 APK (Android TV)
flutter build apk --target-platform android-arm64
```

## 🙏 致谢

本项目基于以下开源项目开发，特此感谢：

### 原始项目
- **[BiliPai](https://github.com/jay3-yy/BiliPai)** - 本项目的基础，感谢原作者的工作

### 依赖库
| 库名 | 用途 |
|------|------|
| [video_player](https://pub.dev/packages/video_player) | 视频播放引擎 |
| [canvas_danmaku](https://pub.dev/packages/canvas_danmaku) | 弹幕渲染 |
| [cached_network_image](