检索描述动作输入的状态的输入读取的视图。
语法
bool GetMotionState(
GameInputMotionState* state
)
参数
state _Out_
类型:GameInputMotionState*
作为动作输入的解释。
返回值
类型:bool
尚未实现此函数。 目前返回 false。
实现后,在成功解释某一动作输入后将返回 true。 在尝试读取未识别为动作输入的输入时返回 false。
备注
GetMotionState 方法从游戏控制器检索 3DoF 动作传感器状态,该状态是在单个 GameInputMotionState 结构中返回的。 此结构包含原始未筛选的加速计、陀螺仪和磁力计传感器数据,这些数据线性规范化到范围 [0.0, 1.0]。 (方法可用于 IGameInputDevice 接口,以便获取有关未规范化的最小/最大值信息)。
GameInputMotionState 结构还包含表示设备方向的方向矢量(采用四元数形式)。 如果方向数据具有嵌入式传感器融合引擎,则其来自硬件,否则,它是由 GameInput 实现自己的传感器融合代码计算得出的。 默认情况下,所有方向轴的引用框架均是设备定义的。 如果磁力计可用,则方向的 X/Y 轴是相对于磁北而言的。 如果加速计和陀螺仪都可用,则方向的 Z 轴是相对于重力而言的。
调用 IGameInputReading::GetInputKind 方法以查看哪些 Get*State 函数将返回某些 IGameInputReading 的有效解读。 每个 Get*State 函数在 IGameInputReading::GetInputKind 枚举中都有对应的条目。 如果您在未设置相应的 IGameInputReading::GetInputKind 标志时尝试调用 Get*State 函数,则该函数将返回静态默认值以及一个 false 返回值。
要求
头文件:GameInput.h
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机