SpeechSynthesizer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет доступ к функциональным возможностям установленного подсистемы синтеза речи.
public ref class SpeechSynthesizer sealed : IDisposablepublic sealed class SpeechSynthesizer : IDisposabletype SpeechSynthesizer = class
interface IDisposablePublic NotInheritable Class SpeechSynthesizer
Implements IDisposable- Наследование
-
SpeechSynthesizer
- Реализации
Примеры
Следующий пример является частью консольного приложения, которое инициализирует SpeechSynthesizer объект и говорит строку.
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 объекта используется системный голос по умолчанию. Чтобы настроить SpeechSynthesizer использование одного из установленных голосов синтеза речи (текст в речь), используйте SelectVoice метод или SelectVoiceByHints метод. Чтобы получить сведения о том, какие голоса установлены, используйте GetInstalledVoices метод и VoiceInfo класс.
Этот класс также обеспечивает контроль над следующими аспектами синтеза речи:
Чтобы настроить выходные данные для SpeechSynthesizer объекта, используйте SetOutputToAudioStreamметоды , SetOutputToDefaultAudioDeviceSetOutputToNullи SetOutputToWaveFile методы.
Чтобы создать речь, используйте Speakметод , SpeakAsyncSpeakSsmlили SpeakSsmlAsync метод. Речь SpeechSynthesizer может производиться из текста, Prompt объекта или PromptBuilder объекта или языка разметки синтеза речи (SSML) версии 1.0.
Для приостановки и возобновления синтеза речи используйте Pause методы и Resume методы.
Чтобы добавить или удалить лексиконы, используйте AddLexicon методы и RemoveLexicon методы. Он SpeechSynthesizer может использовать один или несколько лексиконов для руководства по его произношению слов.
Чтобы изменить доставку выходных данных речи, используйте Rate свойства и Volume свойства.
Вызывает SpeechSynthesizer события при обнаружении определенных функций в запросах: (BookmarkReached, , PhonemeReachedVisemeReachedи SpeakProgress). Он также вызывает события, которые сообщают о начале (SpeakStarted) и конце (SpeakCompleted) речевой операции и об изменении голосового голоса (VoiceChange).
Note
Всегда вызывайте Dispose перед выпуском последней ссылки на .SpeechSynthesizer В противном случае используемые ресурсы не будут освобождены, пока сборщик мусора не вызовет SpeechSynthesizer метод объекта Finalize .
Конструкторы
| Имя | Описание |
|---|---|
| SpeechSynthesizer() |
Инициализирует новый экземпляр класса SpeechSynthesizer. |
Свойства
| Имя | Описание |
|---|---|
| Rate |
Возвращает или задает скорость SpeechSynthesizer речи объекта. |
| State |
Возвращает текущее состояние SpeechSynthesizer объекта. |
| Voice |
Возвращает сведения о текущем голосе SpeechSynthesizer объекта. |
| Volume |
Получение или установка выходного тома SpeechSynthesizer объекта. |
Методы
| Имя | Описание |
|---|---|
| AddLexicon(Uri, String) |
Добавляет лексикон в SpeechSynthesizer объект. |
| Dispose() |
SpeechSynthesizer Удаляет объект и освобождает ресурсы, используемые во время сеанса. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| Finalize() |
Выступает в качестве защиты для очистки ресурсов в случае, если Dispose() метод не вызывается. |
| GetCurrentlySpokenPrompt() |
Возвращает запрос, который SpeechSynthesizer говорится. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetInstalledVoices() |
Возвращает все установленные голоса синтеза речи (текст в речь). |
| GetInstalledVoices(CultureInfo) |
Возвращает все установленные голоса синтеза речи (текст в речь), поддерживающие определенный языковой стандарт. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Pause() |
Приостанавливает SpeechSynthesizer объект. |
| RemoveLexicon(Uri) |
Удаляет лексикон из SpeechSynthesizer объекта. |
| Resume() |
Возобновляет SpeechSynthesizer объект после приостановки. |
| SelectVoice(String) |
Выбирает определенный голос по имени. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Выбирает голос с определенным полом, возрастом и языковым стандартом, в зависимости от положения, в котором упорядочены голоса. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Выбирает голос с определенным полом и возрастом, в зависимости от положения, в котором упорядочены голоса. |
| SelectVoiceByHints(VoiceGender, VoiceAge) |
Выбирает голос с определенным полом и возрастом. |
| SelectVoiceByHints(VoiceGender) |
Выбирает голос с определенным полом. |
| SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Настраивает SpeechSynthesizer объект для добавления выходных данных в аудиопоток. |
| SetOutputToDefaultAudioDevice() |
Настраивает SpeechSynthesizer объект для отправки выходных данных на звуковое устройство по умолчанию. |
| SetOutputToNull() |
Настраивает объект, чтобы не отправлять выходные SpeechSynthesizer данные из операций синтеза на устройство, файл или поток. |
| SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
Настраивает SpeechSynthesizer объект для добавления выходных данных в файл формата звука Waveform в указанном формате. |
| SetOutputToWaveFile(String) |
Настраивает SpeechSynthesizer объект для добавления выходных данных в файл, содержащий звук формата Waveform. |
| SetOutputToWaveStream(Stream) |
Настраивает SpeechSynthesizer объект для добавления выходных данных в поток, содержащий звук формата Waveform. |
| Speak(Prompt) |
Синхронно говорит о содержимом Prompt объекта. |
| Speak(PromptBuilder) |
Синхронно говорит о содержимом PromptBuilder объекта. |
| Speak(String) |
Синхронно говорит о содержимом строки. |
| SpeakAsync(Prompt) |
Асинхронно говорит о содержимом Prompt объекта. |
| SpeakAsync(PromptBuilder) |
Асинхронно говорит о содержимом PromptBuilder объекта. |
| SpeakAsync(String) |
Асинхронно говорит о содержимом строки. |
| SpeakAsyncCancel(Prompt) |
Отменяет асинхронную операцию синтеза для запроса в очереди. |
| SpeakAsyncCancelAll() |
Отменяет все операции синтеза речи, асинхронные, асинхронные, асинхронные. |
| SpeakSsml(String) |
Синхронно говорит о том String , что содержит разметку SSML. |
| SpeakSsmlAsync(String) |
Асинхронно говорит о том String , что содержит разметку SSML. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
События
| Имя | Описание |
|---|---|
| BookmarkReached |
Вызывается при SpeechSynthesizer обнаружении закладки в запросе. |
| PhonemeReached |
Вызывается при достижении фонема. |
| SpeakCompleted |
Вызывается, когда SpeechSynthesizer завершается речь о запросе. |
| SpeakProgress |
Вызывается после того, как SpeechSynthesizer говорит каждое отдельное слово запроса. |
| SpeakStarted |
Вызывается, когда SpeechSynthesizer начинается речь о запросе. |
| StateChanged |
Вызывается при изменении состояния SpeechSynthesizer . |
| VisemeReached |
Вызывается при достижении виземы. |
| VoiceChange |
Вызывается при изменении голоса SpeechSynthesizer . |
