SpeechSynthesisUtterance
========================

**Экспериментальная возможность:** **Это экспериментальная технология**  
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

The **`SpeechSynthesisUtterance`** interface of the Web Speech API represents a speech request. It contains the content the speech service should read and information about how to read it (e.g. language, pitch and volume.)

Конструктор
-----------

`SpeechSynthesisUtterance.SpeechSynthesisUtterance()` (en-US)

Возвращает новый экземпляр объекта `SpeechSynthesisUtterance`

Свойства
--------

*`SpeechSynthesisUtterance` ещё наследует свойства из его своего родительского интерфейса `EventTarget`.*

`SpeechSynthesisUtterance.lang` (en-US)

Получает и устанавливает язык высказывания.

`SpeechSynthesisUtterance.pitch` (en-US)

Получает и устанавливает высоту, на которой произносится высказывание

`SpeechSynthesisUtterance.rate` (en-US)

Получает и устанавливает скорость, с которой будет произноситься высказывание.

`SpeechSynthesisUtterance.text` (en-US)

Получает и устанавливает текст, который будет синтезироваться при произнесении высказывания.

`SpeechSynthesisUtterance.voice` (en-US)

Получает и устанавливает голос, который будет использоваться для произнесения речи.

`SpeechSynthesisUtterance.volume` (en-US)

Получает и устанавливает громкость, на котором будет произноситься высказывание.

### Обработчики событий

`SpeechSynthesisUtterance.onboundary` (en-US)

Срабатывает, когда произнесённое высказывание достигает границы слова или предложения.

`SpeechSynthesisUtterance.onend` (en-US)

Срабатывает, когда произнесение произнесено.

`SpeechSynthesisUtterance.onerror` (en-US)

Срабатывает, когда возникает ошибка, которая препятствует успешному произнесению высказывания.

`SpeechSynthesisUtterance.onmark` (en-US)

Срабатывает, когда произнесённое высказывание достигает названного тега метки «SSML».

`SpeechSynthesisUtterance.onpause` (en-US)

Срабатывает, когда высказывание приостановлено.

`SpeechSynthesisUtterance.onresume` (en-US)

Срабатывает, когда приостановленное высказывание возобновляется.

`SpeechSynthesisUtterance.onstart` (en-US)

Срабатывает, когда произнесение произнесено.

Examples
--------

В нашей базовой Демо-версия синтезатора речи, мы сначала получаем ссылку на контроллер SpeechSynthesis, используя `window.speechSynthesis`. После определения некоторых необходимых переменных мы получаем список доступных голосов, используя `SpeechSynthesis.getVoices()` (en-US), и заполнить меню выбора с ними, чтобы пользователь мог выбрать, какой голос он хочет.

Внутри обработчика `inputForm.onsubmit` мы останавливаем отправку формы с помощью preventDefault(), используйте `constructor` (en-US) для создания нового экземпляра высказывания, содержащего текст из текста `<input>`, установите `voice` (en-US)на голос, выбранный в элементе `<select>` и начните высказывание через `SpeechSynthesis.speak()` (en-US) метод.


```js
var synth = window.speechSynthesis;

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

var voices = synth.getVoices();

for (i = 0; i < voices.length; i++) {
  var option = document.createElement("option");
  option.textContent = voices[i].name + " (" + voices[i].lang + ")";
  option.setAttribute("data-lang", voices[i].lang);
  option.setAttribute("data-name", voices[i].name);
  voiceSelect.appendChild(option);
}

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

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

Specifications
--------------

| Specification |
| --- |
| Web Speech API # speechsynthesisutterance |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* Web Speech API