tv-receiver

项目概述

TV Receiver 是一款运行在 Android TV 或安卓电视上的投屏接收端，它在局域网发布可发现服务（NSD/mDNS），接收手机端推送的视频地址并直接播放。播放时可用遥控器暂停、继续、快进快退与切换倍速，也支持全屏播放与手机远程控制。应用还提供 HTTP 接口，方便其他程序查询播放状态或下达播放指令。

让电视变成手机视频的接收端，动动遥控器就能控制。

主要功能

• 服务发现：在局域网发布 NSD／mDNS 服务，手机端可自动发现电视
• 接收播放：接收手机端发送的视频地址并播放
• 遥控器控制：支持暂停、继续、快进快退与倍速菜单
• 全屏播放：支持全屏显示，按返回键退出全屏
• 远程控制：通过 /control 接口由手机端远程播放、暂停与停止
• 播放状态：/status 返回当前播放状态，/cast 支持可选 MIME、标题与请求头
• 启动容错：服务初始化失败时仍可进入主页面查看状态

适用人群

• 想把手机视频投到电视的用户
• 使用 Android TV 或安卓电视盒子的用户
• 需要远程控制电视播放的开发者

快速上手

1. 用 Android Studio 构建并安装 APK，执行 ./gradlew assembleDebug
2. 在电视上打开 TV Receiver，保持与手机处于同一局域网
3. 手机端使用配套发送端发现电视并推送视频地址
4. 用遥控器控制播放，或调用 /cast、/control 接口远程控制
5. 需要查看状态时请求 /status

核心优势

• 发现简单：局域网自动发现，无需手动输入地址
• 控制齐全：遥控器与远程接口双通道控制
• 接口清晰：/cast、/control 与 /status 语义明确，易于集成

系统要求

项目	要求
操作系统	Android TV 或安卓电视
构建环境	Android Studio、JDK 17、Android SDK 34
网络	与手机处于同一局域网

注意事项

• 电视与手机需在同一局域网内才能被发现
• 远程接口暴露在局域网，请勿在不可信网络中使用
• 需配合手机发送端使用