SpeechSynthesizer.SpeakAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Generiert eine Sprachausgabe asynchron aus einer Zeichenfolge, einem Prompt Objekt oder einem PromptBuilder Objekt.
Überlädt
| Name | Beschreibung |
|---|---|
| SpeakAsync(Prompt) |
Spricht asynchron den Inhalt eines Prompt Objekts. |
| SpeakAsync(PromptBuilder) |
Spricht asynchron den Inhalt eines PromptBuilder Objekts. |
| SpeakAsync(String) |
Spricht asynchron den Inhalt einer Zeichenfolge. |
Hinweise
Die SpeakAsync Methoden generieren Spracherkennung asynchron. Die Methoden werden sofort zurückgegeben, ohne darauf zu warten, dass der Inhalt des SpeakAsync Objekts abgeschlossen ist. Verwenden Sie SpeakAsync diese Einstellung, wenn Ihre Anwendung Aufgaben während des Sprechens ausführen muss, z. B. Text, Zeichnen von Animationen, Überwachen von Steuerelementen oder anderen Aufgaben.
Während eines Aufrufs dieser Methode können die SpeechSynthesizer folgenden Ereignisse auslösen:
StateChanged. Wird ausgelöst, wenn sich der Sprechzustand des Synthesizers ändert.
SpeakStarted. Wird ausgelöst, wenn der Synthesizer mit der Generierung von Sprache beginnt.
PhonemeReached. Wird jedes Mal ausgelöst, wenn der Synthesizer einen Buchstaben oder eine Kombination aus Buchstaben erreicht, die einen diskreten Sprachsound in einer Sprache darstellen.
SpeakProgress. Wird jedes Mal ausgelöst, wenn der Synthesizer ein Wort abschließt.
VisemeReached. Jedes Mal, wenn gesprochene Ausgabe ausgelöst wird, erfordert eine Änderung der Position des Mundes oder der Gesichtsmuskeln, die zum Erzeugen von Sprache verwendet werden.
BookmarkReached. Wird ausgelöst, wenn der Synthesizer auf eine Textmarke in einer Eingabeaufforderung trifft.
VoiceChange. Wird ausgelöst, wenn sich die Sprachstimme für den Synthesizer ändert.
SpeakCompleted. Wird ausgelöst, wenn der Synthesizer einen SpeakAsync Vorgang beendet.
Wenn Ihre Anwendung während des Sprechens keine Aufgaben ausführen muss, können Sie die Speak Methoden oder die Methode zum synchronen Generieren von SpeakSsml Spracherkennung verwenden.
SpeakAsync(Prompt)
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
Spricht asynchron den Inhalt eines Prompt Objekts.
public:
void SpeakAsync(System::Speech::Synthesis::Prompt ^ prompt);public void SpeakAsync(System.Speech.Synthesis.Prompt prompt);member this.SpeakAsync : System.Speech.Synthesis.Prompt -> unitPublic Sub SpeakAsync (prompt As Prompt)Parameter
- prompt
- Prompt
Der zu sprechende Inhalt.
Beispiele
Im folgenden Beispiel wird ein Prompt Objekt aus einer Zeichenfolge erstellt und das Objekt als Argument an die SpeakAsync Methode übergeben.
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();
// Create a prompt from a string.
Prompt color = new Prompt("What is your favorite color?");
// Speak the contents of the prompt asynchronously.
synth.SpeakAsync(color);
Console.WriteLine();
Console.WriteLine("Press any key to exit...");
Console.ReadKey();
}
}
}
Hinweise
Sie können das asynchrone Sprechen einer Eingabeaufforderung mit der SpeakAsyncCancel oder der SpeakAsyncCancelAll Methode abbrechen.
Um den Inhalt eines Prompt Objekts synchron zu sprechen, verwenden Sie Speak.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Speak(Prompt).
Gilt für:
SpeakAsync(PromptBuilder)
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
Spricht asynchron den Inhalt eines PromptBuilder Objekts.
public:
System::Speech::Synthesis::Prompt ^ SpeakAsync(System::Speech::Synthesis::PromptBuilder ^ promptBuilder);public System.Speech.Synthesis.Prompt SpeakAsync(System.Speech.Synthesis.PromptBuilder promptBuilder);member this.SpeakAsync : System.Speech.Synthesis.PromptBuilder -> System.Speech.Synthesis.PromptPublic Function SpeakAsync (promptBuilder As PromptBuilder) As PromptParameter
- promptBuilder
- PromptBuilder
Der zu sprechende Inhalt.
Gibt zurück
Das Objekt, das den zu sprechenden Inhalt enthält.
Beispiele
Im folgenden Beispiel wird ein PromptBuilder Objekt aus einer Zeichenfolge erstellt und das Objekt als Argument an die SpeakAsync Methode übergeben.
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();
// Create a PromptBuilder object and append a text string.
PromptBuilder song = new PromptBuilder();
song.AppendText("Say the name of the song you want to hear");
// Speak the contents of the prompt asynchronously.
synth.SpeakAsync(song);
Console.WriteLine();
Console.WriteLine("Press any key to exit...");
Console.ReadKey();
}
}
}
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Speak(PromptBuilder).
Hinweise
Um den Inhalt eines PromptBuilder Objekts synchron zu sprechen, verwenden Sie Speak.
Gilt für:
SpeakAsync(String)
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
Spricht asynchron den Inhalt einer Zeichenfolge.
public:
System::Speech::Synthesis::Prompt ^ SpeakAsync(System::String ^ textToSpeak);public System.Speech.Synthesis.Prompt SpeakAsync(string textToSpeak);member this.SpeakAsync : string -> System.Speech.Synthesis.PromptPublic Function SpeakAsync (textToSpeak As String) As PromptParameter
- textToSpeak
- String
Der zu sprechende Text.
Gibt zurück
Das Objekt, das den zu sprechenden Inhalt enthält.
Beispiele
Wie im folgenden Beispiel gezeigt, bietet die SpeakAsync Methode die einfachste Möglichkeit, die Sprachausgabe asynchron zu generieren.
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 asynchronously.
synth.SpeakAsync("What is your favorite color?");
Console.WriteLine();
Console.WriteLine("Press any key to exit...");
Console.ReadKey();
}
}
}
Hinweise
Verwenden Sie die SpeakSsmlAsync Methode, um asynchron eine Zeichenfolge zu sprechen, die SSML-Markup enthält. Verwenden Sie die Speak Methode, um den Inhalt einer Zeichenfolge synchron zu sprechen. Sie können das asynchrone Sprechen einer Eingabeaufforderung mit der SpeakAsyncCancel oder der SpeakAsyncCancelAll Methode abbrechen.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Speak(String).
