HTMLMediaElement : propriété preservesPitch

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis décembre 2023.

En savoir plus
Voir la compatibilité complète

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;
});