PerchPlay

项目概述

PerchPlay 是一款给手机与平板用户用的本地视频播放器，用 Flutter 编写，同时支持 Android / iOS / iPadOS。播放内核为 media_kit（libmpv），支持 21 种视频格式与硬解开关；界面走玻璃拟态风格，导航栏实时模糊可开关。

项目	内容
平台	Android / iOS / iPadOS
播放内核	media_kit 1.2.0（libmpv）
支持格式	mp4 / mkv / avi / mov 等 21 种
网络	DLNA 投屏、WebDAV、FTP
技术栈	Flutter 3.22、Riverpod 2.5、GoRouter 14、SQLite
许可	MIT

本地片库、平板双栏、电视投屏，一个播放器全包。

主要功能

• 全格式与字幕：21 种格式，0.25x-2.0x 倍速，内嵌字幕轨选择，外挂 SRT / ASS / VTT，内嵌与外挂可双字幕同屏对照
• 手势操作：左侧滑亮度、右侧滑音量、水平滑快进快退并实时带动进度条、双击暂停
• 自动剧集分组：按文件名识别 S01E02、1x02、第1季第3集、EP05 等 8 类季集标记，跨文件夹同名剧集合并成列表，电影不误入
• 断点续播与队列：进度自动落盘，上一集下一集连播
• DLNA 投屏：SSDP 发现加手动 IP 兜底，内置支持 Range 的 HTTP 媒体服务把本地文件喂给电视
• NAS 直连：WebDAV、FTP，局域网自动识别群晖、威联通、TrueNAS、Unraid、飞牛等品牌并验证 WebDAV 可用性
• 键盘快捷键：外接键盘 Space 播放、←→ 快退快进 10 秒、F 全屏、[ ] 切集

响应式布局

手机为底栏导航加全屏播放；平板竖屏切换 NavigationRail 并放大控件；平板横屏为双栏 Master-Detail，播放器独占分栏。Android 上毛玻璃按 GPU 兼容自动降级半透明叠加。

安装与权限

从 Releases 下载 APK 或自行构建。Android 13+ 申请 READ_MEDIA_VIDEO，Android 11+ 可另开「所有文件访问权限」获得更完整扫描；iOS 侧走沙盒 Documents 扫描、「文件」App 多选导入与照片库视频扫描。

系统要求

项目	要求
Android	8.0 及以上
iOS / iPadOS	现代版本，走沙盒或文件导入
网络（可选）	局域网内有 DLNA 设备或 NAS

注意事项

• 投屏仅 DLNA：Chromecast 与 AirPlay 未实现，界面不会谎报连接状态
• SMB 未支持：网络存储推荐用群晖、威联通均支持的 WebDAV
• 后台播放：Android 走前台服务加通知，受「后台播放」开关控制