HTMLMediaElement: preservesPitch 属性

基线 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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅