SpeakProgressEventArgs Classe

Définition

Espace de noms:

System.Speech.Synthesis

Assembly:

System.Speech.dll

Paquet:

System.Speech v9.0.0-rc.2.24473.5

Source:

SpeakProgressEventArgs.cs

Retourne des données de l'événement 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

Héritage

Object

EventArgs

AsyncCompletedEventArgs

PromptEventArgs

SpeakProgressEventArgs

Exemples

L’exemple suivant illustre les informations disponibles à partir de SpeakProgressEventArgs. Notez comment les StartParagraphméthodes , EndParagraph, StartSentenceet EndSentence affectent le CharacterCount en ajoutant des <balises p>, </p>, <s> et </s> au SSML généré. En outre, il existe deux entrées dans la sortie pour « 30 % », une pour chaque mot pour parler cette chaîne numérique (trente pour cent). Les CharacterCount et CharacterPosition sont les mêmes pour chaque entrée et représentent les caractères « 30 %. Toutefois, les AudioPosition modifications pour refléter la parole des mots « trente » et « pour cent » par le 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);  
    }  
  }  
}  

Remarques

Une instance de SpeakProgressEventArgs est créée lorsque l’objet SpeechSynthesizer déclenche l’événementSpeakProgress. déclenche SpeechSynthesizer cet événement pour chaque nouveau mot qu’il parle dans une invite à l’aide de l’une Speakdes méthodes , SpeakAsync, SpeakSsmlou SpeakSsmlAsync .

Les données retournées sont basées sur le langage SSML (Speech Synthesis Markup Language) généré par le code. Les valeurs retournées pour CharacterCount incluent les espaces et les caractères et le contenu des balises SSML générées par le code.

Propriétés

AudioPosition	Obtient la position audio de l'événement.
Cancelled	Obtient une valeur qui indique si une opération asynchrone a été annulée. (Hérité de AsyncCompletedEventArgs)
CharacterCount	Obtient le nombre de caractères du mot qui a été énoncé juste avant le déclenchement de l'événement.
CharacterPosition	Obtient le nombre de caractères et d'espaces à partir du début de l'invite jusqu'à la position précédant la première lettre du mot qui vient d'être énoncé.
Error	Obtient une valeur qui indique quelle erreur s'est produite pendant une opération asynchrone. (Hérité de AsyncCompletedEventArgs)
Prompt	Obtient l'invite associée à l'événement. (Hérité de PromptEventArgs)
Text	Texte qui venait d'être énoncé lorsque l'événement a été déclenché.
UserState	Obtient l'identificateur unique de la tâche asynchrone. (Hérité de AsyncCompletedEventArgs)

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
RaiseExceptionIfNecessary()	Lève une exception fournie par l'utilisateur en cas d'échec d'une opération asynchrone. (Hérité de AsyncCompletedEventArgs)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)