投屏工具 scrcpy
如果没有 HDMI 显示器,也可以在主机上使用 scrcpy 将魔方派 3 的 Android 15 图形界面投屏到主机窗口中,并通过主机的鼠标和键盘操作设备。
scrcpy 是 Genymobile 维护的开源工具,可通过 USB 或 TCP/IP 连接 Android 设备,支持在 Linux、Windows 和 macOS 主机上显示并控制 Android 设备。使用 scrcpy 不需要 root 权限,也不需要在设备端预装应用。请从官方项目页面获取工具和文档:https://github.com/Genymobile/scrcpy。
前提条件
- 魔方派 3 已启动 Android 15。
- 主机已安装 ADB,并可通过 USB Type-C 数据线连接到魔方派 3。
- 已完成 ADB 登录,
adb devices可以看到设备。
运行以下命令确认 ADB 连接正常:
adb devices
示例输出:
List of devices attached
d80af579 device
安装 scrcpy
- Windows 主机
- Ubuntu/Linux 主机
- macOS 主机
使用 WinGet 安装
在 Windows 终端或 PowerShell 中运行:
winget install --exact Genymobile.scrcpy
WinGet 安装方式会同时安装 scrcpy 所需的 ADB 相关依赖。安装完成后,重新打开终端,使环境变量生效。
使用官方 Release 包
- 访问 scrcpy releases。
- 根据主机架构下载 Windows 版本压缩包,例如
scrcpy-win64-*.zip。 - 解压压缩包。
- 在解压目录中双击
open_a_terminal_here.bat打开终端。
使用官方 Release 包
- 访问 scrcpy releases。
- 下载 Linux x86_64 静态构建包,例如
scrcpy-linux-x86_64-*.tar.gz。 - 解压压缩包,并在解压目录中运行
scrcpy。
使用安装脚本
如果需要从源码仓库安装最新 release,可在 Ubuntu 主机上运行:
sudo apt update
sudo apt install ffmpeg libsdl3-0 libusb-1.0-0 adb wget \
gcc git pkg-config meson ninja-build libsdl3-dev \
libavcodec-dev libavdevice-dev libavformat-dev libavutil-dev \
libswresample-dev libusb-1.0-0-dev libv4l-dev
git clone https://github.com/Genymobile/scrcpy
cd scrcpy
./install_release.sh
scrcpy 官方文档中标注 Debian/Ubuntu 仓库中的 apt install scrcpy 版本可能较旧。建议优先使用官方 Release 包或安装脚本。
使用 Homebrew 安装
在终端中运行:
brew install scrcpy
如果主机还没有安装 ADB,请继续运行:
brew install --cask android-platform-tools
使用官方 Release 包
- 访问 scrcpy releases。
- 根据主机架构下载 macOS 版本压缩包,例如
scrcpy-macos-aarch64-*.tar.gz或scrcpy-macos-x86_64-*.tar.gz。 - 解压压缩包,并在解压目录中运行
scrcpy。
使用 scrcpy 投屏
确认 ADB 可用后,在主机终端运行:
scrcpy
运行后,主机上会打开 Android 15 图形界面窗口。此时可以直接使用主机鼠标和键盘操作魔方派 3。
常用操作如下:
| 操作 | 说明 |
|---|---|
| 鼠标左键 | 点击 Android 界面 |
| 鼠标右键 | 返回 |
| 鼠标中键 | 回到主页 |
Alt + f | 切换全屏 |
如果主机同时连接了多台 Android 设备,请先查看设备序列号:
adb devices
然后指定设备启动 scrcpy:
scrcpy --serial <device_serial>
如果投屏延迟较高,可降低分辨率:
scrcpy --max-size 1024
如果不需要音频转发,可关闭音频:
scrcpy --no-audio
也可以同时降低分辨率并关闭音频:
scrcpy --max-size 1024 --no-audio
常见问题
找不到设备
如果 scrcpy 提示找不到设备,请先确认 ADB 是否正常:
adb devices
如果设备未显示为 device,请检查 USB Type-C 数据线、主机 ADB 环境和设备侧 USB 调试状态。
无法用鼠标键盘控制
如果可以看到画面但无法用鼠标键盘控制,请确认设备允许通过 ADB 注入输入事件。Android 15 userdebug 镜像通常可直接控制;如果使用其他系统镜像,请确认 USB debugging 已启用。
查看更多参数
在主机终端中运行:
scrcpy --help
或参考 scrcpy 官方文档:https://github.com/Genymobile/scrcpy。