QtScrcpy 虚拟按键配置指南:3 步把键盘鼠标映射到手机上

发布时间:2026/9/3 11:45:50
QtScrcpy 虚拟按键配置指南:3 步把键盘鼠标映射到手机上 QtScrcpy 虚拟按键配置指南3 步把键盘鼠标映射到手机上【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy用键盘鼠标玩手机游戏是很多人的第一个需求。QtScrcpy 支持自定义按键映射你只需加载一个 JSON 脚本按下键盘键位它就会模拟成手机屏幕上的点击和滑动。整个过程不需要 root手机只需要开启 USB 调试ADB 就是电脑给手机发指令的通道。第一次使用加载一个现成脚本仓库的 keymap/ 目录里自带了几个映射文件gameforpeace.json和平精英、tiktok.json抖音方向键滑动、空格暂停/继续、test.json功能测试用等。使用流程固定为五步照着点就行把要用的脚本放进keymap/目录自带的已就位在界面点击刷新脚本让 QtScrcpy 检测到文件选中你需要的脚本连接手机、启动服务后点击应用按~键脚本里定义的switchKey切入自定义映射模式再按一次切回普通模式和平精英的默认配置已经调好了手感WASD走位、空格跳跃、Q/E左右探头、Alt小眼睛视角。进入训练场熟悉一遍基本就能上手。键位坐标怎么校准先量位置再写脚本想自己写脚本最关键的问题是手指应该按在屏幕的哪个位置映射脚本里的坐标是相对值——屏幕宽高都记作 1(0.5, 0.5)就是正中心。这样无论手机分辨率多少位置都不会偏移。拿到坐标有两个办法在开发者选项里打开显示指针位置在手机上点一下就能看到像素坐标直接左键单击视频窗口QtScrcpy 控制台会输出当前的pos直接抄进脚本即可写一个自己的映射脚本5 种类型够用不会手写规则时可以照着 test.json 改。一份脚本主要包含switchKey切换键和keyMapNodes按键数组数组里每个元素通过type字段声明动作类型type作用关键参数KMT_CLICK普通点击按下手指按下key、posKMT_CLICK_TWICE双击key、posKMT_CLICK_MULTI一个键按顺序多点几处clickNodes、delayKMT_DRAG从起点拖到终点做滑动startPos、endPos、dragSpeedKMT_STEER_WHEEL四键方向盘模拟摇杆走位centerPos、upKey等比如抖音脚本里的上滑本质就是一条拖拽记录{ type: KMT_DRAG, key: Key_Up, startPos: { x: 0.5, y: 0.7 }, endPos: { x: 0.5, y: 0.3 } }按键码用的是 Qt 枚举如Key_Space完整编写规则在 docs/KeyMapDes_zh.md写好后放进keymap/目录刷新脚本即可生效。调出手感灵敏度与拖拽速度手感不满意时主要调这几个参数参数名见官方文档参数含义调整方向speedRatioX/speedRatioY鼠标移动映射为手指拖动的比例控制镜头灵敏度数值越大灵敏度越低dragSpeed拖拽移动速度0~1数值越大滑动越快startDelay拖拽开始前的等待毫秒数配合宏操作使用和平精英预设里speedRatioX是 3.25、speedRatioY是 1.25Y 轴以 2.25 的比率平移可以把它当基准在你自己的脚本里微调。⚠️ 注意官方说明speedRatioX/Y的取值至少要 0.001写小了会失效。KMT_DRAG还适合做压枪这类固定轨迹操作KMT_STEER_WHEEL则负责 FPS 游戏的摇杆移动四个方向键预设里就是WASD围着centerPos模拟拖动。多台手机同时操作群控模式如果你要同时盯多台设备QtScrcpy 支持群控——把同一套鼠标键盘操作同步分发到所有已连接的手机配合KMT_DRAG、KMT_CLICK_MULTI这类可编排动作同一台电脑就能让多台手机执行相同的滑动和连点。不生效了按这张表排查现象解决办法有画面但无法控制小米等机型需在 USB 调试里打开允许模拟点击刷新设备后列表为空先装任一手机助手连接成功后再刷新提示 adb 版本冲突在任务管理器结束旧 adb 进程或用config.ini指定 AdbPath提示 Could not open video stream把启动配置里的分辨率调低一档和平精英上下车后键位失效连按两次~切出再切回映射模式更多问题可翻 FAQ。到这里一套完整的 QtScrcpy 虚拟按键就搭好了从 keymap/ 挑个预设起步用显示指针位置或控制台pos校准坐标再按 KeyMapDes_zh 的规则写自己的keyMapNodes。先跑通test.json再改游戏配置是最省心的路径。【免费下载链接】QtScrcpyAndroid real-time display control software项目地址: https://gitcode.com/GitHub_Trending/qt/QtScrcpy创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考