Skip to content
nanaoniiiiiPublic

About

Sunshine for Android:Android 串流主机,支持硬件编码、音频内录、远程输入与兼容协议的开放接收端;远程输入经 Shizuku 实现。

Topics

Resources

Stars

12 stars

Watchers

0 watching

Forks

Repository files navigation

Sunshine for Android

把 Android 手机或平板作为串流主机,在另一块屏幕上接收画面与声音,并远程操作。支持 Moonlight,也支持基于串流协议开发自定义接收端。

Android 10+ Release Website Shizuku

官网下载 · GitHub Releases · 常见问题 · 反馈问题

作者:七鬼 · nanaoniiiii。

v2026.11.11.1:显示恢复与触控缓冲优化:显示恢复逐项执行,避免一项失败跳过旋转恢复或采集窗口同步;触控移动复用指针缓冲,减少 Java 对象分配。249 项非音频单元测试通过,S20+ 完成升级、模式保存和 Android 事件构造检查。音频改动单独保存在待验证分支,未包含在此版本。详细结果与未完成的实机项目见验收记录。

v2026.10.31.2:开机即连与更新下载恢复:设置新增“开机即连”,在已有授权下,开机首次解锁后自动启动服务并准备录屏,无需打开主页;录屏丢失时按串流请求恢复,其他录屏应用使用期间等待。应用内更新改用最多四路分段下载,支持暂停、断点续传、慢速换源及速度显示,保留 APK 大小、摘要、包名、版本和签名校验。开机与录屏切换的实机范围见验收记录,下载与发布流程见官网更新说明。

v2026.10.30.1:持久显示模式与桌面返回优化:首页“串流状态”右侧加入“默认/全屏”,支持连接前预选、串流中切换并跨重启保存。默认按主机尺寸采集和编码;全屏按 Moonlight 原始请求调整显示与采集。实验室增加开机自启和服务恢复选项。Sunshine 桌面返回时保留焦点与滚动位置,复用图标缓存,背景改为图标外边缘主色,去掉晕染。236 项测试通过,S20+ 和 Tab S7+ 完成对应实测。详见功能与验收范围。

v2026.10.24.3:受信任锁屏与桌面退出修复:修正手机已受信任时仍误报需要解锁、阻止虚拟屏/DeX 启动的问题;通过系统接口收起无需身份验证的锁屏层,使退出 Sunshine 桌面回到手机主页,并保留虚拟屏、全屏与息屏串流。筛选合入音频缓冲、日志、配对接口和依赖清理改动。225 项应用测试通过,S20+ 的三种显示模式与退出恢复完成实测。详见各 PR 提案、作用与采纳范围和实机验收范围。

v2026.10.23.2:主机桌面与全局手柄适配:Sunshine 桌面采用横向应用栏、右侧图标与四周颜色延伸、跟随焦点的大标题和图标任务卡片。全局适配器随 Sunshine 服务启动,支持手机直连与 Moonlight 接收端手柄,提供系统导航、鼠标和游戏原生三种模式、LT/RT 即时圆环、实验室自定义绑定和实时测试页。补丁更正主屏电源菜单的系统调用。详见使用说明与实机验证范围。

v2026.10.21.2 已发布:开启虚拟屏默认仅关闭手机面板并串流原主屏。设置中打开「第二屏桌面模式」后,才展开 Sunshine/设备自带桌面双选。退出 Sunshine 桌面会返回手机主页,保留虚拟屏与全屏息屏串流;移除常驻悬浮窗。S20+ 原生 DeX 逻辑分辨率已验证 2560×1440 和 1440×3168,竖屏任务栏缺键未修复,保留三星原生任务栏。152 项应用测试通过。详见桌面模式与分辨率验收。

v2026.10.17.5 正式版:修复退出 DeX 后 Sunshine 按钮不响应、正常断流误重启引擎导致录屏授权丢失,以及首次安装时系统授权页面重叠的问题;完善 Shizuku 显示服务启动失败提示,延长三星首次连接确认时间,并兼容不同系统的全屏旋转命令。保留 GL 通知合批、帧唤醒复用、输入缓存与多端 UDP 重试优化。145 项应用测试通过;新 S20 全新安装、重新授予 Shizuku 权限后,无 HDMI 原生 DeX、退出重开、双端同连与短时息屏均已实测。满屏随机噪声压力下仍有温控、降帧与队列丢帧,不宣称任意负载稳定 60/120fps。详见 本版优化与验证。

实机与官网

Sunshine 主机
OPPO Android 11
常见问题
设置 → 维护
官网
nanaoni.tech
OPPO 真机上的 Sunshine 主页面,服务运行中 真机上的常见问题页面 Sunshine 官网首屏实景
查看接收端画面与关于栏
接收端示例
三星 Android 13
项目介绍
作者与链接
项目入口
三星接收端显示竖屏像素测试图 设置中的关于栏,显示版本、作者、官网和仓库入口 访问官网

GitHub 仓库

作者:七鬼

以上应用截图截取自 v2026.10.14.1–v2026.10.14.2,可能与您使用的版本有所出入。

项目能力

  • 高效硬件编码:通过 Android AMediaCodec 提供 H.264 / HEVC 硬件编码,支持自动选择和指定编码器,让画面实时抵达另一端。
  • 灵活全屏与方向切换:支持原生尺寸采集、按连接请求分辨率切换全屏,支持画布随设备横竖屏切换,以及固定画布旋转兼容模式,并在串流结束后恢复显示设置。
  • 免 Root 远程输入:通过 Shizuku 实现触控、鼠标与键盘操作,支持点击、拖拽和多点手势,让接收端也能自如控制 Android。
  • 主屏息屏串流:关闭主机屏幕面板,接收端继续使用手机原有主页与应用,保持熟悉的操作方式。
  • 独立第二屏桌面:按接收端请求分辨率创建虚拟屏,提供全屏 Sunshine 桌面;应用与输入独立运行,主屏息屏后继续使用。
  • 全局手柄与遥控适配:随主机服务启动,可使用系统返回、主页、任务切换、通知栏、控件导航、鼠标和按住选择的快捷圆环;实验室提供自定义绑定和实时测试。游戏原生模式保留游戏输入,R3 可切回系统导航。详见手柄说明。
  • 实验性桌面功能:设置的虚拟屏栏目提供第二屏桌面模式及 Sunshine/设备自带桌面选项,实验室提供高刷新率请求;手机原生 DeX 第二屏按创建时 Moonlight 的请求设置逻辑分辨率,保留三星原生主页。普通虚拟第二屏使用 Sunshine 桌面作为临时主页,无常驻悬浮控制窗。平板可直接开启系统 DeX 后串流主屏,无需创建第二屏。原生 DeX 仍依赖设备固件能力。
  • 实时音频内录:结合 Android AudioPlaybackCapture 与 Opus 编码,将画面和声音一起带到另一块屏幕。
  • 便捷配对与应用管理:PIN 设备配对、实时连接状态、桌面与应用快捷入口,连接后即可开始使用。
  • 流畅串流与自动恢复:独立引擎进程、连接自愈、音视频队列优化、帧率与码率控制、远程唤醒,保持操作连贯。
  • 自动保存与实时诊断:修改设置自动保存,连接诊断、运行日志与应用内常见问题帮助您快速上手。
  • 应用内更新与发布同步:启动与后台定期优先检查官网,失败时尝试 GitHub;按设备 ABI 分段下载,支持慢速换源、暂停与续传,校验后调用系统安装器。公开 GitHub Release 后,Actions 自动把三个 APK 复制到官网;官网访客请求不再查询 GitHub。详见官网更新说明与下载和同步验证。
  • 开放接收端生态:可使用 Moonlight,也可围绕串流协议开发自己的接收端。

快速开始(以 Moonlight 为例)

  1. 准备 Android 10 或以上手机/平板,以及能运行 Moonlight 的电脑、手机或其他客户端,两端接入同一可互通的局域网。
  2. 从官网下载安装包,也可使用 GitHub Releases:多数现代手机选 arm64-v8a;32 位 ARM 选 armeabi-v7a;不确定时选 universal。若通用包以 ZIP 提供,请先解压其中的 APK 再安装。
  3. 安装并启动 Shizuku,按官方手册完成无线调试或电脑 USB 启动。
  4. 打开 Sunshine,在主页授予 Shizuku 及提示的录屏、录音、通知权限,确认服务运行,记下主机 IP。
  5. 在 Moonlight 添加该 IP,点击主机,在 Sunshine 弹窗或“设备”页输入 Moonlight 显示的 4 位 PIN,然后选择桌面或应用开始串流。

系统无线调试配对用于启动 Shizuku,Moonlight PIN 配对用于连接 Sunshine,是两个独立流程。

使用指南

从源码构建

应用使用 Kotlin、Jetpack Compose / Material 3 与原生 Android 串流引擎。需要 JDK 17、Android SDK 34;最低 SDK 29。仓库包含两种 ARM ABI 的原生库。

git clone https://github.com/nanaoniiiii/sunshine.git
cd sunshine
./gradlew.bat :app:assembleRelease :app:testDebugUnitTest :app:lintRelease

macOS/Linux 使用 ./gradlew。APK 位于 app/build/outputs/apk/release/。发布构建启用 R8 和资源压缩,沿用项目现有签名配置。

需要重新构建原生引擎时,请先阅读原生构建说明。native/sources.lock.json 固定上游和依赖版本;native/android/ 保存本项目独立实现的 Android 平台适配。

工程记录

单元测试覆盖会话恢复、设置校验、采集几何与全屏恢复,配合实机操作检查,持续完善串流体验。

开源致谢

About

Sunshine for Android:Android 串流主机,支持硬件编码、音频内录、远程输入与兼容协议的开放接收端;远程输入经 Shizuku 实现。

Topics

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages