HTMLMediaElement: preservesPitch-Eigenschaft

Baseline 2023
Newly available

Since December 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die HTMLMediaElement.preservesPitch-Eigenschaft legt fest, ob der Browser die Tonhöhe des Audios anpassen sollte, um Änderungen der Wiedergabegeschwindigkeit, vorgenommen durch das Setzen von HTMLMediaElement.playbackRate, auszugleichen.

Wert

Ein boolescher Wert, der standardmäßig auf true gesetzt ist.

Beispiele

Festlegen der preservesPitch-Eigenschaft

In diesem Beispiel haben wir ein <audio>-Element, ein Bereichssteuerungselement, das die Wiedergabegeschwindigkeit anpasst, und ein Kontrollkästchen, das preservesPitch festlegt.

Versuchen Sie, das Audio abzuspielen, dann die Wiedergabegeschwindigkeit anzupassen und das Kontrollkästchen zu aktivieren und zu deaktivieren.

html
<audio
  controls
  src="https://mdn.github.io/webaudio-examples/audio-basics/outfoxing.mp3"></audio>

<div>
  <label for="rate">Adjust playback rate:</label>
  <input id="rate" type="range" min="0.25" max="3" step="0.05" value="1" />
</div>

<div>
  <label for="pitch">Preserve pitch:</label>
  <input type="checkbox" id="pitch" name="pitch" checked />
</div>
js
const audio = document.querySelector("audio");
document.getElementById("rate").addEventListener("change", (e) => {
  audio.playbackRate = e.target.value;
});
document.getElementById("pitch").addEventListener("change", (e) => {
  audio.preservesPitch = e.target.checked;
});

Spezifikationen

Specification
HTML
# dom-media-preservespitch-dev

Browser-Kompatibilität

Siehe auch