# 自定義按鍵映射說明

按鍵映射文件為json格式，新增自己的按鍵映射文件需要放在keymap目錄中才可以被QtScrcpy識別。

按鍵映射文件的具體編寫格式下面會介紹，也可以參考自帶的按鍵映射文件。

## 按鍵映射腳本格式說明

### 通用說明

- 按鍵映射中的坐標位置都是用相對位置表示的，屏幕的寬高都用1表示，例如屏幕的像素為1920x1080，那么坐標(0.5,0.5)則表示的是

以屏幕左上角為原點，像素坐標(1920,1080)*(0.5,0.5)=(960,540)的位置。

- 按鍵映射中的按鍵碼是用Qt的枚舉表示的，詳細說明可以[參考Qt文檔](https://doc-snapshots.qt.io/4.8/qt.html)(搜索 The key names used by Qt. 可以快速定位)。

### 映射類型說明

- 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

原始數據

按行查看

歷史

總結

以上是生活随笔為你收集整理的qtscrcpy自定义按键_按键映射说明.md的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。