3 步上手 QtScrcpy安卓投屏控制与键鼠操作完全指南【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy想把手机画面切到会议室大屏又想在电脑上用键盘鼠标流畅玩手游同时不 root、不往手机里装任何东西QtScrcpy 是一款免费开源的安卓投屏控制软件通过 USB 或 WiFi 把 Android 设备屏幕实时镜像到桌面并用键鼠操控延迟 35~70ms启动后 1 秒内出第一帧画面支持 Windows、macOS、Linux 三个平台。和官方版 scrcpy 比它多给了你什么QtScrcpy 基于 Google 系的开源项目 scrcpy 复刻重构技术栈换成了 C Qt OpenGL FFmpeg但保留了两者的共同底线非侵入设备端不安装任何常驻软件Android 端最低要求 API 21即 Android 5.0。对普通用户来说最直观的差异是scrcpy 是命令驱动的 SDL 界面而 QtScrcpy 把设备列表、启动参数、录制、脚本加载都做成了可视化按钮并且加了 scrcpy 没有的两件事——自定义按键映射和多设备批量操作。关键点scrcpyQtScrcpy界面SDLQt 图形界面编程方式C同步CQt 信号槽异步按键映射不支持自定义支持 JSON 脚本自定义多设备单设备为主多设备连接 批量操作编译方式Meson GradleCMake三步连上第一台设备第 1 步拿到程序。从项目 releases 下载对应平台的预编译版本Windows 解压后直接运行QtScrcpy.exemacOS 把 DMG 里的应用拖进应用程序文件夹Arch Linux 用户执行yay -Syu qtscrcpy。想从源码构建的话git clone --recurse-submodules https://gitcode.com/GitHub_Trending/qt/QtScrcpy克隆完成后能看到keymap/、ci/、QtScrcpy/等目录即成功构建脚本在ci/下Linux 执行ci/linux/build_for_linux.sh Release产物在output/x64/Release。第 2 步手机侧准备。设置 → 关于手机 → 连续点 7 次版本号打开开发者选项然后在开发者选项里打开USB 调试用数据线连上电脑手机上弹出授权提示时点允许。✅ 看到手机弹出 USB 调试授权框并确认即成功。第 3 步一键连接。打开 QtScrcpy点击一键 USB 连接或先点刷新设备再选设备。✅ 1 秒内弹出独立窗口显示手机实时画面画面跟随手机滚动即连接成功。QtScrcpy 在 Windows 下的主界面左侧面板管理设备与服务右侧为投屏窗口不想一直插线的话可以走无线连接先 USB 连好点获取设备 IP→启动 adbd→无线连接之后拔掉 USB 线也行只要 adbd 还在运行就不再需要数据线。把画面投出去同时能操控投屏只是起点真正好用在于双向控制。鼠标点击、拖拽直接作用在手机上窗口支持全屏、置顶还能边投屏边录制屏幕、截图或者勾选仅后台录制只录不显。几个高频操作直接走快捷键Windows 用 CtrlmacOS 用 Cmd快捷键功能Ctrl h回手机主页Ctrl b返回右键双击鼠标等效Ctrl o关闭手机屏幕但保持投屏Ctrl f切换全屏Ctrl w / 左键双击黑边去掉黑边窗口贴合画面文件交互也省掉了 adb 命令APK 拖进投屏窗口直接安装普通文件拖进窗口传到手机/sdcard/路径可在config/config.ini的PushFilePath改。剪贴板三件套Ctrl c手机复制到电脑、Ctrl Shift v电脑注入到手机、Ctrl v粘贴文本事件到手机。macOS 平台下的投屏界面多设备窗口可同时摆放关键性能参数30~60fps 输出分辨率 1920×1080 以上端到端延迟 35~70ms。声音转发基于 sndcpy仅 Android 10作者标注目前不推荐蓝牙连接是更稳的替代。用键盘鼠标打手游操作原生模式下鼠标就是手指够用但不如端游顺手。QtScrcpy 的按键映射系统把键盘按键和鼠标事件映射成手机上的触摸点击、拖拽、方向盘操作规则写在 JSON 脚本里放进keymap/目录就能被识别。仓库自带了现成脚本打开keymap/目录能看到gameforpeace.json和平精英、tiktok.json抖音方向键映射为上下左右滑动、identityv.json第五人格等。和平精英脚本里WASD 映射为方向盘、空格是跳、左右键是开镜/开枪、鼠标移动控制视野基本还原了端游手感。开启和平精英按键映射后用键盘鼠标操作手游的实战画面启用方式是刷新脚本 → 选择脚本 → 启动服务后点应用脚本 → 按~键切入映射模式再按一次~切回普通控制。脚本支持 5 种映射类型单次/双击/多次点击、拖拽、方向盘坐标用相对位置表示屏幕宽高各按 1 归一化编写规则完整记录在 docs/KeyMapDes_zh.md。同时管多台设备设备列表支持同时接入多台手机每台一个投屏窗口勾选设备后启用群控主控窗口的操作会同步到所有被勾选的设备。批量铺货、多开测试、课堂演示这类场景就靠它。群控模式下主控窗口的操作同步到多台设备实战工作流键鼠玩和平精英完整走一遍照着做能复现连接数据线连手机点一键 USB 连接确认投屏窗口出现。加载脚本点刷新脚本在下拉框里选中gameforpeace.json。应用确认服务已启动点应用脚本。切换模式进游戏后按~键启用映射此时鼠标移动变成视角拖拽。校准坐标换游戏或按钮对不上时鼠标左键在投屏窗口上点一下控制台会打印该位置的pos值直接填进 JSON 对应节点的pos即可也可以在手机开发者选项里打开显示指针位置辅助观察。上车注意载具设置里切换为单摇杆模式避免方向盘映射失效。左键单击投屏窗口时控制台输出 pos 坐标直接用于校准映射脚本一个已知边界和平精英中上下车会创建新界面导致触摸点失效目前没有根治办法连续按两次~键可以恢复这是官方 FAQ 里给出的处理方式。避坑与调优Q刷新设备后列表里没有设备先随便用一个手机助手软件连接成功一次再回来刷新如果报adb server version ... doesnt match this client是电脑里多个 adb 版本打架杀掉 adb 进程重来或在config.ini里用AdbPath指定当前 adb 路径。Q能看到画面但点不了手机小米等机型需要在 USB 调试里额外打开允许模拟点击安全设置项见 docs/FAQ.md。Q能控制但看不到画面控制台若出现shader program is not linked说明显卡不支持当前渲染方式把config.ini里UseDesktopOpenGL改成1dx 硬解或2opengl 硬解再试。Q打不了中文手机端装搜狗或 QQ 输入法并设为默认即可QtScrcpy 本身支持完整中文输入。Q报 Could not open video stream原因很多最直接的办法是在启动配置里选一个更低的分辨率。配置调优对照文件config/config.ini场景参数预期效果追求最低延迟RenderExpiredFrames0默认跳过过期帧画面延迟更低高帧率需求MaxFps60Android 10 生效帧率上限提到 60显卡兼容问题UseDesktopOpenGL1或2恢复画面渲染无线网络弱启动配置里调低分辨率画面稳定不卡死资源导航docs/FAQ.md连接、控制、渲染类问题的官方排查清单docs/KeyMapDes_zh.md按键映射脚本完整编写规则keymap/和平精英、抖音、第五人格等现成映射脚本config/config.ini解码方式、帧率、路径等全部可调项docs/DEVELOP.md源码构建与二次开发说明构建脚本在ci/下遇到问题带着控制台日志到 QQ 群 901736468 提问。先按三步连接把第一台设备跑起来再逐步试无线连接和按键映射是上手最快的路径。【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考