GamepadHapticActuator: reset() 方法

reset() 方法是 GamepadHapticActuator 接口的一部分，用于停止硬件播放活动的振动效果。

语法

reset()

参数

无。

返回值

一个 Promise，如果效果成功重置，则解析为 "complete"，如果效果被停止或被其他效果替换，则解析为 "preempted"。

该 Promise 可能因以下异常类型而被拒绝

InvalidStateError DOMException: 如果当前文档未激活或处于隐藏状态，则 Promise 会因 InvalidStateError 而被拒绝。

示例

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

setTimeout(() => {
  gamepad.vibrationActuator.reset();
}, 150);

gamepad.vibrationActuator
  .playEffect("dual-rumble", {
    startDelay: 0,
    duration: 200,
    weakMagnitude: 1.0,
    strongMagnitude: 1.0,
  })
  .then((result) => console.log(result));
// Should log "preempted" because reset() will run before the effect ends

规范

规范
Gamepad # dom-gamepadhapticactuator-reset

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

Gamepad API