HTMLMediaElement: preservesPitch 屬性

Baseline 2023
新推出

自 ⁨2023 年 12 月⁩起,此功能可在最新的裝置和瀏覽器版本上使用。此功能可能無法在較舊的裝置或瀏覽器上使用。

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

規範

規範
HTML
# dom-media-preservespitch-dev

瀏覽器相容性

另見