SpeechSynthesisUtterance：volume 属性

基线广泛可用

此功能已稳定，可在许多设备和浏览器版本上运行。它自以下时间起在浏览器中可用： 2018 年 9 月.

volume 属性是 SpeechSynthesisUtterance 接口的一部分，用于获取和设置语音输出的音量。

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

值

一个浮点数，表示音量值，介于 0（最低）和 1（最高）之间。

如果使用了 SSML，则此值将被标记中的韵律标签覆盖。

示例

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.volume = 0.5;
  synth.speak(utterThis);
  inputTxt.blur();
};

规范

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

浏览器兼容性

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

另请参阅

Web 语音 API