HTMLMediaElement : propriété preservesPitch

Baseline 2023

Nouvellement disponible

Depuis December 2023, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La propriété preservesPitch de l'interface HTMLMediaElement détermine si le navigateur doit ou non ajuster la hauteur du son pour compenser les modifications de la vitesse de lecture effectuées en définissant HTMLMediaElement.playbackRate.

Valeur

Une valeur booléenne, par défaut true.

Exemples

Définir la propriété `preservesPitch`

Dans cet exemple, nous avons un élément HTML <audio>, un contrôle de plage qui ajuste la vitesse de lecture, et une case à cocher qui définit preservesPitch.

Essayez de lire l'audio, puis d'ajuster la vitesse de lecture, puis d'activer et de désactiver la case à cocher.

html

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

<div>
  <label for="rate">Ajuster la vitesse de lecture&nbsp;:</label>
  <input id="rate" type="range" min="0.25" max="3" step="0.05" value="1" />
</div>

<div>
  <label for="pitch">Conserver la hauteur&nbsp;:</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;
});