> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameStreamingGamepadPhysicality

> XGameStreamingGamepadPhysicality

# XGameStreamingGamepadPhysicality

標準 XBOX 無線控制器上每個按鈕、搖桿和扳機的實體性對應。對於任何指定的按鈕/搖桿/扳機，實體性可以是未知、實體、虛擬或兩者皆是。

## 語法

```cpp theme={null}
enum class XGameStreamingGamepadPhysicality  : uint64_t  
{  
    None = 0x0000000000000000,  
    DPadUpPhysical = 0x0000000000000001,  
    DPadDownPhysical = 0x0000000000000002,  
    DPadLeftPhysical = 0x0000000000000004,  
    DPadRightPhysical = 0x0000000000000008,  
    MenuPhysical = 0x0000000000000010,  
    ViewPhysical = 0x0000000000000020,  
    LeftThumbstickPhysical = 0x0000000000000040,  
    RightThumbstickPhysical = 0x0000000000000080,  
    LeftShoulderPhysical = 0x0000000000000100,  
    RightShoulderPhysical = 0x0000000000000200,  
    APhysical = 0x0000000000001000,  
    BPhysical = 0x0000000000002000,  
    XPhysical = 0x0000000000004000,  
    YPhysical = 0x0000000000008000,  
    LeftTriggerPhysical = 0x0000000000010000,  
    RightTriggerPhysical = 0x0000000000020000,  
    LeftThumbstickXPhysical = 0x0000000000040000,  
    LeftThumbstickYPhysical = 0x0000000000080000,  
    RightThumbstickXPhysical = 0x0000000000100000,  
    RightThumbstickYPhysical = 0x0000000000200000,  
    ButtonsPhysical = 0x000000000000F3FF,  
    AnalogsPhysical = 0x00000000003F0000,  
    AllPhysical = 0x00000000003FF3FF,  
    DPadUpVirtual = 0x0000000100000000,  
    DPadDownVirtual = 0x0000000200000000,  
    DPadLeftVirtual = 0x0000000400000000,  
    DPadRightVirtual = 0x0000000800000000,  
    MenuVirtual = 0x0000001000000000,  
    ViewVirtual = 0x0000002000000000,  
    LeftThumbstickVirtual = 0x0000004000000000,  
    RightThumbstickVirtual = 0x0000008000000000,  
    LeftShoulderVirtual = 0x0000010000000000,  
    RightShoulderVirtual = 0x0000020000000000,  
    AVirtual = 0x0000100000000000,  
    BVirtual = 0x0000200000000000,  
    XVirtual = 0x0000400000000000,  
    YVirtual = 0x0000800000000000,  
    LeftTriggerVirtual = 0x0001000000000000,  
    RightTriggerVirtual = 0x0002000000000000,  
    LeftThumbstickXVirtual = 0x0004000000000000,  
    LeftThumbstickYVirtual = 0x0008000000000000,  
    RightThumbstickXVirtual = 0x0010000000000000,  
    RightThumbstickYVirtual = 0x0020000000000000,  
    ButtonsVirtual = 0x0000F3FF00000000,  
    AnalogsVirtual = 0x003F000000000000,  
    AllVirtual = 0x003FF3FF00000000,  
}  
```

## 常數

| 常數 | 描述 |
| - | - |
| None | 沒有遊戲台按鈕 |
| DPadUpPhysical | 實體遊戲台方向鍵上按鈕 |
| DPadDownPhysical | 實體遊戲台方向鍵下按鈕 |
| DPadLeftPhysical | 實體遊戲台方向鍵左按鈕 |
| DPadRightPhysical | 實體遊戲台方向鍵右按鈕 |
| MenuPhysical | 實體遊戲台功能表按鈕 |
| ViewPhysical | 實體遊戲台檢視按鈕 |
| LeftThumbstickPhysical | 實體遊戲台左搖桿按壓按鈕 |
| RightThumbstickPhysical | 實體遊戲台右搖桿按壓按鈕 |
| LeftShoulderPhysical | 實體遊戲台左肩按鈕 |
| RightShoulderPhysical | 實體遊戲台右肩按鈕 |
| APhysical | 實體遊戲台 A 按鈕 |
| BPhysical | 實體遊戲台 B 按鈕 |
| XPhysical | 實體遊戲台 X 按鈕 |
| YPhysical | 實體遊戲台 Y 按鈕 |
| LeftTriggerPhysical | 實體遊戲台左扳機 |
| RightTriggerPhysical | 實體遊戲台右扳機 |
| LeftThumbstickXPhysical | 實體遊戲台左搖桿水平位置 |
| LeftThumbstickYPhysical | 實體遊戲台左搖桿垂直位置 |
| RightThumbstickXPhysical | 實體遊戲台右搖桿水平位置 |
| RightThumbstickYPhysical | 實體遊戲台右搖桿垂直位置 |
| ButtonsPhysical | 所有按鈕都是實體的 |
| AnalogsPhysical | 所有類比輸入都是實體的 |
| AllPhysical | 所有輸入都是實體的 |
| DPadUpVirtual | 虛擬遊戲台方向鍵上按鈕 |
| DPadDownVirtual | 虛擬遊戲台方向鍵下按鈕 |
| DPadLeftVirtual | 虛擬遊戲台方向鍵左按鈕 |
| DPadRightVirtual | 虛擬遊戲台方向鍵右按鈕 |
| MenuVirtual | 虛擬遊戲台功能表按鈕 |
| ViewVirtual | 虛擬遊戲台檢視按鈕 |
| LeftThumbstickVirtual | 虛擬遊戲台左搖桿按壓按鈕 |
| RightThumbstickVirtual | 虛擬遊戲台右搖桿按壓按鈕 |
| LeftShoulderVirtual | 虛擬遊戲台左肩按鈕 |
| RightShoulderVirtual | 虛擬遊戲台右肩按鈕 |
| AVirtual | 虛擬遊戲台 A 按鈕 |
| BVirtual | 虛擬遊戲台 B 按鈕 |
| XVirtual | 虛擬遊戲台 X 按鈕 |
| YVirtual | 虛擬遊戲台 Y 按鈕 |
| LeftTriggerVirtual | 虛擬遊戲台左扳機 |
| RightTriggerVirtual | 虛擬遊戲台右扳機 |
| LeftThumbstickXVirtual | 虛擬遊戲台左搖桿水平位置 |
| LeftThumbstickYVirtual | 虛擬遊戲台左搖桿垂直位置 |
| RightThumbstickXVirtual | 虛擬遊戲台右搖桿水平位置 |
| RightThumbstickYVirtual | 虛擬遊戲台右搖桿垂直位置 |
| ButtonsVirtual | 所有按鈕都是虛擬的 |
| AnalogsVirtual | 所有類比輸入都是虛擬的 |
| AllVirtual | 所有輸入都是虛擬的 |

## 備註

遊戲可以使用 [XGameStreamingGamepadPhysicality](/zh-TW/reference/system/xgamestreaming/enums/xgamestreaminggamepadphysicality) 來了解 `IGameInputReading` 是否包含來自實體控制器、虛擬觸控控制器或兩者的輸入。

目前僅支援遊戲台讀數。

旗標可以組合以表示多個值。

值 `AllPhysical` 或 `AllVirtual` 可用來識別所有輸入是否屬於特定類型，以用於做出遊戲玩法決策，例如要向玩家提供哪些視覺提示。

## 需求

**標頭：** xgamestreaming.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XGameStreamingGetGamepadPhysicality](/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality)\
[XGameStreaming](/zh-TW/reference/system/xgamestreaming/xgamestreaming_members)


## Related topics

- [XGameStreamingGamepadPhysicality](/reference/system/xgamestreaming/enums/xgamestreaminggamepadphysicality.md)
- [XGameStreamingGetGamepadPhysicality](/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality.md)