Skip to main content

GameInputGamepadInfo

描述遊戲台的屬性。

語法

成員

supportedLayout
類型:GameInputGamepadButtons
描述遊戲台的配置。由於軸具有按鈕轉譯,因此可以用來判斷遊戲台上有哪些軸。 menuButtonLabel
類型:GameInputLabel
功能表按鈕的實體標籤。 viewButtonLabel
類型:GameInputLabel
檢視按鈕的實體標籤。 aButtonLabel
類型:GameInputLabel
A 按鈕的實體標籤。 bButtonLabel
類型:GameInputLabel
B 按鈕的實體標籤。 cButtonLabel
類型:GameInputLabel
C 按鈕的實體標籤。 xButtonLabel
類型:GameInputLabel
X 按鈕的實體標籤。 yButtonLabel
類型:GameInputLabel
Y 按鈕的實體標籤。 zButtonLabel
類型:GameInputLabel
Z 按鈕的實體標籤。 dpadUpLabel
類型:GameInputLabel
方向鍵上的實體標籤。 dpadDownLabel
類型:GameInputLabel
方向鍵下的實體標籤。 dpadLeftLabel
類型:GameInputLabel
方向鍵左的實體標籤。 dpadRightLabel
類型:GameInputLabel
方向鍵右的實體標籤。 leftShoulderButtonLabel
類型:GameInputLabel
左肩按鈕的實體標籤。 rightShoulderButtonLabel
類型:GameInputLabel
右肩按鈕的實體標籤。 leftThumbstickButtonLabel
類型:GameInputLabel
左搖桿的實體標籤。 rightThumbstickButtonLabel
類型:GameInputLabel
右搖桿的實體標籤。 extraButtonCount
類型:uint32_t
未對應到遊戲台按鈕的裝置按鈕數目。 extraAxisCount
類型:uint32_t
未對應到遊戲台軸的裝置軸數目。

備註

此結構用於 GameInputDeviceInfo 結構中。 GameInputDeviceInfo 由 IGameInputDevice::GetDeviceInfo 方法使用。 如需詳細資訊,請參閱 GameInput 裝置。

遊戲台配置

GameInput 支援各種遊戲台外型規格,而不是僅限於單一標準配置。這是透過此結構的 supportedLayout 成員公開,其為 GameInputGamepadButtons 類型的位元欄位。軸也會透過軸到按鈕的轉譯 (例如 GameInputGamepadLeftTriggerButton) 出現在此列舉中。如需這些轉譯的詳細資訊,請參閱 GameInputGamepadButtons。 遊戲台沒有最低必要配置,它可以具有支援之軸和按鈕的任意組合。任何不受支援的按鈕或軸都應保留下來,並以額外軸或按鈕的形式存取。 我們已將一些常見的遊戲台元素群組和常見配置定義為常數。這些常數可用來快速識別常見配置、篩選特定輸入,或建立自訂配置。如需詳細資訊,請參閱 GameInputGamepadButtons。 由於支援的配置和外型規格範圍沒有限制,因此我們期望對應和遊戲台使用者遵循一小組考量和行為:
  • 對於成對的元素 (例如搖桿、肩部按鈕或扳機),如果中央只有一個,則預設應將其視為左側元素。如果它位於裝置的左側或右側,則應據此對應。
  • 為了避免因不同圖示而造成混淆,正面按鈕應依其實體位置對應和讀取,而不論其圖示為何,如下所示:
遊戲台正面按鈕配置指導方針 下列程式碼範例示範如何判斷遊戲台是否支援某個配置或特定輸入或模組。
下列程式碼範例示範如何建立自訂配置,並判斷遊戲台是否支援該配置。

需求

標頭: GameInput.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

GameInput 概觀
GameInput

版本歷程記錄

附錄:先前版本

v0、v1、v2

Last modified on October 6, 2026