# 自定義按鍵映射說明

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

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

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

### 通用說明

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

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

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

### 映射類型說明

- switchKey：切換自定義按鍵映射的開關(guān)鍵，默認(rèn)為普通映射，需要使用這個按鍵在普通映射和自定義映射之間切換。

- mouseMoveMap：鼠標(biāo)移動映射，鼠標(biāo)的移動將被映射為以startPos為起點(diǎn)，以鼠標(biāo)移動方向?yàn)橐苿臃较虻氖种竿蟿硬僮鳌?/p>

一般在FPS手游中用來調(diào)整人物視野。

- startPos 手指拖動起始點(diǎn)

- speedRatio 鼠標(biāo)移動映射為手指拖動的比例，可以控制鼠標(biāo)靈敏度

- keyMapNodes 一般按鍵的映射，json數(shù)組，所有一般按鍵映射都放在這個數(shù)組中，將鍵盤的按鍵映射為普通的手指點(diǎn)擊。

一般按鍵映射有如下幾種類型：

- type 按鍵映射的類型，每個keyMapNodes中的元素都需要指明，可以是如下類型：

- KMT_CLICK 普通點(diǎn)擊，鍵盤按下模擬為手指按下，鍵盤抬起映射為手指抬起

- KMT_CLICK_TWICE 兩次點(diǎn)擊，鍵盤按下模擬為手指按下再抬起，鍵盤抬起映射為手指按下再抬起

- KMT_STEER_WHEEL 方向盤映射，專用于FPS游戲中移動人物腳步的方向盤的映射，需要4個按鍵來配合。

不同按鍵映射類型的專有屬性說明：

- KMT_CLICK

- key 要映射的按鍵碼

- pos 模擬觸摸的位置

- switchMap 是否切換按鍵模式，點(diǎn)擊此按鍵后，除了默認(rèn)的模擬觸摸映射，是否附帶切換按鍵映射模式。(可以參考和平精英映射中M地圖映射的效果)

- KMT_CLICK_TWICE

- key 要映射的按鍵碼

- pos 模擬觸摸的位置

- KMT_STEER_WHEEL

- centerPos 方向盤中心點(diǎn)

- leftKey 左方向的按鍵控制

- rightKey 右方向的按鍵控制

- upKey 上方向的按鍵控制

- downKey 下方向的按鍵控制

- leftOffset 按下左方向鍵后模擬拖動到相對centerPos位置水平偏左leftOffset處

- rightOffset 按下右方向鍵后模擬拖動到相對centerPos位置水平偏右rightOffset處

- upOffset 按下上方向鍵后模擬拖動到相對centerPos位置水平偏上upOffset處

- downOffset 按下下方向鍵后模擬拖動到相對centerPos位置水平偏下downOffset處

一鍵復(fù)制

編輯

Web IDE

原始數(shù)據(jù)

按行查看

歷史

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。