这个项目能做什么

Side Screen 是一款开源工具,可将 Android 平板变为 Mac 的真正第二显示器。它填补了 macOS 的一项空白:Apple 的 Sidecar 仅适用于 iPad,而 Android 平板可通过该项目用作扩展屏幕。 连接方式 - USB-C:有线连接,自动进行 adb 反向端口转发,被描述为延迟最低的路径。 - 无线:一次性二维码配对,之后平板会记住 Mac,并通过 WiFi 自动重连。认证令牌在 Mac 本地生成,可重置以撤销访问权限。建议使用 5 GHz WiFi。 显示与串流 - 在 macOS 上创建真正的虚拟显示器,因此窗口可以作为扩展而非镜像拖到平板上。 - 在 Mac 上进行硬件加速的 H.265 编码,在 Android 上解码,采用异步流水线;README 称帧在 30 毫秒内送达,并提到 USB 下流水线延迟低于 16 毫秒。 - 触控输入,带触控预测以补偿网络延迟。 - HiDPI(Retina)模式在内部以 2 倍渲染,使文字和图标更清晰。 - 游戏模式预设,1 Gbps 比特率、低延迟编码和 120 FPS。 - 可配置分辨率(720p 至 8K,预设加自定义)、帧率(30-120 FPS)、比特率(20-5000 Mbps)和质量预设。 无头使用 自 0.11.0 版本起,没有自带显示器的 Mac(Mac Studio、Mac mini 或合盖的笔记本电脑)可以仅以平板作为屏幕运行。登录时启动和自动开始串流可让 Mac 启动后直接为平板提供服务。首次设置仍需一块屏幕来授予屏幕录制权限。 要求 - macOS 13(Ventura)或更高版本,Apple Silicon 或 Intel。 - Android 8.0(API 26)或更高版本,带 H.265 硬件解码器。 - USB 模式需要 USB-C 端口、Mac 上安装 adb,以及平板上启用 USB 调试。 - 无线模式需要两台设备在同一 WiFi 网络、用于扫描二维码的摄像头,以及用于 ML Kit 条码扫描的 Google Play 服务。 安装与构建 提供预构建的 .dmg(macOS)和 .apk(Android)发布包。由于 macOS 应用未公证,Gatekeeper 可能报告其已损坏;README 建议运行 sudo xattr -cr /Applications/SideScreen.app。Mac 上需要 ADB,可通过 Homebrew 的 android-platform-tools cask 安装。源码构建在 Mac 主机上使用 swift build -c release,在 Android 客户端上使用 ./gradlew assembleDebug。 故障排除说明涵盖连接被拒绝错误、延迟和卡顿、无线配对失败、令牌重置、macOS 的“显示器具有单独的空间”设置在全屏应用期间可能使虚拟显示器黑屏,以及授予屏幕录制权限。 该项目采用 MIT 许可证,接受 issue 和 pull request,并提供可选的捐赠链接。