OrionTV

你贴的是 "xirtam-zhang/OrionTV-Android" 这个仓库：基于 OrionTV 1.3.3 用 Kotlin 重写的 Android 电视/视频客户端，纯原生 UI，不是原版 React Native/Expo 那套。

一、项目定位

- 上游 OrionTV 原本是 RN TVOS + Expo 的跨平台聚合播放器，可配 MoonTV/自建后端或第三方影视 API ；这个 Android 版把它重写成原生，目标更轻、更跟手。 - 代码语言 100% Kotlin，Gradle Kotlin DSL（ "build.gradle.kts"/ "settings.gradle.kts"），带 "gradlew" 可命令行构建。 - 最低支持到 Android 5.0（API 21），老电视盒子、低端安卓也能装。 - 目前 1 个 tag（0.1，2026-08-19）、main 分支，commit 不多，属于个人重写小项目，不是大团队维护。

二、相比原版做了什么（README 摘要）

- 纯原生 UI 重写，去掉 RN 层，操作更流畅 - 过滤广告 - 声音响度统一，并兼容 5.1 声道（最近提交专门加了响度/5.1 配置） - 去掉登录系统，收藏改本地存储 - 快进速度、菜单/遥控器操作逻辑优化

三、自己构建/运行

仓库已经是标准 Android Gradle 工程，本地跑：

git clone https://github.com/xirtam-zhang/OrionTV-Android.git cd OrionTV-Android ./gradlew assembleDebug # Linux/macOS # gradlew.bat assembleDebug # Windows

- 用 Android Studio 打开 "app/" 所在根目录更直接；具体 "compileSdk"/ "minSdk"/依赖看 "build.gradle.kts" 和 "app/build.gradle.kts"（摘要没展开，以文件为准）。 - 真机/盒子装 debug APK： "app/build/outputs/apk/debug/*.apk"，Android 5.0+ 开“未知来源”安装。 - 若 Release 页有 0.1 的 APK 就直接下，比自己编省事。

注意：摘要没看到 CI 工作流，大概率没有自动出 APK；要发布版得自己 "assembleRelease" 配签名。 四、适配/使用注意

- 电视端优先测遥控器焦点、快进键、菜单键；它主打“菜单操作逻辑优化”，但老盒子不同遥控器键值可能有偏差。 - 响度统一+5.1 要在带功放/HDMI 音频的电视或盒子测，手机扬声器看不出效果。 - “过滤广告”只限于客户端屏蔽/跳过已知广告请求或开屏；如果片源本身把广告嵌进视频流，原生过滤做不到，得换源。 - 去登录=不依赖上游账号体系，收藏在本地；换设备不云同步，刷机/清数据会丢。

五、合规与风险（重点）

- OrionTV 类客户端本身通常不托管视频，只聚合第三方源/自建后端 。接什么源决定合法性：自建合法片库、个人已购内容、公开授权源都没问题；接盗版影视聚合 API 有版权风险。 - 去广告若针对第三方付费/侵权源，属于规避对方商业机制，不建议用于灰色片源。 - 个人仓库、1 star、0 issue，别当生产级框架用；升级上游 OrionTV 1.3.3 之后的修复不会自动同步过来。 LunaTV下面设置后端地址 https://www.xiafan.org/ https://kty.ssoku.cloudns.org/ https://moontv.zklighting.ltd/ https://emtv.ao9.cn/ https://www.nmxl.net/ https://moontv.001.sh/ https://www.finger10.com/ https://ljiji.com/