SpeakProgressEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce dati dall'evento SpeakProgress.
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
- Ereditarietà
Esempio
Nell'esempio seguente vengono illustrate le informazioni disponibili in SpeakProgressEventArgs. Si noti che i StartParagraphmetodi , EndParagraph, StartSentencee EndSentence influiscono sull'aggiunta CharacterCount di <tag p>, </p>, <s> e </s> al codice SSML generato. Sono inoltre presenti due voci nell'output per "30%", una per ogni parola per pronunciare questa stringa numerica (trenta percento). e CharacterCountCharacterPosition sono uguali per ogni voce e rappresentano i caratteri "30%. Tuttavia, le AudioPosition modifiche apportate riflettono il parlato delle parole "trenta" e "percent" di 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);
}
}
}
Commenti
Un'istanza di SpeakProgressEventArgs viene creata quando l'oggetto SpeechSynthesizer genera l'evento SpeakProgress . Genera SpeechSynthesizer questo evento per ogni nuova parola che parla in un prompt usando uno dei Speakmetodi , SpeakAsync, SpeakSsmlo SpeakSsmlAsync .
I dati restituiti sono basati sul linguaggio SSML (Speech Synthesis Markup Language) generato dal codice. I valori restituiti per CharacterCount includono spazi e i caratteri e il contenuto dei tag SSML generati dal codice.
Proprietà
AudioPosition |
Ottiene la posizione audio dell'evento. |
Cancelled |
Ottiene un valore che indica se un'operazione asincrona è stata annullata. (Ereditato da AsyncCompletedEventArgs) |
CharacterCount |
Ottiene il numero di caratteri della parola che è stata pronunciata subito prima della generazione dell'evento. |
CharacterPosition |
Ottiene il numero di caratteri e spazi dall'inizio della richiesta alla posizione prima della prima lettera della parola che è stata appena pronunciata. |
Error |
Ottiene un valore che indica l'errore verificatosi durante un'operazione asincrona. (Ereditato da AsyncCompletedEventArgs) |
Prompt |
Ottiene il messaggio di richiesta associato all'evento. (Ereditato da PromptEventArgs) |
Text |
Il testo appena pronunciata quando è stato generato l'evento. |
UserState |
Ottiene l’identificatore univoco per l'attività asincrona. (Ereditato da AsyncCompletedEventArgs) |
Metodi
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
RaiseExceptionIfNecessary() |
Genera un'eccezione fornita dall'utente in caso di errore in un'operazione asincrona. (Ereditato da AsyncCompletedEventArgs) |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |