hongguoTV

项目概述

hongguoTV 是一款装在电视上的非官方红果短剧客户端，给用遥控器追剧的人解决官方没有 TV 端的问题。当前主线是 Kotlin 原生独立版（包名 com.hongguotv.nativeapp），联网即用，不需要 Node 或 Docker，可与旧版并存。播放已适配服务端现行接口，能看全集 1080p HEVC，签名请求每次生成新的随机设备身份。

一台 Android 电视盒子加一个 APK，客厅直接刷短剧。

项目	内容
平台	Android TV（最低 Android 8.0 / API 26）
形态	Kotlin 原生 APK，独立运行无需服务端
包名	com.hongguotv.nativeapp
播放	全集 1080p HEVC，支持弹幕
许可证	GPL-3.0

主要功能

• 遥控器全操作：方向键、确定键、返回键焦点滚动，选中落点按位置计算不横跳
• 弹幕：跟随播放进度，大小与行数可调，暂停跟着停、倍速不跟着飞
• 双路搜索：关键词与按剧名两条搜索路径，新剧输半截词也能搜到，本机索引一天重建一次
• 榜单：红果热门榜单，一页 36 部，名次连续可翻页
• 连播与预载：自动连播下一集，下一集地址与首包提前备好，冷启动约 1.6 秒
• 收藏与续播：本地收藏、最近观看、断点续播

使用流程

1. 到 Releases 下载最新 kotlin-vX.Y.Z APK，用 U 盘或 adb install -r 装进电视
2. 打开即用，首页推荐、榜单、搜索直接逛，无需配置服务地址
3. 进详情页选集播放，观看进度自动记录，下次接着看

适用人群

• 用 Android 电视追红果短剧的家庭用户
• 依赖遥控器操作的电视党
• 不想自建内容服务的轻度用户

安装与权限

• 证书提示：本仓库各版本共用一套自签证书（SHA-256 4f4cf502…），覆盖升级保留收藏与记录，但与官方红果及其它修改版证书不同，装前需先卸载电视上已有的其它签名版本
• 独立运行：原生版联网即可用，无需 Node 服务端或 Docker
• 更新通道：应用内「检查更新」从 GitHub Releases 拉取元数据，需要电视能访问 GitHub

系统要求

项目	要求
操作系统	Android 8.0（API 26）及以上
设备	Android TV 或电视盒子，遥控器操作
网络	需可访问红果源站与 GitHub

注意事项

• 非官方接口：与红果官方无关，内容接口为非官方实现，平台调整可能失效
• 同系列识别：同系列剧按剧名剥季号匹配，刻意不做模糊匹配，避免不同剧混入
• 源码许可：项目代码按 GPL-3.0 提供，旧版 React Native 方案与 Node 内容服务仍在仓库保留