QtScrcpy  v4.2.0

QtScrcpy是一款开源的实时投屏与控制工具，支持在win系统上运行，通过USB、tcp、IP方式将手机画面同步到电脑，实现远程操作控制，无需root权限即可使用。用户需要在手机开启USB调试模式，通过数据线或者同一局域进行连接，即可在电脑上实时查看手机屏幕，使用鼠标键盘进行操作控制，还能够一键保存和加载配置方案，创建专属游戏脚本。

QtScrcpy软件特色

1.支持录制功能，直接在软件界面开始录制，并将视频保存为MP4或MKV。

2.支持后台录制功能，只需激活录制按钮，即可在后台自动录制屏幕。

3.支持查看USB连接的设备信息，可以在软件中显示设备名称和序列号。

QtScrcpy软件亮点

1.支持1080P/2K高清分辨率，USB连接延迟低至35ms，WiFi模式也流畅，实时同步手机屏幕和电脑屏幕。

2.支持模拟触摸、滑动和多点触摸，提供远远超出触摸屏、Delta Action和其他FPS游戏工具的移动游戏体验。

3.内置按键映射编辑器，可定制与屏幕按键对应的键盘和鼠标操作，一键保存和加载配置方案，创建专属游戏脚本。

QtScrcpy软件优势

1、实时显示Android设备屏幕。

2、实时键鼠控制Android设备。

3、屏幕录制。

4、无线连接。

5、最多支持16台设备连接(PC性能允许的情况下可以增加，需要自己编译)。

6、全屏显示。

7、窗口置顶。

8、安装apk：拖拽apk到视频窗口即可安装。

9、传输文件：拖拽文件到视频窗口即可发送文件到Android设备。

10、后台录制：只录制，不显示界面。

11、复制粘贴在计算机和设备之间双向同步剪贴板：

(1)Ctrl + c将设备剪贴板复制到计算机剪贴板;

(2)Ctrl + Shift + v将计算机剪贴板复制到设备剪贴板;

(3)Ctrl +v 将计算机剪贴板作为一系列文本事件发送到设备(不支持非ASCII字符)

qtscrcpy无线投屏操作教程

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

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

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

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

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处

常见问题

问：使用 Scrcpy 需要给手机 ROOT 权限吗?

答：不需要 ROOT，仅需要开启手机「开发者选项」与 USB 调试，安卓 5.0 及以上设备即可正常使用。

问：手机上要不要安装配套 APP?

答：不用安装任何软件，连接依靠 ADB 通道，不会在手机留存任何程序，安全性更高。

问：可以无线投屏，一直插数据线吗?

答：支持无线连接，手机电脑处于同一局域网;首次无线配置需要数据线，后续可无线直连。

问：投屏怎么没有声音，音频无法同步?

答：音频转发仅支持Android 11 及以上旧系统仅画面投屏，无法传输音频;可升级系统或者外接录音方案。

问：打开提示找不到设备，连接失败怎么处理?

答：确认开启 USB 调试、允许电脑调试授权;数据线使用支持数据传输款;更换 USB 接口，重启 ADB 服务。