橘果TV

摘要

红果短剧的安卓 TV 非官方客户端，当前是联网即用的 Kotlin 独立 APK，旧版需搭配 Node 中继服务。

⚠️ 内容接口是非官方实现，版权归平台，仅限个人学习。

🆚对比 和你存过的 guoapp 同是红果短剧的非官方 TV 方案，这篇已改成联网即用的 Kotlin 原生 APK，少了服务器依赖，建议略读部署与签名部分。 你可能不知道的

架构变化

- 当前主线是 Kotlin 原生 APK：kotlin-tv/ 包名 com.hongguotv.nativeapp，安装后联网即可用，不再需要 Node 或 Docker，最低 Android 8.0，专做电视遥控器操作。 - 1.0.0 修的是遥控器体验：搜索结果返回后焦点自动回到清空按钮、热门推荐显示全部、词条按左键逐键左移，推送服务保持运行直到关闭软件，首页热门 3 行 18 个。 - 原生版与旧版可并存：保留 React Native 版说明，原生工程包名不同，两套能同时装在设备上，适合先并行再迁移。

服务与部署

- 旧版是 C/S 分体设计：电视只负责界面和播放，独立的 Node 服务（默认 8787 端口）负责内容接入与媒体分段，便于其他平台复用，但也意味着播放时服务不能停、电脑不能休眠。 - 服务默认只监听 127.0.0.1，要家庭网络访问得显式加 --lan；可用 BRIDGE_TOKEN 设口令并在电视端填相同值，作者明确说明没做公网部署所需的完整访问控制。 - 部署入口有两种：只跑服务不必装 React Native 依赖；也可用 ghcr.io/n3urda/hongguotv-bridge:0.1.1 的 AMD64/ARM64 镜像或根目录 Compose，参数 BRIDGE_HOST、PORT、BRIDGE_TOKEN 需由 shell 或部署工具传入，Node 进程不读 .env。 - 电视端地址别填 127.0.0.1：电视和服务所在设备要在同一家庭网络，应用设置里填电脑的局域网 IP（启动日志会显示），电视上把 127.0.0.1 当成电脑地址必然连不上。

坑与边界

- 首次启动不塞假数据：默认没有内容服务地址，也不拿测试数据冒充真实内容，内置的「测试播放器」只播明确标注的 Big Buck Bunny 公开样片。 - 签名换机器要留密钥：build:android 产出的 release APK 含 JavaScript、运行时不需要 Metro，首版是自用开发签名；签名文件被 Git 忽略，换机器构建必须保留同一密钥才能覆盖旧安装，对外发布前要配正式签名。 - 源与许可证分层：Node 服务固定提交 drpys 源，保留原文件、GPL-3.0 许可证和来源记录；Android/tvOS 骨架来自 MIT 许可的 RN TV 模板，项目代码按 GPL-3.0 提供，手机和浏览器不要假定能直接复用原生端的媒体与请求头配置。