> ## 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.

# GameInputTouchSensorInfo

> GameInputTouchSensorInfo

# GameInputTouchSensorInfo

<Warning>**已淘汰。** 此結構已在 GameInput v1 中移除，目前的 API 中無法使用。</Warning>

描述輸入裝置上觸控感應器的實體屬性和功能。

## 語法

```cpp theme={null}
typedef struct GameInputTouchSensorInfo {
    GameInputLocation location;
    uint32_t locationId;
    GameInputUsage usage;
    GameInputTouchShape shape;
    float aspectRatio;
    float orientation;
    float physicalWidth;
    float physicalHeight;
    float maxPressure;
    float maxProximity;
    uint32_t maxTouchPoints;
} GameInputTouchSensorInfo;
```

## 成員

**location**\
類型：[GameInputLocation](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputlocation)

觸控感應器在裝置上的實體位置。

**locationId**\
類型：uint32\_t

用來區分位於相同位置之各觸控感應器的識別碼。

**usage**\
類型：GameInputUsage

識別此觸控感應器的 HID 用法。

**shape**\
類型：[GameInputTouchShape](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputtouchshape)

觸控感應器表面的形狀。

**aspectRatio**\
類型：float

觸控表面的寬高比。

**orientation**\
類型：float

觸控表面的方向，單位為度。

**physicalWidth**\
類型：float

觸控表面的實體寬度，單位為公尺。

**physicalHeight**\
類型：float

觸控表面的實體高度，單位為公尺。

**maxPressure**\
類型：float

感應器可回報的最大壓力值。

**maxProximity**\
類型：float

感應器可偵測的最大接近距離。

**maxTouchPoints**\
類型：uint32\_t

同時觸控接觸點的最大數目。

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | 已移除。 |
| **v0** | 推出。 |

## 另請參閱

[已淘汰的 GameInput API 成員](/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[GameInputTouchState](/zh-TW/reference/input/gameinput/deprecated/structs/gameinputtouchstate)
[GameInputTouchShape](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputtouchshape)


## Related topics

- [GameInputTouchSensorInfo](/reference/input/gameinput/deprecated/structs/gameinputtouchsensorinfo.md)
- [GameInputTouchShape](/reference/input/gameinput/deprecated/enums/gameinputtouchshape.md)