Partilhar via


SpeakProgressEventArgs Classe

Definição

Retorna os dados do 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
Herança

Exemplos

O exemplo a seguir demonstra as informações disponíveis em SpeakProgressEventArgs. Observe como os StartParagraphmétodos , EndParagraph, StartSentencee EndSentence afetam o CharacterCount pela adição de <marcas p>, </p>, <s> e </s> ao SSML gerado. Além disso, há duas entradas na saída para "30%", uma para cada palavra falar essa cadeia de caracteres numérica (trinta por cento). O CharacterCount e CharacterPosition são os mesmos para cada entrada e representam os caracteres "30%. No entanto, as AudioPosition alterações para refletir a fala das palavras "trinta" e "porcentagem" pelo 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);  
    }  
  }  
}  

Comentários

Uma instância de SpeakProgressEventArgs é criada quando o SpeechSynthesizer objeto aciona o SpeakProgress evento. O SpeechSynthesizer gera esse evento para cada nova palavra que ele fala em um prompt usando qualquer um dos Speakmétodos , SpeakAsyncSpeakSsml, ou SpeakSsmlAsync .

Os dados retornados são baseados no SSML (Speech Synthesis Markup Language) gerado pelo código. Os valores retornados para CharacterCount incluem espaços e os caracteres e o conteúdo das marcas SSML geradas pelo código.

Propriedades

AudioPosition

Obtém a posição de áudio do evento.

Cancelled

Obtém um valor que indica se uma operação assíncrona foi cancelada.

(Herdado de AsyncCompletedEventArgs)
CharacterCount

Obtém o número de caracteres na palavra que foi falada imediatamente antes do acionamento do evento.

CharacterPosition

Obtém o número de caracteres e espaços desde o início do prompt até a posição antes da primeira letra da palavra que acabou de ser falada.

Error

Obtém um valor que indica qual erro ocorreu durante uma operação assíncrona.

(Herdado de AsyncCompletedEventArgs)
Prompt

Obtém o prompt associado ao evento.

(Herdado de PromptEventArgs)
Text

O texto que foi falado imediatamente antes do acionamento do evento.

UserState

Obtém o identificador exclusivo para a tarefa assíncrona.

(Herdado de AsyncCompletedEventArgs)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
RaiseExceptionIfNecessary()

Gera uma exceção fornecida pelo usuário se uma operação assíncrona falhou.

(Herdado de AsyncCompletedEventArgs)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a