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

# GameInputMotionState

> GameInputMotionState

# GameInputMotionState

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

描述来自输入读数的当前加速计、陀螺仪和磁力计状态。

## 语法

```cpp theme={null}
typedef struct GameInputMotionState {
    float accelerationX;
    float accelerationY;
    float accelerationZ;
    float angularVelocityX;
    float angularVelocityY;
    float angularVelocityZ;
    float magneticFieldX;
    float magneticFieldY;
    float magneticFieldZ;
} GameInputMotionState;
```

## 成员

**accelerationX, accelerationY, accelerationZ**\
类型：float

各轴上测得的线性加速度（单位：m/s²）。

**angularVelocityX, angularVelocityY, angularVelocityZ**\
类型：float

各轴上测得的角速度（单位：度/秒）。

**magneticFieldX, magneticFieldY, magneticFieldZ**\
类型：float

各轴上测得的磁场强度（单位：高斯）。

## 备注

此结构曾由已弃用的 [IGameInputReading::GetMotionState](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getmotionstate) 方法返回。两者均已在 v1 中移除。

## 版本历史

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

## 另请参阅

[已弃用的 GameInput API 成员](/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[IGameInputReading::GetMotionState](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getmotionstate)
[GameInputMotionInfo](/reference/input/gameinput/deprecated/structs/gameinputmotioninfo)


## Related topics

- [IGameInputReading::GetMotionState](/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getmotionstate.md)
- [GameInputMotionInfo](/zh-CN/reference/input/gameinput/deprecated/structs/gameinputmotioninfo.md)
- [GameInputMotionAccuracy](/zh-CN/reference/input/gameinput/deprecated/enums/gameinputmotionaccuracy.md)
- [GameInput](/zh-CN/reference/input/gameinput/gameinput_members.md)
- [已弃用的 GameInput API 成员](/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
