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 bestimmt, ob der Browser die Tonhöhe des Audios anpassen sollte, um Veränderungen der Wiedergabegeschwindigkeit, die durch das Setzen von HTMLMediaElement.playbackRate vorgenommen wurden, auszugleichen.

Wert

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

Beispiele

Setzen der preservesPitch-Eigenschaft

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

Versuchen Sie, das Audio abzuspielen, dann die Wiedergabegeschwindigkeit anzupassen und anschließend 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>

div {
  margin: 0.5rem 0;
}

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 Standard # dom-media-preservespitch-dev

Browser-Kompatibilität

BCD tables only load in the browser