SetRumbleState

设置设备上的四个扳机键马达的所需强度。

语法

void SetRumbleState(  
         const GameInputRumbleParams* params  
)  

参数

params _In_opt_
类型:GameInputRumbleParams*

包含每个扳机键马达的所需强度的结构。 扳机键马达的强度范围是从 0.0 到 1.0。

返回值

类型:void

备注

SetRumbleState 方法可设置设备上四个扳机键马达的所需强度。 与其他类型的反馈相似,这可由一个应用程序在任何时间调用,但将仅在应用程序处于焦点中时应用于设备。

为使事情尽可能简单,应用程序无需查看设备支持哪些扳机键,并且可为所有四个马达指定强度。 如果该设备缺少这四个马达的任何一个,则 GameInput 实现将尝试通过向其他马达添加附加的强度来进行调整,这样,用户仍会感受到某些回馈量。 例如,通过在高频率振动马达中添加少量额外的振动强度,在双电机游戏板上模拟触发振动值。

在已断开连接的设备或没有扳机键马达的设备上,调用 SetRumbleState 方法不起作用。 马达强度值处于 [0.0, 1.0] 的范围内。 处于此范围之外的任何值都固定到最近的有效值。

要求

头文件:GameInput.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

GameInput 概述
GameInputRumbleParams
IGameInputDevice