Skip to main content

GameInputButtonMapping

描述按鈕如何對應至控制器。

語法

成員

controllerElementKind
類型:GameInputElementKind
按鈕所對應之來源控制器元素的種類。 controllerIndex
類型:uint32_t
按鈕所對應之來源控制器元素的索引。此索引以零為起始,且相對於相同種類的其他元素。無論按鈕是從軸、另一個按鈕或開關對應而來,此索引都適用。 isInverted
類型:bool
表示軸值在轉換為按鈕值之前是否會反轉。例如,如果軸提供的值範圍是 [0 - 1],其中 0 為未按下、1 為按下,則 1 應代表未按下、0 代表按下。只有當按鈕是從軸對應而來時,此成員才有效。 switchPosition
類型:GameInputSwitchPosition
按鈕所對應之來源開關的位置。當指定開關在此開關位置上被按下時,按鈕即視為已按下。只有當按鈕是從開關對應而來時,此成員才有效。

備註

此對應資訊會分享由裝置或通訊協定所提供的內部資訊,說明其預期針對指定輸入如何被解譯。在某些情況下,我們不會分享這些資訊的全部內容,而是分享與產生指定輸入之對應最相關的資訊。 對於按鈕,我們允許從軸、另一個按鈕或開關進行對應。來源輸入由 controllerElementKind 指定。對於所有來源元素種類,來源輸入的索引由 controllerIndex 指定。接著可根據 controllerElementKind 值,將此索引與控制器的軸、按鈕或開關搭配使用。

另請參閱

GameInput 概觀
GameInput

版本歷程記錄

Last modified on October 6, 2026