GamepadHapticActuator: reset()-Methode

Die reset()-Methode der GamepadHapticActuator-Schnittstelle stoppt die Hardware daran, einen aktiven Vibrationseffekt abzuspielen.

Syntax

js
reset()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit "complete" aufgelöst wird, wenn der Effekt erfolgreich zurückgesetzt wurde, oder mit "preempted", wenn der Effekt gestoppt oder durch einen anderen Effekt ersetzt wurde.

Das Promise kann mit den folgenden Ausnahmearten abgelehnt werden:

InvalidStateError DOMException

Das Promise wird mit InvalidStateError abgelehnt, wenn das aktuelle Dokument nicht aktiv oder verborgen ist.

Beispiele

js
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

Spezifikationen

Specification
Gamepad
# dom-gamepadhapticactuator-reset

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch