OrionTV 视频播放器

OrionTV 是大屏端开源影视前端播放器，主要就是为了 Android TV / 电视盒子 / Apple TV（需自构建）。本身不存片、不内置片源，作为客户端对接自建或第三方的影视聚合后端（MoonTV / LunaTV / DecoTV / KatelyaTV 等 LunaTV 兼容 API），在电视上用遥控器浏览海报墙、搜片、选源、播放。

功能特点

• 大屏 UI：海报墙首页、分类浏览（电影/剧集/综艺/动漫/豆瓣 Top250）、搜索页，焦点导航适配 D-pad 遥控器。
• 后端对接：设置里填后端 API 地址 + 密码/令牌，拉取分类树、资源列表、详情、播放记录、收藏。
• 多源播放：详情页列出多播放源/集数，切换后由后端返回直链（m3u8 等），交给内置播放器或外置播放器。
• 续播与收藏：播放进度、历史、收藏跨端同步（依赖后端存储，AsyncStorage 本地或远程 API 同步）。
• 遥控器操作：方向键移动焦点，OK 播放，菜单键唤出音轨/字幕/源切换，长按加收藏（各分支实现略有差异）。
• 局域网输入辅助：部分构建内置轻量 TCP/HTTP 服务，手机浏览器进 TV IP 指定端口输文字，绕过遥控器打字。
• 平台：Android TV APK 侧载；Apple TV 需 Expo/eas 自签构建，无 App Store 包。

使用方法

1. 部署后端（先决条件）
   • 选其一：MoonTV（Docker，ghcr.io/senshinya/moontv:latest，端口 3000）、LunaTV Enhanced、DecoTV、KatelyaTV 等。
   • 配置环境变量：PASSWORD= 或数据库/Redis 存储模式；确保局域网可达，HTTPS 或反代按需。
2. 装 OrionTV
   • Android TV/盒子：下 APK，U 盘拷贝；侧载放行未知来源。
   • Apple TV：clone 仓库，eas build 或 Xcode/Expo 出 tvOS 包，AltStore/DNSCloak 旁加载。
3. 连后端
   • 启动 OrionTV → 右上角 ⚙ 设置 → API 地址填 http://192.168.x.x:3000（或域名/HTTPS）→ 保存。
   • 认证：LocalStorage/访问密码模式，登录框用户名留空或填账号，密码填后端 PASSWORD；数据库模式填注册账号密码。
   • 返回首页，海报墙加载即成功。
4. 播放
   • 选片 → OK 播放；卡在加载时，详情页切换备用源。
   • 外置播放器：部分分支支持调用 mx Player / VLC / Kodi 外链；否则走内置 Expo AV/视频组件，格式受设备解码限制。
5. 维护
   • 后端重启/改端口后，TV 端重存配置；多端同步需同一后端账户。
   • 版本匹配：OrionTV 1.2.x+ 需配兼容后端，旧独立版（1.1.x）可不连后端，别混用。

可配合使用的工具/软件

• 后端服务：MoonTV / LunaTV Enhanced / DecoTV / KatelyaTV（LunaTV 兼容 API）。Docker Compose + Redis/Upstash 做持久化。
• 反向代理：Caddy / Nginx，给后端签发 TLS，盒端填域名；内网可走 HTTP。
• 媒体/源接入：后端配置第三方 vod API（/api.php/provide/vod 类 TVBox 兼容接口），tracker/源列表维护。
• 播放后端：盒端内置解码不够时，后端透传直链 + Kodi / VLC / mx Player / mpv-android 接管播放，DLNA 回推电视。
• 部署辅助：Portainer / Watchtower 更新容器；Tailscale / WireGuard 外网访问；NAS（飞牛/OMV）跑 Docker。
• 调试：adb logcat 看 RN 崩溃；后端日志查 /api/* 401/404；Postman/curl 验 API；TV 端网络不通时测局域网连通性。
• 替代前端：手机端 Selene Mobile；网页端直接访问后端 UI——OrionTV 只是大屏客户端之一。