qtscrcpy⾃定义按键_按键映射说明.md
# ⾃定义按键映射说明
按键映射⽂件为json格式，新增⾃⼰的按键映射⽂件需要放在keymap⽬录中才可以被QtScrcpy识别。
按键映射⽂件的具体编写格式下⾯会介绍，也可以参考⾃带的按键映射⽂件。
## 按键映射脚本格式说明
### 通⽤说明
- 按键映射中的坐标位置都是⽤相对位置表⽰的，屏幕的宽⾼都⽤1表⽰，例如屏幕的像素为1920x1080，那么坐标(0.5,0.5)则表⽰的是
以屏幕左上⾓为原点，像素坐标(1920,1080)*(0.5,0.5)=(960,540)的位置。
### 映射类型说明
- switchKey：切换⾃定义按键映射的开关键，默认为普通映射，需要使⽤这个按键在普通映射和⾃定义映射之间切换。
- mouseMoveMap：⿏标移动映射，⿏标的移动将被映射为以startPos为起点，以⿏标移动⽅向为移动⽅向的⼿指拖动操作。
⼀般在FPS⼿游中⽤来调整⼈物视野。
- startPos ⼿指拖动起始点
- speedRatio ⿏标移动映射为⼿指拖动的⽐例，可以控制⿏标灵敏度
- keyMapNodes ⼀般按键的映射，json数组，所有⼀般按键映射都放在这个数组中，将键盘的按键映射为普通的⼿指点击。
⼀般按键映射有如下⼏种类型：
- type 按键映射的类型，每个keyMapNodes中的元素都需要指明，可以是如下类型：
- KMT_CLICK 普通点击，键盘按下模拟为⼿指按下，键盘抬起映射为⼿指抬起
- KMT_CLICK_TWICE 两次点击，键盘按下模拟为⼿指按下再抬起，键盘抬起映射为⼿指按下再抬起
- KMT_STEER_WHEEL ⽅向盘映射，专⽤于FPS游戏中移动⼈物脚步的⽅向盘的映射，需要4个按键
来配合。
不同按键映射类型的专有属性说明：
- KMT_CLICK
- key 要映射的按键码
- pos 模拟触摸的位置
- switchMap 是否切换按键模式，点击此按键后，除了默认的模拟触摸映射，是否附带切换按键映射模式。(可以参考和平精英映射中M地图映射的效果)
- KMT_CLICK_TWICE
- key 要映射的按键码
- pos 模拟触摸的位置
- KMT_STEER_WHEEL
- centerPos ⽅向盘中⼼点
- leftKey 左⽅向的按键控制
- rightKey 右⽅向的按键控制
- upKey 上⽅向的按键控制
- downKey 下⽅向的按键控制
- leftOffset 按下左⽅向键后模拟拖动到相对centerPos位置⽔平偏左leftOffset处
- rightOffset 按下右⽅向键后模拟拖动到相对centerPos位置⽔平偏右rightOffset处- upOffset 按下上⽅向键后模拟拖动到相对centerPos位置⽔平偏上upOffset处
- downOffset 按下下⽅向键后模拟拖动到相对centerPos位置⽔平偏下downOffset处⼀键复制
编辑
Web IDE
原始数据
mousemove是什么键按⾏查看
历史