SpeechRecognition

Интерфейс SpeechRecognition API речи веб-приложений — это интерфейс-контроллер для сервиса распознавания; он также обрабатывает событие SpeechRecognitionEvent, отправленное сервисом распознавания.

SpeechRecognition()

Создаёт новый объект SpeechRecognition.

SpeechRecognition также наследует свойства от родительского интерфейса, EventTarget.

SpeechRecognition.grammars

Возвращает и задаёт коллекцию объектов SpeechGrammar, представляющих грамматики, которые будет понимать текущий SpeechRecognition.

SpeechRecognition.lang

Возвращает и задаёт язык текущего SpeechRecognition. Если не указан, по умолчанию используется значение атрибута HTML lang, или язык пользователя, если он не задан.

SpeechRecognition.continuous

Управляет тем, возвращаются ли непрерывные результаты для каждого распознавания, или только один результат. По умолчанию — один (false).

SpeechRecognition.interimResults

Управляет тем, должны ли возвращаться промежуточные результаты (true) или нет (false). Промежуточные результаты — это результаты, которые ещё не окончательные (например, свойство SpeechRecognitionResult.isFinal имеет значение false).

SpeechRecognition.maxAlternatives

Задает максимальное количество SpeechRecognitionAlternative на результат. Значение по умолчанию — 1.

SpeechRecognition также наследует методы от родительского интерфейса, EventTarget.

SpeechRecognition.abort()

Останавливает службу распознавания речи от прослушивания входящего аудио, и не пытается вернуть SpeechRecognitionResult.

SpeechRecognition.start()

Запускает службу распознавания речи, прослушивая входящий аудиосигнал с целью распознать грамматики, связанные с текущим SpeechRecognition.

SpeechRecognition.stop()

Останавливает службу распознавания речи от прослушивания входящего аудио, и пытается вернуть SpeechRecognitionResult с использованием захваченного аудио.

Подключайтесь к этим событиям с помощью addEventListener() или назначив обработчик событий свойству oneventname этого интерфейса.

audiostart

Срабатывает, когда пользовательский агент начал захват аудио. Также доступно через свойство onaudiostart.

audioend

Срабатывает, когда пользовательский агент завершил захват аудио. Также доступно через свойство onaudioend.

end

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

error

Срабатывает при возникновении ошибки распознавания речи. Также доступно через свойство onerror.

nomatch

Срабатывает, когда служба распознавания речи возвращает окончательный результат без значимого распознавания. Это может включать некоторую степень распознавания, которая не соответствует или не превышает порог confidence. Также доступно через свойство onnomatch.

result

Срабатывает, когда служба распознавания речи возвращает результат — слово или фраза были распознаны положительно, и это было сообщено приложению. Также доступно через свойство onresult.

soundstart

Срабатывает, когда был обнаружен любой звук — распознаваемая речь или нет. Также доступно через свойство onsoundstart.

soundend

Срабатывает, когда обнаружение любого звука — распознаваемой речи или нет — прекратилось. Также доступно через свойство onsoundend.

speechstart

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

speechend

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

start

Срабатывает, когда служба распознавания речи начала прослушивать входящий аудиосигнал с целью распознать грамматики, связанные с текущим SpeechRecognition . Также доступно через свойство onstart.

В нашем простом примере изменения цвета при речи мы создаём новый экземпляр объекта SpeechRecognition с помощью конструктора SpeechRecognition(), создаём новый SpeechGrammarList и устанавливаем его в качестве грамматики, которая будет распознаваться экземпляром SpeechRecognition с помощью свойства SpeechRecognition.grammars.

После определения других значений, мы устанавливаем распознавание так, чтобы оно запускалось при событии клика (см. SpeechRecognition.start()). Когда результат успешно распознан, срабатывает событие result, мы извлекаем цвет, который был произнесён из объекта события, а затем устанавливаем цвет фона элемента <html> на этот цвет.

const grammar =
  "#JSGF V1.0; grammar colors; public <color> = aqua | azure | beige | bisque | black | blue | brown | chocolate | coral | crimson | cyan | fuchsia | ghostwhite | gold | goldenrod | gray | green | indigo | ivory | khaki | lavender | lime | linen | magenta | maroon | moccasin | navy | olive | orange | orchid | peru | pink | plum | purple | red | salmon | sienna | silver | snow | tan | teal | thistle | tomato | turquoise | violet | white | yellow ;";
const recognition = new SpeechRecognition();
const speechRecognitionList = new SpeechGrammarList();
speechRecognitionList.addFromString(grammar, 1);
recognition.grammars = speechRecognitionList;
recognition.continuous = false;
recognition.lang = "en-US";
recognition.interimResults = false;
recognition.maxAlternatives = 1;

const diagnostic = document.querySelector(".output");
const bg = document.querySelector("html");

document.body.onclick = () => {
  recognition.start();
  console.log("Ready to receive a color command.");
};

recognition.onresult = (event) => {
  const color = event.results[0][0].transcript;
  diagnostic.textContent = `Result received: ${color}`;
  bg.style.backgroundColor = color;
};

• Web Speech API