QtScrcpy官方版

QtScrcpy官方版是一款开源的Android实时投屏与控制工具，可在Windows系统上运行。它通过USB或TCP/IP方式将手机画面同步到电脑，并实现远程操作控制，无需Root权限即可使用。在Windows端安装后，用户需要在手机开启USB调试模式，并通过数据线或同一局域网进行连接，即可在电脑上实时查看手机屏幕，并使用鼠标键盘进行操作控制。

该软件提供USB有线与无线网络两种连接方式，可应用于应用演示、手机投屏及测试调试等场景，在局域网环境中亦能获得较低的延迟表现。这款开源投屏工具兼容小米、三星、一加等主流安卓设备品牌，并允许多台设备同步控制，便于多机测试与批量操作，适合开发及演示用途。

自定义按键映射操作方法

不少用户想知道qtscrcpy里游戏按键映射该怎么调，也有人关心玩吃鸡时按键能不能自己设定，下面就来介绍一下。

可根据实际需求自行编写脚本，把电脑键盘上的按键对应成手机端的触摸点击操作，具体编写规则可在此处查阅。

启动后已内置和平精英与抖音两套键鼠映射方案：进入和平精英即可用键盘鼠标获得端游式操作体验；打开抖音后，方向键可模拟上下左右滑动。若需适配其他游戏，也能依据现有编写规则自行创建映射文件。默认键位安排如下：

1、把自行编写的脚本放进 keymap 目录即可生效。

2、点一下刷新脚本按钮，让脚本能够被正常识别出来

3、选择需要的脚本

4、把手机连上并开启服务，随后点一下应用脚本。

5、按下~键（位于数字键1左侧）即可切换至自定义映射模式开始使用（实际触发按键取决于按键脚本中设定的switchKey）

6、再按一次~键即可切回常规控制模式。

7、想让WASD键来操控车辆，需要先在载具设置里切换成单摇杆模式。

qtscrcpy黑屏怎么办？

投屏过程中遇到黑屏该如何应对？Qt 开发 Android 应用时，软件刚启动的一刹那会闪一下黑屏（部分机型表现为白屏），若设置了启动页，这次闪屏就出现在启动页登场之前，画面整体跳动明显，给视觉带来不小的冲击。

解决方法：

打开config.ini，把渲染模式改一下就能解决；也可以先把电脑或手机重启，再确认这个按钮是否已经开启。

qtscrcpy无线投屏教程：

1、无线连接会稍显繁琐一些：需要先在安卓手机的开发者选项里启用 USB 调试功能，然后用数据线将手机与电脑相连。

点一下刷新设备按钮，设备编号就会显示出来；接着按下获取设备IP，再点启动adbd。

2、接下来看无线连接这一项，点进去之后按一下刷新列表，就能看到多出一个以IP地址开头的设备。

3、连接环节无需额外设置，直接操作即可完成。该软件具备多台安卓设备的管理能力，最多可同时控制16部手机。

更新日志

v4.2.1版本

PERF：打开配置界面，让窗口空间得到充分利用

界面：更新界面语言与译文

多语言资源更新：中文、英文、日文及韩文的翻译内容已同步刷新。

重启过程中保留联发科编码器相关设置，即可完成修复。

修复了无线设备与组合盒在宽度显示上的偏差。

修正：更新星史图表

修补了macOS应用包的临时签名环节，在打包前先完成签名并核验其完整性。

qtscrcpy使用教程

1、把压缩包解开后，里面包含 qtscrcpy 在 GitHub 上发布的 Windows 版本，分别有 64 位与 32 位两种安装包。

2、按电脑配置挑好要用的安装包，双击“QtScrcpy.exe”即可直接运行，不用安装。

3、该软件同样开放源代码，可在电脑端跨多个系统运行，完全免费且不含广告；其连接方式有两种，一种是在同一WiFi环境下连接，另一种是通过USB连接。

4、不管采用哪种连接方式，第一步都得先用USB线把手机和电脑连起来，再把手机上的USB调试功能打开。

不少用户不清楚该功能在手机中的具体位置，操作路径通常是先进入“关于手机”页面，连续点击版本号七次即可激活开发者模式，完成后返回设置界面便能找到开发者选项。

5、部分手机插上数据线后默认只显示“仅充电”模式，此时需手动调整USB连接方式。

6、回到软件界面后点一下刷新设备列表，设备名称和序列号就会显示出来。

7、双击框内显示的设备名称即可发起连接，连接成功后，手机画面便会呈现在电脑屏幕上。

屏幕右侧集中了各类操作入口，这一点相比 FreeControl 更实用，毕竟部分手机至今仍保留实体 home 键。

功能介绍

1、同步呈现安卓设备画面。

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键位设置

一、自定义按键映射说明

按键映射采用 JSON 格式，若想加入自定义的映射配置，需将对应文件放入 keymap 目录，QtScrcpy 方能识别并加载。

按键映射文件的具体写法将在下文说明，自带的映射文件同样可作为参照。

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

1、通用说明

（1）按键映射里的坐标采用相对位置来表达，屏幕的宽度和高度均以1为基准。举例来说，假如屏幕分辨率为1920x1080，坐标(0.5，0.5)所指的位置，就是以屏幕左上角作为原点，将像素坐标(1920，1080)与(0.5，0.5)相乘，得到(960，540)处。

（2）按键映射里所用的按键码以Qt枚举形式呈现，具体含义可查阅Qt官方文档（在页面中检索“The key names used by Qt.”即可迅速找到相关条目）。

2、映射类型说明

（1）switchKey：用于开启或关闭自定义按键映射的按键。默认状态下为普通映射，按下该键即可在普通映射与自定义映射之间来回切换。

（2）mouseMoveMap：该功能将鼠标的位移映射为手指拖动操作，以startPos作为起点，手指的拖动方向与鼠标移动方向保持一致。

在FPS类手游里，这个选项通常用于调节角色的视野范围。

（1）startPos：手指开始拖动的初始位置

（2）speedRatio 用于设定鼠标位移与手指拖动之间的换算比例，借此调节鼠标的响应灵敏度。

（3）keyMapNodes：普通按键映射项，采用 JSON 数组存放，所有常规按键的映射关系都集中在该数组内，作用是把键盘上的按键对应成普通的手指点击操作。

按键映射通常可以分成以下几种类型：

（1）keyMapNodes 里每个元素都必须明确指定 type 字段，它表示按键映射的类型，可选值包括以下几种：

（2）KMT_CLICK 普通点击：用键盘按键的按下与抬起，分别模拟手指的按下与抬起动作。

（3）KMT_CLICK_TWICE 双击操作：键盘按下时模拟手指按下并抬起，键盘抬起时再次模拟手指按下并抬起

（4）KMT_STEER_WHEEL 方向盘映射：该映射面向 FPS 游戏，用来控制角色脚步移动方向，需配合四个按键使用。

3、各类按键映射类型专属属性解析：

（1）KMT_CLICK

（2）按键码需要映射到的 key

（3）pos 用于设定模拟触摸所发生的位置

（4）switchMap 用于控制是否切换按键模式：按下该键后，除默认的模拟触摸映射外，还会一并切换到按键映射模式吗？（可参考和平精英映射里 M 地图映射的效果）

（5）双击动作

（6）需映射到的按键码

（7）设定模拟触摸所使用的位置坐标

（8）KMT_STEER_WHEEL

（9）方向盘中心位置坐标

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

（11）rightKey：用于控制向右方向移动的按键

（12）upKey 用于控制上方向按键

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

（14）按下左方向键后，模拟拖动至centerPos水平左侧leftOffset处的位置。

（15）rightOffset：按下右方向键后，模拟拖动至相对 centerPos 水平偏右 rightOffset 的位置。

（16）当按下或抬起方向键时，程序会模拟将对象拖动至相对于 centerPos 位置水平向上偏移 upOffset 的坐标处。

（17）downOffset：按下方向键的下键时，模拟拖动会移动到 centerPos 相对位置的水平偏下 downOffset 处。

软件特点

1、QtScrcpy 支持以 USB 或 TCP/IP 方式连接 Android 设备，实现画面显示与操作控制，且无需 root 权限。

2、一个应用最多可让16台安卓设备同时接入。

3、可运行于Windows、MacOS以及GNU/Linux这三类主流桌面系统之上

4、它专注于：

5、精致（画面仅呈现在设备屏幕上）

6、运行表现（30~60fps）

7、画质要求：分辨率需达到1920×1080及以上

8、延迟表现控制在 35~70ms 区间。

9、快速启动：首帧画面可在1秒内呈现

10、非侵入式设计：无需在设备上安装任何软件。