хром.ттс

Описание

Chrome предоставляет эту возможность в Windows (с использованием SAPI 5), Mac OS X и ChromeOS, используя возможности синтеза речи, предоставляемые операционной системой. На всех платформах пользователь может установить расширения, которые регистрируются как альтернативные речевые движки.

Разрешения

Концепции и использование

Генерировать речь

Вызовите функцию speak() из вашего расширения, чтобы озвучить сообщение. Например:

chrome.tts.speak('Hello, world.'); 

Чтобы немедленно прекратить говорить, просто вызовите stop() :

chrome.tts.stop(); 

Вы можете предоставить параметры, управляющие различными свойствами речи, такими как её темп, тон и т. д. Например:

chrome.tts.speak('Hello, world.', {'rate': 2.0}); 

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

chrome.tts.speak('Hello, world.', {'lang': 'en-US', 'rate': 2.0}); 

По умолчанию каждый вызов speak() прерывает текущую речь и немедленно произносит её. Чтобы определить, прерывает ли вызов что-либо, можно вызвать isSpeaking() . Кроме того, можно использовать параметр enqueue , чтобы добавить данное высказывание в очередь высказываний, которые будут произнесены после завершения текущего.

chrome.tts.speak('Speak this first.'); chrome.tts.speak(     'Speak this next, when the first sentence is done.', {'enqueue': true}); 

Полное описание всех параметров можно найти в разделе tts.speak() . Не все речевые движки поддерживают все параметры.

Чтобы перехватывать ошибки и убедиться, что функция speak() вызывается корректно, передайте функцию обратного вызова без аргументов. Внутри функции обратного вызова проверьте runtime.lastError на наличие ошибок.

chrome.tts.speak(   utterance,   options,   function() {     if (chrome.runtime.lastError) {       console.log('Error: ' + chrome.runtime.lastError.message);     }   } ); 

Функция обратного вызова возвращается немедленно, до того, как движок начал генерировать речь. Цель функции обратного вызова — предупредить вас о синтаксических ошибках при использовании TTS API, а не перехватывать все возможные ошибки, которые могут возникнуть в процессе синтеза и вывода речи. Для перехвата этих ошибок необходимо использовать прослушиватель событий, описанный в следующем разделе.

Слушайте события

Чтобы получить больше информации в режиме реального времени о состоянии синтезированной речи, передайте прослушиватель событий в параметрах speak() , например:

chrome.tts.speak(   utterance,   {     onEvent: function(event) {       console.log('Event ' + event.type + ' at position ' + event.charIndex);       if (event.type == 'error') {         console.log('Error: ' + event.errorMessage);       }     }   },   callback ); 

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

• 'start' : двигатель начал произносить фразу.
• 'word' : достигнута граница слова. Используйте event.charIndex для определения текущей позиции речи.
• 'sentence' : достигнута граница предложения. Используйте event.charIndex для определения текущей позиции речи.
• 'marker' : Достигнут маркер SSML. Используйте event.charIndex для определения текущей позиции речи.
• 'end' : Движок завершил произношение фразы.
• 'interrupted' : это высказывание было прервано другим вызовом speak() или stop() и не было завершено.
• 'cancelled' : это высказывание было поставлено в очередь, но затем отменено другим вызовом speak() или stop() и так и не началось.
• 'error' : произошла ошибка, связанная с движком, и это высказывание невозможно произнести. Подробности см. в event.errorMessage .

Четыре типа событий — 'end' , 'interrupted' , 'cancelled' и 'error' являются окончательными . После получения одного из этих событий данное высказывание больше не будет звучать, и новые события из этого высказывания не будут получены.

Некоторые голоса могут поддерживать не все типы событий, а некоторые могут вообще не отправлять события. Если вы не хотите использовать голос, если он не отправляет определённые события, передайте необходимые события в элемент requiredEventTypes объекта options или используйте getVoices() , чтобы выбрать голос, соответствующий вашим требованиям. Оба варианта описаны ниже.

SSML-разметка

Высказывания, используемые в этом API, могут включать разметку с использованием языка разметки синтеза речи (SSML) . При использовании SSML первым аргументом функции speak() должен быть полный документ SSML с XML-заголовком и тегом <speak> верхнего уровня, а не фрагмент документа.

Например:

chrome.tts.speak(   '<?xml version="1.0"?>' +   '<speak>' +   '  The <emphasis>second</emphasis> ' +   '  word of this sentence was emphasized.' +   '</speak>' ); 

Не все речевые движки поддерживают все теги SSML, а некоторые могут вообще не поддерживать SSML, но все движки должны игнорировать любой SSML, который они не поддерживают, и продолжать озвучивать базовый текст.

Выберите голос

По умолчанию Chrome выбирает наиболее подходящий голос для каждого высказывания, которое вы хотите произнести, в зависимости от языка. В большинстве систем Windows, Mac OS X и ChromeOS функция синтеза речи, предоставляемая операционной системой, должна быть способна озвучивать любой текст как минимум на одном языке. Однако некоторым пользователям может быть доступно множество голосов, как из их операционной системы, так и из речевых движков, реализованных в других расширениях Chrome. В таких случаях вы можете реализовать собственный код для выбора подходящего голоса или предоставить пользователю список вариантов.

Чтобы получить список всех голосов, вызовите getVoices() и передайте ему функцию, которая получает массив объектов TtsVoice в качестве аргумента:

chrome.tts.getVoices(   function(voices) {     for (var i = 0; i < voices.length; i++) {       console.log('Voice ' + i + ':');       console.log('  name: ' + voices[i].voiceName);       console.log('  lang: ' + voices[i].lang);       console.log('  extension id: ' + voices[i].extensionId);       console.log('  event types: ' + voices[i].eventTypes);     }   } ); 

chrome.tts.getVoices(): Promise<TtsVoice[]>

chrome.tts.isSpeaking(): Promise<boolean>

chrome.tts.pause(): void

chrome.tts.resume(): void

chrome.tts.speak(
  utterance: string,
  options?: TtsOptions,
): Promise<void>

chrome.tts.stop(): void

chrome.tts.onVoicesChanged.addListener(
  callback: function,
)