SpeechSynthesisUtterance:pitch 属性

基线 广泛可用

此功能已经成熟,并且可以在许多设备和浏览器版本上运行。它自以下时间起在浏览器中可用 2018 年 9 月.

pitch 属性是 SpeechSynthesisUtterance 接口的一部分,用于获取和设置语音朗读时的音调。

如果未设置,则将使用默认值 1。

表示音调值的浮点数。其取值范围为 0(最低)到 2(最高),其中 1 为当前平台或语音的默认音调。某些语音合成引擎或语音可能会进一步限制最小和最大速率。如果使用 SSML,则此值将被标记中的 韵律标签 覆盖。

示例

js
const synth = window.speechSynthesis;

const inputForm = document.querySelector("form");
const inputTxt = document.querySelector("input");
const voiceSelect = document.querySelector("select");

const voices = synth.getVoices();

// ...

inputForm.onsubmit = (event) => {
  event.preventDefault();

  const utterThis = new SpeechSynthesisUtterance(inputTxt.value);
  const selectedOption =
    voiceSelect.selectedOptions[0].getAttribute("data-name");
  for (let i = 0; i < voices.length; i++) {
    if (voices[i].name === selectedOption) {
      utterThis.voice = voices[i];
    }
  }
  utterThis.pitch = 1.5;
  synth.speak(utterThis);
  inputTxt.blur();
};

规范

规范
Web 语音 API
# dom-speechsynthesisutterance-pitch

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅