SpeechSynthesizer Класс

Определение

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

public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
    interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
Наследование
SpeechSynthesizer
Реализации

Примеры

Следующий пример является частью консольного приложения, которое инициализирует SpeechSynthesizer объект и выступает в качестве строки.The following example is part of a console application that initializes a SpeechSynthesizer object and speaks a string.

  
using System;  
using System.Speech.Synthesis;  
  
namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
  
      // Initialize a new instance of the SpeechSynthesizer.  
      SpeechSynthesizer synth = new SpeechSynthesizer();  
  
      // Configure the audio output.   
      synth.SetOutputToDefaultAudioDevice();  
  
      // Speak a string.  
      synth.Speak("This example demonstrates a basic use of Speech Synthesizer");  
  
      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  
  

Комментарии

При создании нового SpeechSynthesizer объекта используется системный Voice по умолчанию.When you create a new SpeechSynthesizer object, it uses the default system voice. Чтобы настроить SpeechSynthesizer для использования одного из установленных голосов для синтеза речи (преобразования текста в речь), SelectVoice используйте метод или SelectVoiceByHints .To configure the SpeechSynthesizer to use one of the installed speech synthesis (text-to-speech) voices, use the SelectVoice or SelectVoiceByHints method. Чтобы получить сведения о том, какие голоса установлены, используйте GetInstalledVoices метод VoiceInfo и класс.To get information about which voices are installed, use the GetInstalledVoices method and the VoiceInfo class.

Этот класс также обеспечивает управление следующими аспектами синтеза речи:This class also provides control over the following aspects of speech synthesis:

SpeakProgress VisemeReached PhonemeReachedBookmarkReachedКомпонент вызывает события при обнаружении в запросах определенных функций: (,, и). SpeechSynthesizerThe SpeechSynthesizer raises events when it encounters certain features in prompts: (BookmarkReached, PhonemeReached, VisemeReached, and SpeakProgress). Он также создает события, сообщающие о начале (SpeakStarted) и окончанииSpeakCompleted(), которые говорят об операциях, и о сменеVoiceChangeречи ().It also raises events that report on the start (SpeakStarted) and end (SpeakCompleted) of speak operations and on the change of the speaking voice (VoiceChange).

Примечание

Всегда вызывайте метод Dispose перед освобождением последней ссылки на класс SpeechSynthesizer.Always call Dispose before you release your last reference to the SpeechSynthesizer. В противном случае используемые им ресурсы не будут освобождены до тех пор, пока сборщик мусора не вызовет для объекта SpeechSynthesizer метод Finalize.Otherwise, the resources it is using will not be freed until the garbage collector calls the SpeechSynthesizer object's Finalize method.

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

SpeechSynthesizer()

Инициализирует новый экземпляр класса SpeechSynthesizer.Initializes a new instance of the SpeechSynthesizer class.

Свойства

Rate

Получает или задает скорость произношения объекта SpeechSynthesizer.Gets or sets the speaking rate of the SpeechSynthesizer object.

State

Получает текущее состояние произношения объекта SpeechSynthesizer.Gets the current speaking state of the SpeechSynthesizer object.

Voice

Получает сведения о текущем голосе объекта SpeechSynthesizer.Gets information about the current voice of the SpeechSynthesizer object.

Volume

Получает или задает выходной объем объекта SpeechSynthesizer.Get or sets the output volume of the SpeechSynthesizer object.

Методы

AddLexicon(Uri, String)

Добавляет лексикон в объект SpeechSynthesizer.Adds a lexicon to the SpeechSynthesizer object.

Dispose()

Удаляет объект SpeechSynthesizer и освобождает ресурсы, используемые во время сеанса.Disposes the SpeechSynthesizer object and releases resources used during the session.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Finalize()

Является резервным вариантом очистки ресурсов в событии на тот случай, если метод Dispose() не будет вызван.Acts as a safeguard to clean up resources in the event that the Dispose() method is not called.

GetCurrentlySpokenPrompt()

Получает запрос, который указывает SpeechSynthesizer.Gets the prompt that the SpeechSynthesizer is speaking.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetInstalledVoices()

Возвращает все установленные голоса синтеза речи (текст в речь).Returns all of the installed speech synthesis (text-to-speech) voices.

GetInstalledVoices(CultureInfo)

Возвращает все установленные голоса синтеза речи (преобразования текста в речь), которые поддерживают указанный языковой стандарт.Returns all of the installed speech synthesis (text-to-speech) voices that support a specific locale.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Pause()

Приостанавливает объект SpeechSynthesizer.Pauses the SpeechSynthesizer object.

RemoveLexicon(Uri)

Удаляет лексикон из объекта SpeechSynthesizer.Removes a lexicon from the SpeechSynthesizer object.

Resume()

Возобновляет объект SpeechSynthesizer после того, как он был приостановлен.Resumes the SpeechSynthesizer object after it has been paused.

SelectVoice(String)

Выберите конкретный голос по имени.Selects a specific voice by name.

SelectVoiceByHints(VoiceGender)

Выбирает голос с определенным полом.Selects a voice with a specific gender.

SelectVoiceByHints(VoiceGender, VoiceAge)

Выбирает голос с конкретным полом и возрастом.Selects a voice with a specific gender and age.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32)

Выбирает голос с определенными полом и возрастом, в зависимости от позиции, в которой упорядочиваются голоса.Selects a voice with a specific gender and age, based on the position in which the voices are ordered.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)

Выбирает голос с определенными полом, возрастом и Языковым стандартом, в зависимости от позиции, в которой упорядочиваются голоса.Selects a voice with a specific gender, age, and locale, based on the position in which the voices are ordered.

SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

Настраивает объект SpeechSynthesizer для добавления выходных данных в аудиопоток.Configures the SpeechSynthesizer object to append output to an audio stream.

SetOutputToDefaultAudioDevice()

Настраивает объект SpeechSynthesizer для отправки выходных данных в аудиоустройство по умолчанию.Configures the SpeechSynthesizer object to send output to the default audio device.

SetOutputToNull()

Настраивает объект SpeechSynthesizer, чтобы не отправлять выходные данные из операций синтеза в устройство, файл или поток.Configures the SpeechSynthesizer object to not send output from synthesis operations to a device, file, or stream.

SetOutputToWaveFile(String)

Настраивает объект SpeechSynthesizer для добавления выходных данных в файл, содержащий данные в формате WAV.Configures the SpeechSynthesizer object to append output to a file that contains Waveform format audio.

SetOutputToWaveFile(String, SpeechAudioFormatInfo)

Настраивает объект SpeechSynthesizer для добавления выходных данных в файл с аудиоданными определенного формата.Configures the SpeechSynthesizer object to append output to a Waveform audio format file in a specified format.

SetOutputToWaveStream(Stream)

Настраивает объект SpeechSynthesizer для добавления выходных данных в поток содержащий данные в формате WAV.Configures the SpeechSynthesizer object to append output to a stream that contains Waveform format audio.

Speak(Prompt)

Синхронно произносит содержимое объекта Prompt.Synchronously speaks the contents of a Prompt object.

Speak(PromptBuilder)

Синхронно произносит содержимое объекта PromptBuilder.Synchronously speaks the contents of a PromptBuilder object.

Speak(String)

Синхронно произносит содержимое строки.Synchronously speaks the contents of a string.

SpeakAsync(Prompt)

Асинхронно указывает содержимое объекта Prompt.Asynchronously speaks the contents of a Prompt object.

SpeakAsync(PromptBuilder)

Асинхронно указывает содержимое объекта PromptBuilder.Asynchronously speaks the contents of a PromptBuilder object.

SpeakAsync(String)

Асинхронно указывает содержимое строки.Asynchronously speaks the contents of a string.

SpeakAsyncCancel(Prompt)

Отменяет асинхронную операцию синтеза для запроса в очереди.Cancels the asynchronous synthesis operation for a queued prompt.

SpeakAsyncCancelAll()

Отменяет все асинхронные операции синтеза речи, в очереди.Cancels all queued, asynchronous, speech synthesis operations.

SpeakSsml(String)

Синхронно произносит String, содержащий разметку SSML.Synchronously speaks a String that contains SSML markup.

SpeakSsmlAsync(String)

Асинхронно сообщает String, содержащий разметку SSML.Asynchronously speaks a String that contains SSML markup.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

События

BookmarkReached

Возникает, когда SpeechSynthesizer встречает закладку в запросе.Raised when the SpeechSynthesizer encounters a bookmark in a prompt.

PhonemeReached

Вызывается по достижении фонемы.Raised when a phoneme is reached.

SpeakCompleted

Возникает, когда SpeechSynthesizer завершает воспроизводить запрос.Raised when the SpeechSynthesizer completes the speaking of a prompt.

SpeakProgress

Возникает после того, как SpeechSynthesizer сообщает каждое отдельное слово запроса.Raised after the SpeechSynthesizer speaks each individual word of a prompt.

SpeakStarted

Возникает, когда SpeechSynthesizer начинает воспроизводить запрос.Raised when the SpeechSynthesizer begins the speaking of a prompt.

StateChanged

Возникает, когда меняется состояние SpeechSynthesizer.Raised when the state of the SpeechSynthesizer changes.

VisemeReached

Вызывается по достижении виземы.Raised when a viseme is reached.

VoiceChange

Возникает, когда меняется голос SpeechSynthesizer.Raised when the voice of the SpeechSynthesizer changes.

Применяется к

Дополнительно