GamepadHapticActuator:playEffect() 方法

GamepadHapticActuator 接口的 playEffect() 方法使硬件播放特定的振动模式。

语法

js
playEffect(type, params)

参数

type

表示所需效果的字符串。这可能因硬件类型而异,可能的值为 "dual-rumble"(双重隆隆声)或 "vibration"(振动)。

params

描述所需触觉效果的对象。期望值是:

duration

效果的持续时间(以毫秒为单位)。

startDelay

效果开始前的延迟(以毫秒为单位)。

strongMagnitude

低频(强)隆隆声电机的隆隆声强度,标准化为 0.0 到 1.0 之间的范围。

weakMagnitude

高频(弱)隆隆声电机的隆隆声强度,标准化为 0.0 到 1.0 之间的范围。

备注:一个新的 playEffect() 调用会覆盖上一个仍在进行中的调用。

返回值

当 playEffect 成功完成时,返回一个兑现为 true 的 Promise。

示例

js
const gamepad = navigator.getGamepads()[0];

gamepad.vibrationActuator.playEffect("dual-rumble", {
  startDelay: 0,
  duration: 200,
  weakMagnitude: 1.0,
  strongMagnitude: 1.0,
});

规范

Specification
Gamepad
# dom-gamepadhapticactuator-playeffect

浏览器兼容性

BCD tables only load in the browser

参见