KBTVCaster

项目概述

想在电视上直接收手机推送的视频、又不想被商业投屏 App 的限制绑住，KBTVCaster 的做法是把一台普通 Android TV 变成协议接收端：DLNA/UPnP 媒体推送完整支持，AirPlay 屏幕镜像作为实验性功能内置。基于 Kotlin 与 Media3 ExoPlayer，UPnP 栈采用以源码内嵌的 Cling，镜像内核为经 JNI 封装的 UxPlay。

项目	内容
平台	Android TV / 电视盒子（Android 6.0，API 23+）
协议	DLNA / UPnP（完整）、AirPlay 镜像（实验性）
技术栈	Kotlin 1.9、Media3 ExoPlayer、Cling、UxPlay、oboe
架构	arm64-v8a / x86_64 / x86
许可	GPLv3

手机一点、电视就播，镜像协议也在路上。

主要功能

• DLNA 媒体推送：手机视频 App 点「TV / 投屏」即可推送，mp4 / mkv 直链与 HLS（m3u8）流都能播，含百度网盘 UA 适配
• 遥控器全键映射：播放、暂停、快进、音量全部走 D-Pad，前台服务常驻，支持开机自启
• AirPlay 屏幕镜像：iPhone 控制中心直接镜像，视频走 MediaCodec 硬解、音频走 AAC-ELD/LC 与 ALAC 解码链，仅支持非 DRM 内容
• 协议抽象：所有投屏协议实现统一 CastProtocol 接口，只转发 PlaybackCommand，新增协议只需加一个实现
• 日志排查：adb logcat -s "CastCoordinator:*" 可直接定位设备发现与播放问题

使用方法

1. 在电视上安装 APK 并打开，屏幕显示「凯机投屏」待机界面
2. 手机与电视连同一个 WiFi（注意路由器 AP 隔离会挡住发现）
3. 手机 App 播放页点投屏按钮，选择设备「凯机投屏」
4. 镜像：电视装 airplay 构建版，iPhone 打开控制中心「屏幕镜像」选择 KBTVCaster，约 10 秒出画面

安装方式

Releases 提供两个正式签名 APK：app-release.apk 为 DLNA 稳定版（镜像协议未注册），app-release-airplay.apk 额外启用镜像。可通过网络 ADB（adb connect <电视IP>:5555）安装，或拷进 U 盘侧载。需要瘦身时可加 -Pkbtv.build.abi=arm64-v8a 构建约 19 MB 的单架构包。

系统要求

项目	要求
系统	Android 6.0（API 23）及以上
架构	arm64-v8a / x86_64 / x86
网络	手机、电脑与电视同一局域网

注意事项

• 镜像为实验特性：默认协议不注册，仅 airplay 构建包开启；音频解码链已接通但仍在真机联调，可能无声
• 仅限非 DRM 内容：AirPlay 镜像基于 UxPlay，受版权保护的内容无法镜像
• 发现不了设备：确认同一 WiFi、路由器未开 AP 隔离，且 App 在前台运行