描述轴如何映射到控制器。
语法
struct GameInputAxisMapping {
GameInputElementKind controllerElementKind;
uint32_t controllerIndex;
// When axis is mapped from a axis
bool isInverted;
// When the axis is mapped from a button
bool fromTwoButtons;
uint32_t buttonMinIndexValue;
// When the axis is mapped from a switch
GameInputSwitchPosition referenceDirection;
};
成员
controllerElementKind
类型: GameInputElementKind
从中映射轴的控制器元素的类型。
controllerIndex
类型:uint32_t
从中映射轴的控制器元素的索引。 索引从零开始,相对于同一类型的其他元素。 无论轴是从另一个轴、按钮还是从开关映射,此索引都相关。
isInverted
类型:bool 指示轴是否反转。 例如,如果给定的值范围为 [0 - 1],其中 0 为中性,1 为完全位移,则预期 1 代表中性位置,0 表示完全位移,值介于倒置之间。 仅当轴从另一个轴映射时,此成员才有效。
fromTwoButtons
类型:bool
指示轴是否从两个按钮映射。 仅当轴从按钮映射时,此成员才有效。 如果为 true,则索引字段为按钮最大值,buttonMinIndexValue 字段为按钮最小值。
buttonMinIndexValue
类型:uint32_t
表示轴最小值的按钮的索引。 索引从零开始。 仅当轴从两个按钮映射时,此成员才有效。
referenceDirection
类型:GameInputSwitchPosition
表示轴正方向的开关位置。 参考位置应映射到轴值 1.0 ,与轴值 0.0相反的方向。 值之间的 值可能不同。 如果考虑相邻,则直接相邻也应映射到 1.0,并且将值后映射到 0.5,如果未考虑这些邻接,则除相反方向之外的所有非引用位置都将映射到 0.5。 仅当轴从开关映射时,此成员才有效。
备注
此映射信息共享设备或协议提供的内部信息,说明它预期如何为给定输入进行解释。 在某些情况下,我们不会共享此信息的全部信息,而是共享与为给定输入生成映射最相关的内容。
对于轴,我们允许从轴、按钮或开关映射这些对象。 哪个输入是源由 controllerElementKind 提供。 对于所有源元素类型,源输入的索引由 controllerIndex 提供。 然后,可以根据 controllerElementKind 值将此索引与控制器轴、按钮或开关一起使用。
要求
头文件:GameInput.h
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机