Ke-TV

这是一个安卓 TV 自定义图床屏保的开源 APP，作者是 KeKe0904，MIT 许可证，当前最新提交为 v1.7.5（2026 年 7 月 7 日，新增"一键强制设为系统屏保"的 adb 授权方案）。它能把你自己的图床接口返回的 JSON 图片列表，做成电视闲置时的轮播屏保 。

核心定位

普通 Android TV 的屏保一般只能选系统 Backdrop 或 Google 相册 ，而 Ke-TV 的价值在于：屏保图片完全由你自己的 HTTP 图床接口掌控——可以是自建相册 API、对象存储桶、甚至任意返回图片 URL 数组的云服务。装上电视后通过 Android 标准的 "DreamService" 机制注册为系统屏保 。

同时它适配了手机端：在手机上是带预览功能的工具 APP，方便你先在手机上测试图床配置效果，再部署到电视上 。

主要特性

- 🖼️ 自定义图床 URL：填入返回 JSON 图片列表的接口地址 - ⏱️ 切换间隔可调：5 秒 ~ 5 分钟 - 🎬 Ken Burns 动态平移缩放效果，支持随机 / 顺序播放 - 🔌 测试图床连通性：拉一次 JSON 并提示成功获取到 N 张图片 - 📱 手机端全屏预览：单击退出 - 🛡️ 单图加载失败自动跳过 - 🚀 一键跳系统屏保设置（v1.7.5 起支持 adb 授权强制设为系统屏保）

图床接口格式（4 种都自动识别）

这是该项目最实用的设计——不用拘泥于固定 schema，以下格式任选 ：

// 格式 1：字符串数组（最简单） ["https://img.example.com/1.jpg", "https://img.example.com/2.jpg"]

// 格式 2：对象数组带 url 字段 [{"url": "https://..."}, {"url": "https://..."}]

// 格式 3：包在 images 字段里 { "images": [{"url": "..."}, {"url": "..."}] }

// 格式 4：兼容常见图床 API（data 字段） { "data": [{"link": "..."}, {"src": "..."}] }

字段名支持 "url / link / src / file / path / image_url / img / download_url" 等，仓库里的 "example-images.json" 用 Unsplash 风景图做了演示 。

技术栈与编译

维度 选型 语言 Kotlin 构建 Android Gradle Plugin 8.13.2 最低/目标 minSdk 21 (Android 5.0) / targetSdk 34 (Android 14) 屏保机制 DreamService（Android 标准） 图片/网络/JSON Coil + OkHttp + Gson

本地编译需要 JDK 21、Android SDK 34、Gradle 8.14 ：

cd TVToolbox ./gradlew assembleDebug # 产物：app/build/outputs/apk/debug/app-debug.apk

安装与使用路径

获取 APK：到仓库 Releases 页下载 "TVToolbox-v1.x.apk"，可通过 U 盘拷到电视安装，或 "adb install" 。

推荐工作流（先手机后电视）：

1. 手机上打开「TV 工具箱」→ 进「屏保设置」配置图床 URL、间隔、动效 2. 点「预览屏保效果」全屏播放验证 3. 配置无误后再安装到电视上用

电视端启用：

1. 电视应用列表打开「TV 工具箱」 2. 「图床设置」→「图床 URL」填入接口地址 3. 选「切换间隔」「随机顺序」「动态平移缩放」 4. 点「测试图床连通性」，确认提示「成功：拉取到 N 张图片」 5. 点「打开系统屏保设置」→ 把屏保选成「TV 工具箱屏保」

💡 电视端屏保设置入口一般在 设置 → 设备偏好 → 屏保 ；较新的 Google TV 界面可能改为 设置 → 系统 → 环境模式（Ambient mode） ，且部分厂商（如小米 MIUI 屏保是系统级的）可能隐藏了第三方屏保选择项，这时可用当贝市场等工具强制调用屏保选择器，或通过 v1.7.5 新增的 adb 授权方案一键强制设置 。 适用场景与局限

适合：

- 有自建图床/相册 API、对象存储（如 Cloudflare R2、阿里 OSS）的场景 - 想让电视屏保展示特定图片集合（如家庭照片 API、团队宣传图、艺术品轮播） - 开发者学习 Android TV "DreamService" 屏保开发

暂不适合：

- 只是想展示本地存储的照片——这类需求用 Google 相册或 Photo Gallery and Screensaver 这类现成方案更简单 - 追求稳定开箱即用的普通用户：当前项目 0 Star / 0 Fork，属于早期个人项目，且 Debug 签名在更新时需先卸载旧版