> ## 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](/reference/input/gameinput/deprecated/enums/gameinputlocation)

触摸传感器在设备上的物理位置。

**locationId**\
类型：uint32\_t

用于区分同一位置上不同触摸传感器的标识符。

**usage**\
类型：GameInputUsage

标识此触摸传感器的 HID 用法。

**shape**\
类型：[GameInputTouchShape](/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 成员](/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate)
[GameInputTouchShape](/reference/input/gameinput/deprecated/enums/gameinputtouchshape)


## Related topics

- [GameInputTouchShape](/zh-CN/reference/input/gameinput/deprecated/enums/gameinputtouchshape.md)
- [GameInputTouchState](/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)
- [GameInput](/zh-CN/reference/input/gameinput/gameinput_members.md)
- [游戏串流自定义分辨率最佳实践](/zh-CN/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices.md)
- [已弃用的 GameInput API 成员](/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)