SpeechSynthesizer SpeechSynthesizer SpeechSynthesizer SpeechSynthesizer Class

Definition

Bietet Zugriff auf die Funktionalität einer installierten Sprachsynthese-Engine. 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
Vererbung
SpeechSynthesizerSpeechSynthesizerSpeechSynthesizerSpeechSynthesizer
Implementiert

Beispiele

Im folgende Beispiel ist Teil einer Konsolenanwendung, die initialisiert einen SpeechSynthesizer Objekt und hält Vorträge eine Zeichenfolge.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();  
    }  
  }  
}  

Hinweise

Beim Erstellen einer neuen SpeechSynthesizer Objekt ist, wird er verwendet die Standard-System-Stimme.When you create a new SpeechSynthesizer object, it uses the default system voice. So konfigurieren Sie die SpeechSynthesizer verwenden, um eines der stimmen zurück, installierten Sprachsynthese (Text-Sprach-) verwenden, die SelectVoice oder SelectVoiceByHints Methode.To configure the SpeechSynthesizer to use one of the installed speech synthesis (text-to-speech) voices, use the SelectVoice or SelectVoiceByHints method. Rufen Sie Informationen darüber, welche stimmen zurück, die installiert werden mit der GetInstalledVoices Methode und die VoiceInfo Klasse.To get information about which voices are installed, use the GetInstalledVoices method and the VoiceInfo class.

Diese Klasse bietet auch die Kontrolle über die folgenden Aspekte der Sprachsynthese:This class also provides control over the following aspects of speech synthesis:

Die SpeechSynthesizer Ereignisse auslöst, wenn es feststellt, dass bestimmte Funktionen in den eingabeaufforderungen: (BookmarkReached, PhonemeReached, VisemeReached, und SpeakProgress).The SpeechSynthesizer raises events when it encounters certain features in prompts: (BookmarkReached, PhonemeReached, VisemeReached, and SpeakProgress). Sie löst ebenfalls Ereignisse, die beim Start zu melden (SpeakStarted) und (SpeakCompleted) der Vorgänge sprechen und auf der Änderung der Sprecherstimme Stimme (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).

Hinweis

Rufen Sie immer Dispose auf, bevor Sie den letzten Verweis auf das SpeechSynthesizer freigeben.Always call Dispose before you release your last reference to the SpeechSynthesizer. Andernfalls bleiben die verwendeten Ressourcen reserviert, bis die Garbage Collection die SpeechSynthesizer-Methode des Finalize-Objekts aufruft.Otherwise, the resources it is using will not be freed until the garbage collector calls the SpeechSynthesizer object's Finalize method.

Konstruktoren

SpeechSynthesizer() SpeechSynthesizer() SpeechSynthesizer() SpeechSynthesizer()

Initialisiert eine neue Instanz der SpeechSynthesizer-Klasse. Initializes a new instance of the SpeechSynthesizer class.

Eigenschaften

Rate Rate Rate Rate

Ruft die Sprechrate des SpeechSynthesizer-Objekts ab oder legt sie fest. Gets or sets the speaking rate of the SpeechSynthesizer object.

State State State State

Ruft den aktuellen Sprechzustand des SpeechSynthesizer-Objekts ab. Gets the current speaking state of the SpeechSynthesizer object.

Voice Voice Voice Voice

Ruft Informationen über die aktuelle Stimme des SpeechSynthesizer-Objekts ab. Gets information about the current voice of the SpeechSynthesizer object.

Volume Volume Volume Volume

Ruft die Ausgabelautstärke des SpeechSynthesizer-Objekts ab oder legt sie fest. Get or sets the output volume of the SpeechSynthesizer object.

Methoden

AddLexicon(Uri, String) AddLexicon(Uri, String) AddLexicon(Uri, String) AddLexicon(Uri, String)

Fügt dem SpeechSynthesizer-Objekt ein Lexikon hinzu. Adds a lexicon to the SpeechSynthesizer object.

Dispose() Dispose() Dispose() Dispose()

Verwirft das SpeechSynthesizer-Objekt und gibt Ressourcen frei, die während der Sitzung verwendet werden. Disposes the SpeechSynthesizer object and releases resources used during the session.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Stellt die Bereinigung von Ressourcen für den Fall sicher, dass die Dispose()-Methode nicht aufgerufen wird. Acts as a safeguard to clean up resources in the event that the Dispose() method is not called.

GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt()

Ruft die Eingabeaufforderung ab, die SpeechSynthesizer spricht. Gets the prompt that the SpeechSynthesizer is speaking.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als die Standardhashfunktion. Serves as the default hash function.

(Inherited from Object)
GetInstalledVoices() GetInstalledVoices() GetInstalledVoices() GetInstalledVoices()

Gibt alle installierten Stimmen der Sprachsynthese (Text-zu-Sprache) zurück. Returns all of the installed speech synthesis (text-to-speech) voices.

GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo)

Gibt alle installierten Stimmen der Sprachsynthese (Text-zu-Sprache) zurück, die ein bestimmtes Gebietsschema unterstützen. Returns all of the installed speech synthesis (text-to-speech) voices that support a specific locale.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab. Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object. Creates a shallow copy of the current Object.

(Inherited from Object)
Pause() Pause() Pause() Pause()

Pausiert das SpeechSynthesizer-Objekt. Pauses the SpeechSynthesizer object.

RemoveLexicon(Uri) RemoveLexicon(Uri) RemoveLexicon(Uri) RemoveLexicon(Uri)

Entfernt ein Lexikon aus dem SpeechSynthesizer-Objekt. Removes a lexicon from the SpeechSynthesizer object.

Resume() Resume() Resume() Resume()

Setzt das SpeechSynthesizer-Objekt fort, nachdem es angehalten wurde. Resumes the SpeechSynthesizer object after it has been paused.

SelectVoice(String) SelectVoice(String) SelectVoice(String) SelectVoice(String)

Wählt eine bestimmte Stimme nach Namen aus. Selects a specific voice by name.

SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender)

Wählt eine Stimme mit einem bestimmten Geschlecht aus. Selects a voice with a specific gender.

SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge)

Wählt eine Stimme mit einem bestimmten Geschlecht und einem Alter aus. Selects a voice with a specific gender and age.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32)

Wählt eine Stimme mit einem bestimmten Geschlecht und einem Alter auf Grundlage der Position aus, in der die Stimmen sortiert sind. Selects a voice with a specific gender and age, based on the position in which the voices are ordered.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)

Wählt eine Stimme mit einem bestimmten Geschlecht, Alter und Gebietsschema auf Grundlage der Position aus, in der die Stimmen sortiert sind. Selects a voice with a specific gender, age, and locale, based on the position in which the voices are ordered.

SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe an einem Audiostream anzufügen. Configures the SpeechSynthesizer object to append output to an audio stream.

SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice()

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe zum Audiogerät zu senden. Configures the SpeechSynthesizer object to send output to the default audio device.

SetOutputToNull() SetOutputToNull() SetOutputToNull() SetOutputToNull()

Konfiguriert das SpeechSynthesizer-Objekt, um keine Ausgabe aus Synthesevorgängen an ein Gerät, eine Datei oder einen Stream zu senden. Configures the SpeechSynthesizer object to not send output from synthesis operations to a device, file, or stream.

SetOutputToWaveFile(String) SetOutputToWaveFile(String) SetOutputToWaveFile(String) SetOutputToWaveFile(String)

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe an eine Datei anzufügen, die Audio im Waveform Format enthält. Configures the SpeechSynthesizer object to append output to a file that contains Waveform format audio.

SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo)

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe zu einer Datei im Waveform-Audioformat in einem angegebenen Format anzufügen. Configures the SpeechSynthesizer object to append output to a Waveform audio format file in a specified format.

SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream)

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe an einen Stream anzufügen, die Audio im Waveform Format enthält. Configures the SpeechSynthesizer object to append output to a stream that contains Waveform format audio.

Speak(Prompt) Speak(Prompt) Speak(Prompt) Speak(Prompt)

Spricht synchron den Inhalt eines Prompt-Objekts. Synchronously speaks the contents of a Prompt object.

Speak(PromptBuilder) Speak(PromptBuilder) Speak(PromptBuilder) Speak(PromptBuilder)

Spricht synchron den Inhalt eines PromptBuilder-Objekts. Synchronously speaks the contents of a PromptBuilder object.

Speak(String) Speak(String) Speak(String) Speak(String)

Spricht synchron den Inhalt einer Zeichenfolge. Synchronously speaks the contents of a string.

SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt)

Spricht asynchron den Inhalt eines Prompt-Objekts. Asynchronously speaks the contents of a Prompt object.

SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder)

Spricht asynchron den Inhalt eines PromptBuilder-Objekts. Asynchronously speaks the contents of a PromptBuilder object.

SpeakAsync(String) SpeakAsync(String) SpeakAsync(String) SpeakAsync(String)

Spricht asynchron den Inhalt eines -Objekts. Asynchronously speaks the contents of a string.

SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt)

Bricht den asynchronen Synthesevorgang für eine Eingabeaufforderung in der Warteschlange ab. Cancels the asynchronous synthesis operation for a queued prompt.

SpeakAsyncCancelAll() SpeakAsyncCancelAll() SpeakAsyncCancelAll() SpeakAsyncCancelAll()

Bricht alle in der Warteschlange stehenden, asynchronen Sprachesynthesevorgänge ab. Cancels all queued, asynchronous, speech synthesis operations.

SpeakSsml(String) SpeakSsml(String) SpeakSsml(String) SpeakSsml(String)

Spricht synchron eine String, welche ein SSML-Markup enthält. Synchronously speaks a String that contains SSML markup.

SpeakSsmlAsync(String) SpeakSsmlAsync(String) SpeakSsmlAsync(String) SpeakSsmlAsync(String)

Spricht asynchron eine String, die SSML-Markup enthält. Asynchronously speaks a String that contains SSML markup.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

BookmarkReached BookmarkReached BookmarkReached BookmarkReached

Wird ausgelöst, wenn das SpeechSynthesizer ein Lesezeichen in einer Eingabeaufforderung feststellt. Raised when the SpeechSynthesizer encounters a bookmark in a prompt.

PhonemeReached PhonemeReached PhonemeReached PhonemeReached

Wird ausgelöst, wenn ein Phonem erreicht wird. Raised when a phoneme is reached.

SpeakCompleted SpeakCompleted SpeakCompleted SpeakCompleted

Wird ausgelöst, wenn das SpeechSynthesizer das Sprechen einer Eingabeaufforderung abschließt. Raised when the SpeechSynthesizer completes the speaking of a prompt.

SpeakProgress SpeakProgress SpeakProgress SpeakProgress

Wird ausgelöst, nachdem der SpeechSynthesizer jedes einzelne Wort einer Eingabeaufforderung spricht. Raised after the SpeechSynthesizer speaks each individual word of a prompt.

SpeakStarted SpeakStarted SpeakStarted SpeakStarted

Wird ausgelöst, wenn das SpeechSynthesizer mit dem Sprechen einer Eingabeaufforderung beginnt. Raised when the SpeechSynthesizer begins the speaking of a prompt.

StateChanged StateChanged StateChanged StateChanged

Wird ausgelöst, wenn sich der Zustand von SpeechSynthesizer ändert. Raised when the state of the SpeechSynthesizer changes.

VisemeReached VisemeReached VisemeReached VisemeReached

Wird ausgelöst, wenn ein viseme erreicht wird. Raised when a viseme is reached.

VoiceChange VoiceChange VoiceChange VoiceChange

Wird ausgelöst, wenn sich die Stimme von SpeechSynthesizer ändert. Raised when the voice of the SpeechSynthesizer changes.

Gilt für:

Siehe auch