QtScrcpy 入门指南：投屏、无线连接与键鼠映射一次讲清

QtScrcpy 入门指南投屏、无线连接与键鼠映射一次讲清【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy如果你曾经在手机上用两根拇指瞄准手指挡住屏幕还嫌视野太小QtScrcpy 值得一试。这是一款开源免费的投屏控制工具能把安卓屏幕投射到电脑上Windows、macOS、Linux 均可并用键盘鼠标操作游戏。本文按先投屏、再配映射、后多设备的顺序把连接方式、键鼠映射文件写法、批量管理逐项讲清楚。 先看效果键盘鼠标如何接管游戏在配置之前先明确最终效果映射开启后键盘按键会被转换成手机屏幕上的点击鼠标移动会被转换成手指拖动。比如用 WASD 绑住左侧摇杆、用鼠标转向控制视角、用 QWEF 绑住技能键。坐标是怎么表达的映射文件里不写像素而是写比例。整块屏幕视为一个单位正方形左上角是 (0, 0)右下角是 (1, 1)所以 (0.5, 0.8) 表示横向 50%、纵向 80% 处。比例制的配置换分辨率不用改。如何拿到精确坐标在手机开发者选项里开启显示指针位置。开启后鼠标在屏幕上移动时窗口顶部状态栏会实时显示当前 x/y 比例值直接抄下来即可。映射模式由哪个键切换默认是~键。按一下从普通操控切进映射模式再按一下退出。后文所有按键方案都在映射模式下生效。第一次投屏从 USB 线到无线先拿到软件到仓库 Releases 页面下载对应系统版本即可如需自行编译可克隆仓库git clone https://gitcode.com/GitHub_Trending/qt/QtScrcpy要求安卓 5.0 以上系统 一台电脑。连接前需要在手机上做两件事设置 → 关于手机连续点击版本号7 次激活开发者模式然后进入开发者选项打开USB 调试和显示指针位置后者是映射部分取坐标的前提别漏。用 USB 线连接数据线接上手机打开 QtScrcpy在USB线区域点刷新设备列表。设备序列号下拉框里出现手机型号后选中它点启动服务投屏窗口弹出手机画面实时显示在电脑上。 无线连接怎么设置不想一直插 USB 线的话手机和电脑连在同一个 Wi-Fi 下按顺序点三个按钮获取设备 IP——读到手机的 IP 地址启动 adbd在无线区域填入 IP 和端口默认 5555点无线连接。之后拔掉 USB 线下次直接选无线设备点启动服务。注意无线延迟普遍高于 USB整体投屏延迟通常在 35–70ms 区间追求跟手就用 USB。映射文件在哪里改、怎么写映射配置是 JSON 文件。仓库的 keymap/ 目录自带若干游戏示例和平精英、第五人格、抖音等新建自己的 .json 文件放进同一目录点主界面刷新脚本即可被识别。文件结构顶层有switchKey映射切换键默认~即Key_QuoteLeft和keyMapNodes数组数组中每一项把一个按键绑定一个动作{ switchKey: Key_QuoteLeft, keyMapNodes: [ { comment: W 绑左侧摇杆, type: KMT_CLICK, key: Key_W, pos: { x: 0.1, y: 0.8 } } ] }按键名采用 Qt 的键枚举如Key_Space、Key_Up完整清单和字段说明见按键映射格式文档。常用动作类型KMT_CLICK普通点击按下模拟手指落下、抬起模拟抬起适合摇杆与开火键KMT_CLICK_TWICE双击一次按键触发两下连点KMT_CLICK_MULTI多点连点在clickNodes里按 delay 和 pos 依次指定一个键完成一套连招KMT_DRAG拖拽指定startPos与endPos按下即完成一次滑动。鼠标移动映射mouseMoveMap段把鼠标移动映射为以固定起点如角色中心出发的手指拖动射击游戏里一般用它调视角。拖动距离由speedRatio控制也可用speedRatioX/speedRatioY分别调 X、Y 轴数值越大灵敏度越低。起步可参考speedRatioX: 2.5、speedRatioY: 2.0Y 轴略低于 X 轴避免抬头低头幅度被放大再按手感微调。文件写好后点刷新脚本选中文件 → 连接设备 → 点应用脚本 → 游戏里按~进入映射模式即可使用。射击与 MOBA 的键位参考以和平精英为例常见的布法是移动在左、技能在右开火交给鼠标左键按键动作建议坐标说明W/S/A/D移动约 (0.1, 0.8)左侧摇杆区域鼠标左键射击(0.85, 0.7)右下开火键鼠标右键开镜(0.9, 0.2)右上瞄准键空格跳跃(0.15, 0.7)左侧跳跃键Ctrl蹲下(0.8, 0.8)右侧下蹲键Z趴下(0.75, 0.85)右侧趴下键绑完后用显示指针位置逐点校准再调mouseMoveMap的灵敏度直到视角转动跟手。MOBA 游戏如王者荣耀更简单Q/W/E/R 对应四个技能图标F 绑召唤师技能空格绑回城每个键对准对应图标位置即可。短视频类应用同样适用↑↓ 上下滑动、←→ 左右切换、空格暂停/播放、Enter 点赞。多设备同开多台手机的批量管理手里有多台手机时全部接上电脑USB 或无线点刷新设备列表逐台启动服务每台设备对应一个独立投屏窗口窗口可自由摆放。游戏多开、批量应用测试等场景常用到三类操作同步控制同一套操作下发到所有设备独立控制只操作其中一个窗口其余保持不动统一配置启动参数比特率、尺寸、脚本一次设定各窗口复用。⚠️ 排错与流畅度调优画面或控制异常投屏无画面打开 config.ini修改UseDesktopOpenGL取值——0 为软解、1 为 DX 硬解、2 为 OpenGL 硬解逐一试到正常有画面但控制不了确认手机开发者选项已允许模拟点击且USB 调试安全设置已开启无线连接失败确认手机与电脑在同一网络且 USB 连接状态下执行过启动 adbd映射突然失效先确认是否处于映射模式不在的话按~切回和平精英上下车失效属于游戏侧机制连按两次~一般可恢复无法输入中文手机上安装搜狗或 QQ 等中文输入法Windows 画面模糊右键程序属性 → 兼容性 → 更改高 DPI 设置将高 DPI 缩放行为设为由应用程序执行。延迟偏高怎么办在启动配置区把比特率调到 2–8Mbps 区间、调低最大尺寸分辨率、改回 USB 连接、关闭占用 CPU 的后台程序。若只录屏不围观可勾选录屏屏幕后台录制降低本机负载。快捷键速查普通控制未进映射模式下以下快捷键随时可用功能WindowsMac切换全屏Ctrl FCmd F窗口 1:1 比例Ctrl GCmd G去除黑边Ctrl WCmd W主页键Ctrl HCtrl H返回键Ctrl BCmd B切换应用Ctrl SCmd S菜单键Ctrl MCtrl M音量增加Ctrl ↑Cmd ↑音量减少Ctrl ↓Cmd ↓电源键Ctrl PCmd P关闭屏幕Ctrl OCmd O复制到剪贴板Ctrl CCmd C粘贴到设备Ctrl Shift VCmd Shift VQtScrcpy 的本质是把手机屏幕变成一块由键盘鼠标驱动的大屏连接只是几个按钮的事映射只是一份 JSON剩下的都是微调。现在就可以把手机用 USB 接上点一下刷新设备列表再点启动服务看到第一个投屏画面。【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考