SpeakProgressEventArgs Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí data z SpeakProgress události.
public ref class SpeakProgressEventArgs : System::Speech::Synthesis::PromptEventArgs
public class SpeakProgressEventArgs : System.Speech.Synthesis.PromptEventArgs
type SpeakProgressEventArgs = class
inherit PromptEventArgs
Public Class SpeakProgressEventArgs
Inherits PromptEventArgs
- Dědičnost
Příklady
Následující příklad ukazuje informace, které jsou k dispozici z SpeakProgressEventArgs. Všimněte si, jak StartParagraph, , EndParagraphStartSentencea EndSentence metody ovlivňují CharacterCount jejich přidání <p>, </p>, <s> a </s> značky do vygenerovaného SSML. Ve výstupu jsou také dvě položky pro "30%", jedna pro každé slovo, která mají přečíst tento číselný řetězec (třicet procent). CharacterCount A CharacterPosition jsou stejné pro každou položku a představují znaky "30%. Změny AudioPosition , které se však projeví ve slovech "třicet" a "procento" znakem SpeechSynthesizer.
using System;
using System.Speech.Synthesis;
namespace SampleSynthesis
{
class Program
{
static void Main(string[] args)
{
// Initialize a new instance of the SpeechSynthesizer.
using (SpeechSynthesizer synth = new SpeechSynthesizer())
{
// Configure the audio output.
synth.SetOutputToWaveFile(@"C:\test\weather.wav");
// Create a SoundPlayer instance to play the output audio file.
System.Media.SoundPlayer m_SoundPlayer =
new System.Media.SoundPlayer(@"C:\test\weather.wav");
// Build a prompt containing a paragraph and two sentences.
PromptBuilder builder = new PromptBuilder(
new System.Globalization.CultureInfo("en-US"));
builder.StartParagraph();
builder.StartSentence();
builder.AppendText(
"The weather forecast for today is partly cloudy with some sun breaks.");
builder.EndSentence();
builder.StartSentence();
builder.AppendText(
"Tonight's weather will be cloudy with a 30% chance of showers.");
builder.EndSentence();
builder.EndParagraph();
// Add a handler for the SpeakProgress event.
synth.SpeakProgress +=
new EventHandler<SpeakProgressEventArgs>(synth_SpeakProgress);
// Speak the prompt and play back the output file.
synth.Speak(builder);
m_SoundPlayer.Play();
}
Console.WriteLine();
Console.WriteLine("Press any key to exit...");
Console.ReadKey();
}
// Write each word and its character position to the console.
static void synth_SpeakProgress(object sender, SpeakProgressEventArgs e)
{
Console.WriteLine("CharPos: {0} CharCount: {1} AudioPos: {2} \"{3}\"",
e.CharacterPosition, e.CharacterCount, e.AudioPosition, e.Text);
}
}
}
Poznámky
Instance SpeakProgressEventArgs je vytvořena, když SpeechSynthesizer objekt vyvolá SpeakProgress událost. Vyvolá SpeechSynthesizer tuto událost pro každé nové slovo, které mluví v výzvě pomocí některé z Speak, SpeakAsync, SpeakSsmlnebo SpeakSsmlAsync metod.
Vrácená data jsou založená na jazyku SSML (Speech Synthesis Markup Language), který kód generuje. Hodnoty vrácené pro CharacterCount zahrnutí mezer a znaků a obsah značek SSML vygenerovaných kódem.
Vlastnosti
| Name | Description |
|---|---|
| AudioPosition |
Získá pozici zvuku události. |
| Cancelled |
Získá hodnotu určující, zda asynchronní operace byla zrušena. (Zděděno od AsyncCompletedEventArgs) |
| CharacterCount |
Získá početznakůch |
| CharacterPosition |
Získá počet znaků a mezer od začátku výzvy k pozici před prvním písmenem slova, které bylo právě mluvené. |
| Error |
Získá hodnotu určující, ke které chybě došlo během asynchronní operace. (Zděděno od AsyncCompletedEventArgs) |
| Prompt |
Získá výzvu přidruženou k události. (Zděděno od PromptEventArgs) |
| Text |
Text, který byl právě mluvený při vyvolání události. |
| UserState |
Získá jedinečný identifikátor pro asynchronní úlohu. (Zděděno od AsyncCompletedEventArgs) |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| RaiseExceptionIfNecessary() |
Vyvolá výjimku zadanou uživatelem, pokud asynchronní operace selhala. (Zděděno od AsyncCompletedEventArgs) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |