HeinPlay

项目概述

海因影视是一款用 Flutter 开发的跨平台影视播放应用，TV 版面向 Android TV 与大屏设备优化并支持遥控器焦点导航，tvLegacy 版兼容 Android 5.0+ 的老电视，手机版为竖屏触屏版本。桌面端提供 Web、Windows 与 Linux 版，其中 Linux 以单文件 AppImage 分发，重点服务 Steam Deck 等掌机；HarmonyOS NEXT 版本正在开发中。所有版本共用同一套业务层，播放后端可在 ExoPlayer 与 fvp 之间切换。

一套代码打通电视、手机和掌机，点播直播都能看。

主要功能

• 影视浏览：首页推荐与电影、电视剧、综艺、动漫四大频道，支持筛选、排序与海报墙
• 详情与选集：展示简介、评分、演职员与集数，支持多播放源切换与自动连播
• 全屏播放：播放暂停、快进快退、进度拖动、音量亮度调节与画面比例切换
• 多播放器后端：Android 默认 ExoPlayer，tvLegacy 与桌面端使用 fvp，Windows 保留 vlc 备用
• 电视直播与回放：支持内置直播源与自建 M3U/TXT 源，拉取 EPG 节目单并支持时移回放
• 内外网切换：可分别配置互联网与局域网服务器地址，启动时自动测速选择最优地址
• IPv6 优先解析：可优先解析互联网服务器的 IPv6 地址，不可达时自动回退 IPv4
• 双账号与后台管理：主副账号一键切换，TV 端内置 5025 端口手机管理页
• 游戏手柄支持：Android TV、tvLegacy、Windows、Linux 均可用手柄操作
• 双渠道更新：默认国内渠道，可切换 GitHub 渠道，带下载进度与自动安装

适用人群

• 使用安卓电视或电视盒子的用户
• 还在用低版本安卓电视的用户
• 想用掌机或桌面电脑看影视的用户
• 需要直播与点播一站式的用户
• 喜欢用手柄操作影视应用的用户

快速上手

1. 在 Releases 页按设备选择安装包：电视用 TV 版或 tvLegacy 版，手机用 mobile 版，Windows 用便携 zip，Linux 掌机用 AppImage
2. 安装并打开应用，在「我的 → 服务器管理」填写互联网与局域网服务器地址
3. 启动后应用会自动测速并选择延迟最低的地址，顶部状态栏显示当前连接线路
4. 在首页、分类或搜索中找到影片，进入详情页选择播放源与集数开始播放
5. 需要直播时进入直播页，可用内置源或导入自己的 M3U/TXT 源，并拉取 EPG 节目单
6. Linux 掌机用户可运行仓库内的安装脚本部署 AppImage，重复执行即为升级

核心优势

• 一码多端：电视、手机、Windows 与 Linux 掌机共用同一套业务层与交互
• 播放稳健：多种播放器后端可切换，配合缓冲与测速优选，起播更快
• 专为掌机优化：Linux 版做成单文件 AppImage，在 SteamOS 游戏模式下自动全屏
• 直播体验完善：完整 EPG 节目单、时移回放与备选源切换，看直播不掉链子

系统要求

项目	要求
Android TV	Android 7.0（API 24）及以上
低版本电视	Android 5.0（API 21）及以上，使用 tvLegacy 版
手机 / 平板	Android 7.0（API 24）及以上
Windows	Windows 10 1809 及以上，解压即用
Linux	桌面 Linux x86_64，需较新的 GTK3 / ALSA 系统库

注意事项

• Web 端受限：Web 版仅供本地测试，受浏览器 CORS 限制，部分网络图片可能无法加载
• 更新同步延迟：国内渠道更新可能与 GitHub 存在同步延迟，想尝鲜可切换 GitHub 渠道
• 渲染差异：普通 TV 版默认用 Vulkan 渲染，老设备若闪退或卡顿可改用 tvLegacy 版
• 鸿蒙未发布：HarmonyOS NEXT 版仍在开发中，暂未提供 Release 安装包