SpeechSynthesisUtterance: pitch-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2018.

Die pitch-Eigenschaft der SpeechSynthesisUtterance-Schnittstelle erhält und setzt die Tonhöhe, mit der die Äußerung gesprochen wird.

Wenn nicht gesetzt, wird ein Standardwert von 1 verwendet.

Wert

Ein Float, der den Tonhöhenwert darstellt. Er kann zwischen 0 (niedrigste) und 2 (höchste) liegen, wobei 1 die Standardtonhöhe für die aktuelle Plattform oder Stimme ist. Einige Sprachausgabe-Engines oder Stimmen können die minimalen und maximalen Raten weiter einschränken. Wenn SSML verwendet wird, wird dieser Wert durch Prosodie-Tags im Markup überschrieben.

Beispiele

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

Spezifikationen

Specification
Web Speech API
# dom-speechsynthesisutterance-pitch

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch