Freigeben über


SpeechSynthesizer Klasse

Definition

Bietet Zugriff auf die Funktionalität einer installierten Sprachsynthese-Engine.

public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
    interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
Vererbung
SpeechSynthesizer
Implementiert

Beispiele

Das folgende Beispiel ist Teil einer Konsolenanwendung, die ein SpeechSynthesizer -Objekt initialisiert und eine Zeichenfolge spricht.

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

Wenn Sie ein neues SpeechSynthesizer -Objekt erstellen, verwendet es die Standardsystemstimme. Verwenden SelectVoice Sie die - oder SelectVoiceByHints -Methode, um die -Methode so zu konfigurieren, dass SpeechSynthesizer eine der installierten Sprachsynthesestimmzeichen (Text-zu-Sprache) verwendet wird. Um Informationen darüber zu erhalten, welche Stimmen installiert sind, verwenden Sie die GetInstalledVoices -Methode und die VoiceInfo -Klasse.

Diese Klasse bietet auch kontrolle über die folgenden Aspekte der Sprachsynthese:

Löst SpeechSynthesizer Ereignisse aus, wenn bestimmte Features in Eingabeaufforderungen angezeigt werden: (BookmarkReached, PhonemeReached, VisemeReachedund SpeakProgress). Es löst auch Ereignisse aus, die über den Start (SpeakStarted) und das Ende (SpeakCompleted) von Sprechvorgängen und über die Änderung der Sprechstimme (VoiceChange) berichten.

Hinweis

Rufen Sie immer Dispose auf, bevor Sie den letzten Verweis auf das SpeechSynthesizer freigeben. Andernfalls bleiben die verwendeten Ressourcen reserviert, bis die Garbage Collection die SpeechSynthesizer-Methode des Finalize-Objekts aufruft.

Konstruktoren

SpeechSynthesizer()

Initialisiert eine neue Instanz der SpeechSynthesizer-Klasse.

Eigenschaften

Rate

Ruft die Sprechrate des SpeechSynthesizer-Objekts ab oder legt sie fest.

State

Ruft den aktuellen Sprechzustand des SpeechSynthesizer-Objekts ab.

Voice

Ruft Informationen über die aktuelle Stimme des SpeechSynthesizer-Objekts ab.

Volume

Ruft die Ausgabelautstärke des SpeechSynthesizer-Objekts ab oder legt sie fest.

Methoden

AddLexicon(Uri, String)

Fügt dem SpeechSynthesizer-Objekt ein Lexikon hinzu.

Dispose()

Verwirft das SpeechSynthesizer-Objekt und gibt Ressourcen frei, die während der Sitzung verwendet werden.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Finalize()

Stellt die Bereinigung von Ressourcen für den Fall sicher, dass die Dispose()-Methode nicht aufgerufen wird.

GetCurrentlySpokenPrompt()

Ruft die Eingabeaufforderung ab, die SpeechSynthesizer spricht.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetInstalledVoices()

Gibt alle installierten Stimmen der Sprachsynthese (Text-zu-Sprache) zurück.

GetInstalledVoices(CultureInfo)

Gibt alle installierten Sprachsynthesestimmzeichen (Sprachsynthese) zurück, die ein bestimmtes Gebietsschema unterstützen.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
Pause()

Pausiert das SpeechSynthesizer-Objekt.

RemoveLexicon(Uri)

Entfernt ein Lexikon aus dem SpeechSynthesizer-Objekt.

Resume()

Setzt das SpeechSynthesizer-Objekt fort, nachdem es angehalten wurde.

SelectVoice(String)

Wählt eine bestimmte Stimme nach Namen aus.

SelectVoiceByHints(VoiceGender)

Wählt eine Stimme mit einem bestimmten Geschlecht aus.

SelectVoiceByHints(VoiceGender, VoiceAge)

Wählt eine Stimme mit einem bestimmten Geschlecht und einem Alter aus.

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.

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.

SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe an einem Audiostream anzufügen.

SetOutputToDefaultAudioDevice()

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe zum Audiogerät zu senden.

SetOutputToNull()

Konfiguriert das SpeechSynthesizer-Objekt, um keine Ausgabe aus Synthesevorgängen an ein Gerät, eine Datei oder einen Stream zu senden.

SetOutputToWaveFile(String)

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe an eine Datei anzufügen, die Audio im Waveform Format enthält.

SetOutputToWaveFile(String, SpeechAudioFormatInfo)

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe zu einer Datei im Waveform-Audioformat in einem angegebenen Format anzufügen.

SetOutputToWaveStream(Stream)

Konfiguriert das SpeechSynthesizer-Objekt, um die Ausgabe an einen Stream anzufügen, die Audio im Waveform Format enthält.

Speak(Prompt)

Spricht synchron den Inhalt eines Prompt-Objekts.

Speak(PromptBuilder)

Spricht synchron den Inhalt eines PromptBuilder-Objekts.

Speak(String)

Spricht synchron den Inhalt einer Zeichenfolge.

SpeakAsync(Prompt)

Spricht asynchron den Inhalt eines Prompt-Objekts.

SpeakAsync(PromptBuilder)

Spricht asynchron den Inhalt eines PromptBuilder-Objekts.

SpeakAsync(String)

Spricht asynchron den Inhalt eines -Objekts.

SpeakAsyncCancel(Prompt)

Bricht den asynchronen Synthesevorgang für eine Eingabeaufforderung in der Warteschlange ab.

SpeakAsyncCancelAll()

Bricht alle in der Warteschlange stehenden, asynchronen Sprachesynthesevorgänge ab.

SpeakSsml(String)

Spricht synchron eine String, welche ein SSML-Markup enthält.

SpeakSsmlAsync(String)

Spricht asynchron eine String, die SSML-Markup enthält.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Ereignisse

BookmarkReached

Wird ausgelöst, wenn das SpeechSynthesizer ein Lesezeichen in einer Eingabeaufforderung feststellt.

PhonemeReached

Wird ausgelöst, wenn ein Phonem erreicht wird.

SpeakCompleted

Wird ausgelöst, wenn das SpeechSynthesizer das Sprechen einer Eingabeaufforderung abschließt.

SpeakProgress

Wird ausgelöst, nachdem der SpeechSynthesizer jedes einzelne Wort einer Eingabeaufforderung spricht.

SpeakStarted

Wird ausgelöst, wenn das SpeechSynthesizer mit dem Sprechen einer Eingabeaufforderung beginnt.

StateChanged

Wird ausgelöst, wenn sich der Zustand von SpeechSynthesizer ändert.

VisemeReached

Wird ausgelöst, wenn ein viseme erreicht wird.

VoiceChange

Wird ausgelöst, wenn sich die Stimme von SpeechSynthesizer ändert.

Gilt für:

Weitere Informationen