Qtscrcpy

QtScrcpy是一款免费开源跨平台安卓投屏与控制工具，完美适配Windows等主流操作系统。它通过USB有线或WiFi无线方式，将安卓设备的屏幕实时投射至电脑，并允许用户直接使用电脑的键盘和鼠标进行反向操控。该软件不仅继承了原版Scrcpy极低延迟与高画质的性能天花板，还通过Qt框架提供了直观易用的图形化界面，彻底降低了普通用户的使用门槛。

在功能体验上，QtScrcpy无需Root权限，手机端也无需安装任何额外App，却提供了极其丰富的扩展功能，包括一键屏幕录制与截图、APK拖拽安装、文件双向传输以及电脑与手机剪贴板双向同步。更为亮眼的是，它内置了强大的自定义按键映射编辑器，支持加载游戏专属键位脚本，让手游玩家也能享受键鼠操作的快感。此外，软件还支持最多16台设备的同屏管理与群控模式，无论是移动应用开发调试、游戏直播、多设备批量测试，还是日常大屏办公与教学演示，QtScrcpy都能为您提供专业、稳定且高效的跨屏交互解决方案。

软件优势

1、轻量化（仅显示设备屏幕）

2、性能（30~60 fps）

3、画质（1920×1080 或更高）

4、低延迟 (35~70ms)

5、启动时间短（仅约1秒即可显示第一帧）

6、无侵入性（设备上不会安装任何东西）

Qtscrcpy使用教程

1、下载解压后即可获得qtscrcpy github win版的64位和32位包

2、根据自己的电脑选择相对于要使用的安装包，并直接双击“QtScrcpy.exe”无需安装就能直接运行

3、软件同样是开源的，电脑端多系统，无广告完全免费，能看出它的连接方式分为两种，一个是同一WiFi下，一个是用USB连接

4、无论是哪种连接方式，首先需要用USB连接手机和电脑，并打开手机里的USB调试

有些人找不到这个在手机哪里，一般点击关于手机，然后点7下版本号，就能开启开发者模式，最后返回设置进入开发者选项

5、有些手机连接后只有“仅充电”，需要更改USB连接方式

USB 连接方式传输照片传输文件仅充电反向充电为已连接设备供电MIDI将设备用作MIDI输入设备

6、然后回到软件，点击刷新设备列表，就会出现设备名称加序列号

7、直接双击框中的设备名称就能连接，成功后电脑屏幕会出现手机的屏幕

屏幕的右边是各种操作的功能，这一点就比FreeControl好，毕竟有些手机依旧存在home键

Qtscrcpy无线投屏教程

1、无线连接就有些麻烦了，首先依旧是安卓手机端在开发者选项中打开usb调试，并通过usb连接安卓手机到电脑

点击刷新设备，会看到有设备号更新出来，点击获取设备IP，点击启动adbd

2、再看无线这一行，点击无线连接，然后点击刷新列表，会发现多出了一个IP地址开头的设备

3、最后一步直接连接就可以了，软件支持控制多个安卓手机，最高同时支持16个！

Qtscrcpy黑屏解决方法？

在进行投屏的时候出现黑屏不知道怎么处理？在用Qt 开发 android程序时，打开软件的瞬间会出现黑屏（有些手机是上是白屏）闪动的问题，如果有启动页的话，那么黑屏是在启动页之前出现，整个页面的跳动，视觉冲击很大

解决方法：

在config.ini里面更改渲染模式即可解决，或者电脑、手机重开机，然后检查一下这个按钮开了没有。

自定义按键映射操作方法

许多人都好奇qtscrcpy游戏映射调整怎么设置，或是问qtscrcpy吃鸡的按键可以自定义不，那么可参考下文：

可以根据需要，自己编写脚本将PC键盘按键映射为手机的触摸点击，编写规则在这里。

默认自带了针对和平精英手游和抖音进行键鼠映射的映射脚本，开启平精英手游后可以用键鼠像玩端游一样玩和平精英手游，开启抖音映射以后可以使用上下左右方向键模拟上下左右滑动，你也可以按照编写规则编写其他游戏的映射文件，默认按键映射如下：

1、编写自定义脚本放入keymap目录

2、点击刷新脚本，确保脚本可以被检测到

3、选择需要的脚本

4、连接手机并启动服务之后，点击应用脚本

5、按~键（数字键1左边）切换为自定义映射模式即可体验（具体按什么键要看你按键脚本定义的switchKey）

6、再次按~键切换为正常控制模式

7、要想wasd控制开车记得在载具设置中设置为单摇杆模式

Qtscrcpy键位设置说明

一、自定义按键映射说明

按键映射文件为json格式，新增自己的按键映射文件需要放在keymap目录中才可以被QtScrcpy识别。

按键映射文件的具体编写格式下面会介绍，也可以参考自带的按键映射文件。

二、按键映射脚本格式说明

1、通用说明

（1）按键映射中的坐标位置都是用相对位置表示的，屏幕的宽高都用1表示，例如屏幕的像素为1920x1080，那么坐标(0.5，0.5)则表示的是以屏幕左上角为原点，像素坐标(1920，1080)*(0.5，0.5)=(960，540)的位置。

（2）按键映射中的按键码是用Qt的枚举表示的，详细说明可以[参考Qt文档](https://doc-snapshots.qt.io/4.8/qt.html)(搜索 The key names used by Qt. 可以快速定位)。

2、映射类型说明

（1）switchKey：切换自定义按键映射的开关键，默认为普通映射，需要使用这个按键在普通映射和自定义映射之间切换。

（2）mouseMoveMap：鼠标移动映射，鼠标的移动将被映射为以startPos为起点，以鼠标移动方向为移动方向的手指拖动操作。

一般在FPS手游中用来调整人物视野。

（1）startPos 手指拖动起始点

（2）speedRatio 鼠标移动映射为手指拖动的比例，可以控制鼠标灵敏度

（3）keyMapNodes 一般按键的映射，json数组，所有一般按键映射都放在这个数组中，将键盘的按键映射为普通的手指点击。

一般按键映射有如下几种类型：

（1）type 按键映射的类型，每个keyMapNodes中的元素都需要指明，可以是如下类型：

（2）KMT_CLICK 普通点击，键盘按下模拟为手指按下，键盘抬起映射为手指抬起

（3）KMT_CLICK_TWICE 两次点击，键盘按下模拟为手指按下再抬起，键盘抬起映射为手指按下再抬起

（4）KMT_STEER_WHEEL 方向盘映射，专用于FPS游戏中移动人物脚步的方向盘的映射，需要4个按键来配合。

3、不同按键映射类型的专有属性说明：

（1）KMT_CLICK

（2）key 要映射的按键码

（3）pos 模拟触摸的位置

（4）switchMap 是否切换按键模式，点击此按键后，除了默认的模拟触摸映射，是否附带切换按键映射模式。(可以参考和平精英映射中M地图映射的效果)

（5）KMT_CLICK_TWICE

（6）key 要映射的按键码

（7）pos 模拟触摸的位置

（8）KMT_STEER_WHEEL

（9）centerPos 方向盘中心点

（10）leftKey 左方向的按键控制

（11）rightKey 右方向的按键控制

（12）upKey 上方向的按键控制

（13）downKey 下方向的按键控制

（14）leftOffset 按下左方向键后模拟拖动到相对centerPos位置水平偏左leftOffset处

（15）rightOffset 按下右方向键后模拟拖动到相对centerPos位置水平偏右rightOffset处

（16）upOffset 按下上方向键后模拟拖动到相对centerPos位置水平偏上upOffset处

（17）downOffset 按下下方向键后模拟拖动到相对centerPos位置水平偏下downOffset处

QtScrcpy核心功能亮点

1、极致性能与高清低延迟

基于C++与OpenGL硬件加速渲染，提供30~60fps的流畅帧率与1080P/2K级的高清画质。USB连接延迟低至35~70ms，无线连接约100ms，且启动后1秒内即可显示首帧画面，带来丝滑的实时交互体验。

2、零门槛跨平台与非侵入式设计

完美兼容Windows、macOS和Linux三大桌面系统。无需手机Root权限，手机端也无需安装任何额外App，仅凭ADB协议即可实现安全、轻量级的跨屏连接与控制。

3、丰富的多媒体与文件管理

支持一键屏幕录制（MP4格式）、后台静默录制及高清截图。同时提供便捷的APK拖拽自动安装、文件双向传输以及电脑与手机之间的剪贴板双向同步功能，大幅提升操作效率。

4、专属按键映射与游戏适配

内置高度自由的自定义按键映射系统，支持通过JSON脚本配置专属键位。玩家可轻松将手游操作映射到键盘鼠标上，并内置了多款热门游戏的预设脚本，让大屏玩手游更具沉浸感。

5、强大的多设备群控与批量管理

支持单窗口同时连接并管理多达16台安卓设备。提供标签页切换、设备分组及同步操作功能，无论是多设备批量测试还是工作室群控，都能轻松实现统一调度与独立控制。

更新日志

v4.2.1版本

改进

PERF：展开配置页面以利用可用的窗口空间

UI：刷新UI语言和翻译

i18n：中文、英文、日文和韩文翻译资源更新

修复

修复方法：在重启时保留联发科编码器选项

修复：校正无线设备与组合盒的宽度

修正：更新星史图表

修复：临时签署macOS应用捆绑包并验证其完整性后再打包