screenTV

项目概述

极简投屏（CastScreen）是 Android TV 盒子上的 DLNA 投屏接收端（DMR），对标乐播投屏的极简版本，只做核心投屏。手机端在 B 站、抖音、腾讯视频、爱奇艺等 App 中点击投屏或 TV 按钮并选中本设备，即可投屏到电视。项目采用纯自研 DLNA/UPnP 协议栈，无第三方投屏 SDK 依赖。

主要功能

• 纯自研 DLNA/UPnP 协议栈：SSDP 发现、设备与服务描述、SOAP 控制、GENA 事件
• 标准 MediaRenderer：1 个设备加 AVTransport、RenderingControl、ConnectionManager 三个服务
• 兼容主流 App：B 站、抖音、腾讯视频、爱奇艺
• 极简待机页与全屏播放页，遥控器 D-pad 直接旋转画面
• 前台服务保活，开机自启，网络抖动后服务仍在线
• 横屏与竖屏视频均正确显示，等比适配 contain，无变形
• 单进程，无 IPC Binder 开销

适用人群

• 想在 Android TV 或电视盒子上接收手机投屏的用户
• 希望使用无需登录、无广告的极简投屏工具的用户
• 关注自研 DLNA 协议栈实现的开发者

快速上手

1. 从 Releases 下载 app-debug.apk，通过 adb install -r 推送到 TV 盒子
2. 启动 App，待机页显示设备名与 IP，服务自动后台运行
3. 手机与 TV 接入同一 WiFi
4. 在手机端 App 点击投屏并选择本设备，画面自动起播
5. 用遥控器 D-pad 上下键旋转画面，中心键暂停或恢复，Back 退出

核心优势

• 纯自研协议栈，无第三方投屏 SDK 依赖
• 极简轻量，只做核心投屏
• 遥控器即可完成旋转、暂停与恢复
• 视频等比适配，不失真不裁剪

系统要求

• 操作系统：Android（Android TV 盒子）
• 其他：手机与 TV 需处于同一局域网
• 编译依赖：JDK 17 与 Android SDK 36，Media3 需锁定 1.8.x

注意事项

• 不支持 AirPlay，暂只做 DLNA
• 旋转仅支持 90 度步进，不支持任意角度
• WiFi 切换或网络断开后需重启 App 才能恢复，本版不监听网络变化
• 设备名随机生成，UI 中暂无修改入口
• v1.0.0 APK 为 debug 构建，未做混淆与签名裁剪，后续版本会切到签名 release
• 本项目为私有项目，保留所有权利