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

# GameInputTouchState

> GameInputTouchState

# GameInputTouchState

<Warning>**已弃用。** 此结构在 GameInput v1 中被移除，当前 API 中不再提供。</Warning>

描述输入读数中单个触摸接触点的状态。

## 语法

```cpp theme={null}
typedef struct GameInputTouchState {
    uint64_t touchId;
    uint32_t sensorIndex;
    float positionX;
    float positionY;
    float pressure;
    float proximity;
    float contactRectTop;
    float contactRectLeft;
    float contactRectRight;
    float contactRectBottom;
} GameInputTouchState;
```

## 成员

**touchId**\
类型：uint64\_t

此触摸接触点的唯一标识符，可跨读数进行跟踪。

**sensorIndex**\
类型：uint32\_t

产生此接触的触摸传感器的索引。

**positionX, positionY**\
类型：float

接触点在传感器表面上的归一化位置，范围为 \[0.0, 1.0]。

**pressure**\
类型：float

接触点的归一化压力，范围为 \[0.0, 1.0]。

**proximity**\
类型：float

接触点的归一化接近度，范围为 \[0.0, 1.0]。

**contactRectTop, contactRectLeft, contactRectRight, contactRectBottom**\
类型：float

接触区域在传感器表面上的边界矩形，采用归一化坐标。

## 备注

此结构通过已弃用的 [IGameInputReading::GetTouchState](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate) 方法读取。两者均已在 v1 中被移除。

## 版本历史

| 版本     | 变更   |
| ------ | ---- |
| **v1** | 已移除。 |
| **v0** | 引入。  |

## 另请参阅

[已弃用的 GameInput API 成员](/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[IGameInputReading::GetTouchState](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchstate)
[IGameInputReading::GetTouchCount](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount)
[GameInputTouchSensorInfo](/reference/input/gameinput/deprecated/structs/gameinputtouchsensorinfo)