HTMLMediaElement: preservesPitch プロパティ

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.

HTMLMediaElement.preservesPitch プロパティは、 HTMLMediaElement.playbackRate の設定で行われた再生速度の変更を補償するために、ブラウザーが音声の音程を調整すべきかどうかを決定します。

値

論理値で、既定値は true です。

例

preservesPitch プロパティの設定

この例には、 <audio> 要素、再生速度を制御する範囲コントロール、preservesPitchを設定するチェックボックスがあります。

音声を再生し、再生速度を調整し、チェックボックスを有効・無効にしてみてください。

html

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

<div>
  <label for="rate">再生レートを調整:</label>
  <input id="rate" type="range" min="0.25" max="3" step="0.05" value="1" />
</div>

<div>
  <label for="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;
});