GamepadHapticActuator: reset()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Syntax

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

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

Gamepad API