hongguoTV

项目概述

当你在电视上想看红果短剧却被手机端体验劝退时，hongguoTV 提供了一个为遥控器重新设计的原生 TV 客户端。它用 Kotlin + Android 原生 View + Media3 实现，最低支持 Android 7.0，安装一个 APK 联网即用，无需部署服务器；收藏和观看进度只保存在电视本机。

项目	内容
平台	Android TV，Android 7.0（API 24）及以上
技术栈	Kotlin、原生 View、Media3
架构支持	ARM32 / ARM64 / x86 / x86_64（APK 无 JNI 库）
许可	GPL-3.0-only

一个 APK 联网即用，收藏与进度只存在电视本机。

主要功能

• 首页推荐：热门短剧浏览，支持隐藏推荐与稍后看
• 四大排行榜：总热播榜、真人剧榜、漫剧榜、AI 剧榜
• 全局搜索：TV 字母键盘与系统输入法双输入，支持拼音首字母联想（如输入 BFLC），名称匹配与网页搜索结果合并排序
• 播放控制：480P / 720P / 1080P 清晰度、倍速、断点续播、自动连播、选集面板与画面模式切换
• 本机记录：收藏、观看进度与搜索历史全部本地保存
• 手机联动：扫码后用手机浏览器把剧名发到电视输入框
• 备份恢复：手机扫码在局域网内备份与恢复收藏和进度
• 应用内更新：前台自动检查新版，校验签名后由系统确认安装

使用与遥控

• 焦点、方向键、确定键与返回键完整适配遥控器操作
• 搜索历史流式排列，输入时给出拼音首字母联想
• 播放页支持暂停、前后跳转与选集，断点续播自动回到上次位置

数据与备份

• 收藏、进度与搜索历史保存在本机，不上传任何账号数据
• 打开「手机备份与恢复」或「手机输入」窗口时，APK 才临时监听局域网 HTTP，最长 5 分钟，窗口关闭即停止
• 媒体数据只在内存中处理，不下载整部剧到存储

系统要求

项目	要求
操作系统	Android 7.0（API 24）及以上
设备	Android TV / 电视盒子
解码	视频解码依赖设备芯片，解码失败可尝试 720P

注意事项

• 非官方客户端：内容来自第三方接口，接口或签名协议变化时需要更新 APK，未包含任何 VIP 解锁或付费绕过
• 更新器异常：应用内检查更新若提示「更新信息格式不正确」，请到 Releases 手动下载 APK 覆盖安装，同签名升级会保留收藏与观看记录
• 实机验证：JVM 单元测试与模拟器遥控检查已通过，实体电视的芯片解码与长期稳定性需实机确认
• 构建环境：自行编译需 JDK 17 与 Android SDK Platform 35，执行 ./gradlew.bat assembleDebug