SpeakProgressEventArgs Classe

Definizione

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)

Si applica a