System.Speech.Synthesis Пространство имен

Содержит классы для инициализации и настройки обработчика синтеза речи, создания сообщений, создания речи, реагирования на события и изменения характеристик голоса. Contains classes for initializing and configuring a speech synthesis engine, for creating prompts, for generating speech, for responding to events, and for modifying voice characteristics.

Классы

BookmarkReachedEventArgs

Возвращает данные из события BookmarkReached.Returns data from the BookmarkReached event.

FilePrompt

Представляет запрос, созданный из файла.Represents a prompt created from a file.

InstalledVoice

Содержит сведения о голосе для синтеза речи, установленного в Windows.Contains information about a speech synthesis voice installed in Windows.

PhonemeReachedEventArgs

Возвращает данные из события PhonemeReached.Returns data from the PhonemeReached event.

Prompt

Представляет сведения о том, какой тип данных, текст или звуковой файл, может преобразовать SpeechSynthesizer.Represents information about what can be rendered, either text or an audio file, by the SpeechSynthesizer.

PromptBuilder

Создает пустой объект Prompt и предоставляет методы для добавления содержимого, выбора голоса, управления атрибутами голоса и управления произношением слов.Creates an empty Prompt object and provides methods for adding content, selecting voices, controlling voice attributes, and controlling the pronunciation of spoken words.

PromptEventArgs

Представляет базовый класс для классов EventArgs в пространстве имен System.Speech.Synthesis.Represents the base class for EventArgs classes in the System.Speech.Synthesis namespace.

PromptStyle

Определяет стиль для подсказок речи, состоящий из параметров выделения, скорости и громкости.Defines a style for speaking prompts that consists of settings for emphasis, rate, and volume.

SpeakCompletedEventArgs

Возвращает уведомление из события SpeakCompleted.Returns notification from the SpeakCompleted event.

SpeakProgressEventArgs

Возвращает данные из события SpeakProgress.Returns data from the SpeakProgress event.

SpeakStartedEventArgs

Возвращает уведомление из события SpeakStarted.Returns notification from the SpeakStarted event.

SpeechSynthesizer

Предоставляет доступ к функциям установленного модуля синтеза речи.Provides access to the functionality of an installed speech synthesis engine.

StateChangedEventArgs

Возвращает данные из события StateChanged.Returns data from the StateChanged event.

VisemeReachedEventArgs

Возвращает данные из события VisemeReached.Returns data from the VisemeReached event.

VoiceChangeEventArgs

Возвращает данные из события VoiceChange.Returns data from the VoiceChange event.

VoiceInfo

Представляет установленный обработчик синтеза речи.Represents an installed speech synthesis engine.

Перечисления

PromptBreak

Перечисляет значения для интервалов интонационного разделения (разрывов) между границами слов.Enumerates values for intervals of prosodic separation (breaks) between word boundaries.

PromptEmphasis

Перечисляет значения для уровней выделения в приглашениях.Enumerates values for levels of emphasis in prompts.

PromptRate

Перечисляет значения скорости речи для приглашений.Enumerates values for the speaking rate of prompts.

PromptVolume

Перечисляет значения для уровней громкости в приглашениях.Enumerates values for volume levels (loudness) in prompts.

SayAs

Перечисляет типы содержимого для произнесения таких элементов, как время, дата и валюта.Enumerates the content types for the speaking of elements such as times, dates, and currency.

SynthesisMediaType

Перечисляет типы файлов мультимедиа.Enumerates the types of media files.

SynthesisTextFormat

Перечисляет типы форматов текста, которые могут быть использованы для создания объекта Prompt.Enumerates the types of text formats that may be used to construct a Prompt object.

SynthesizerEmphasis

Перечисляет уровни выделения синтезатора.Enumerates levels of synthesizer emphasis.

SynthesizerState

Перечисляет значения для состояния SpeechSynthesizer.Enumerates values for the state of the SpeechSynthesizer.

VoiceAge

Определяет значения для возраста синтезированного голоса.Defines the values for the age of a synthesized voice.

VoiceGender

Определяет значения для пола синтезированного голоса.Defines the values for the gender of a synthesized voice.

Комментарии

Инициализация и настройкаInitialize and Configure

SpeechSynthesizerКласс предоставляет доступ к функциональным возможностям модуля синтеза речи, установленного на главном компьютере.The SpeechSynthesizer class provides access to the functionality of a speech synthesis engine that is installed on the host computer. Установленные модули синтеза речи представлены голосом, например Microsoft Анна.Installed speech synthesis engines are represented by a voice, for example Microsoft Anna. SpeechSynthesizerЭкземпляр инициализируется с помощью голоса по умолчанию.A SpeechSynthesizer instance initializes to the default voice. Чтобы настроить SpeechSynthesizer экземпляр для использования одного из других установленных голосов, вызовите SelectVoice SelectVoiceByHints методы или.To configure a SpeechSynthesizer instance to use one of the other installed voices, call the SelectVoice or SelectVoiceByHints methods. Чтобы получить сведения о том, какие голоса установлены, используйте GetInstalledVoices метод.To get information about which voices are installed, use the GetInstalledVoices method.

Выходные данные можно направить в SpeechSynthesizer поток, файл, звуковое устройство по умолчанию или на устройство со значением NULL, используя один из методов SpeechSynthesizer класса, имя которого начинается с " SetOutputTo ".You can route the output of the SpeechSynthesizer to a stream, a file, the default audio device, or to a null device by using one of the methods in the SpeechSynthesizer class whose name begins with "SetOutputTo".

Создание запросовCreate Prompts

Используйте один из методов класса, PromptBuilder имя которого начинается с " Append ", чтобы создать содержимое для запросов из текста, языка разметки речи (SSML), файлов, содержащих текст или SSML разметку, или предзаписанных аудиофайлов.Use one the methods of the PromptBuilder class whose name begins with "Append" to build content for prompts from text, Speech Synthesis Markup Language (SSML), files containing text or SSML markup, or prerecorded audio files.

Дополнительные сведения и примеры см. в разделе Создание сложной подсказки в системном учебнике по программированию речи для .NET Framework .See Constructing a Complex Prompt in the System Speech Programming Guide for .NET Framework for more information and examples.

Создать речьGenerate Speech

Чтобы создать речь из строки или Prompt PromptBuilder объекта или, используйте Speak SpeakAsync методы или.To generate speech from a string or from a Prompt or PromptBuilder object, use the Speak or the SpeakAsync methods. Чтобы создать речь из разметки SSML, используйте SpeakSsml методы или SpeakSsmlAsync .To generate speech from SSML markup, use the SpeakSsml or the SpeakSsmlAsync methods. Руководство по SSML разметке см. в разделе Справочник по языку разметки речи .See Speech Synthesis Markup Language Reference for a guide to SSML markup.

Произношение слов можно выполнить с помощью AppendTextWithHint AppendTextWithPronunciation методов или, а также путем добавления или удаления лексиконов для SpeechSynthesizer экземпляра с помощью AddLexicon RemoveLexicon методов и.You can guide the pronunciation of words by using the AppendTextWithHint or AppendTextWithPronunciation methods, and by adding or removing lexicons for a SpeechSynthesizer instance using the AddLexicon and RemoveLexicon methods.

Реагирование на событияRespond to Events

SpeechSynthesizerКласс включает события, которые сообщают приложению распознавания речи о том, что в SpeechSynthesizer командной строке обнаружена конкретная функция, как сообщается SpeakProgressEventArgs BookmarkReachedEventArgs PhonemeReachedEventArgs классам,, и VisemeReachedEventArgs .The SpeechSynthesizer class includes events that inform a speech application that the SpeechSynthesizer encountered a specific feature in a prompt, as reported by the SpeakProgressEventArgs, BookmarkReachedEventArgs, PhonemeReachedEventArgs, and VisemeReachedEventArgs classes.

Чтобы получить сведения о начале и конце речи запроса SpeechSynthesizer , используйте SpeakStartedEventArgs SpeakCompletedEventArgs классы и.To get information about the beginning and end of the speaking of a prompt by the SpeechSynthesizer, use the SpeakStartedEventArgs and SpeakCompletedEventArgs classes.

Дополнительные сведения и примеры см. в разделе Использование событий синтеза речи в системном учебнике по программированию речи для .NET Framework .See Using Speech Synthesis Events in the System Speech Programming Guide for .NET Framework for more information and examples.

Изменение характеристик голосаModify Voice Characteristics

PromptStyleКласс и StartStyle AppendText методы позволяют изменять характеристики SpeechSynthesizer голоса с помощью Emphasis Rate параметров, и Volume .The PromptStyle class and StartStyle and AppendText methods let you modify characteristics of a SpeechSynthesizer voice using Emphasis, Rate, and Volume parameters. Для изменения характеристик голоса, таких как культура, возраст и пол, используйте один из StartVoice методов PromptBuilder класса или SelectVoiceByHints методы SpeechSynthesizer класса.To modify characteristics of a voice such as culture, age, and gender, use one of the StartVoice methods of the PromptBuilder class or the SelectVoiceByHints methods of the SpeechSynthesizer class.

Дополнительные сведения см. в разделе Управление голосовыми атрибутами в системном руководством по программированию речи для .NET Framework .See Controlling Voice Attributes in the System Speech Programming Guide for .NET Framework for more information.

См. также раздел