SpeechSynthesisUtterance: rate-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 rate-Eigenschaft der Schnittstelle SpeechSynthesisUtterance ruft die Geschwindigkeit ab, mit der die Äußerung gesprochen wird, und setzt diese.

Falls nicht gesetzt, wird ein Standardwert von 1 verwendet.

Wert

Ein Float-Wert, der den Geschwindigkeitswert darstellt. Er kann zwischen 0.1 (niedrigster) und 10 (höchster) liegen, wobei 1 der Standardwert für die aktuelle Plattform oder Stimme ist, was einer normalen Sprechgeschwindigkeit entsprechen sollte. Andere Werte wirken als Prozentsatz relativ dazu, sodass zum Beispiel 2 doppelt so schnell ist, 0.5 halb so schnell ist usw.

Einige Sprachsynthesemaschinen oder Stimmen können die minimalen und maximalen Raten weiter einschränken. Wenn SSML verwendet wird, wird dieser Wert von Prosody-Tags im Markup überschrieben.

Beispiele

Anpassung der Wiedergabegeschwindigkeit

In diesem Beispiel können wir die Wiedergabegeschwindigkeit mit dem Schieberegler anpassen und dann die Äußerung mit der Schaltfläche „Abspielen“ wiedergeben.

HTML

html

<p id="text">It was a dark and stormy night.</p>

<div id="rate-control">
  <label for="rate">Rate:</label>
  <input type="range" min="0.5" max="2" value="1" step="0.1" id="rate" />
</div>

<button id="play">Play</button>

CSS

css

body {
  font-family: sans-serif;
}

#rate-control {
  display: flex;
  align-items: center;
  gap: 1rem;
  margin: 1rem 0;
}

JavaScript

const synth = window.speechSynthesis;

const text = document.querySelector("#text");
const play = document.querySelector("#play");
const rate = document.querySelector("#rate");

function speak() {
  if (synth.speaking) {
    synth.cancel();
  }
  const utterThis = new SpeechSynthesisUtterance(text.textContent);
  utterThis.addEventListener("error", () => {
    console.error("SpeechSynthesisUtterance error");
  });
  utterThis.rate = rate.value;
  synth.speak(utterThis);
}

play.addEventListener("click", speak);

Ausgabe

Spezifikationen

Specification
Web Speech API # dom-speechsynthesisutterance-rate

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Web Speech API