SpeakProgressEventArgs Classe

Définition

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 StartParagraphbalises , , EndParagraph, StartSentenceet EndSentence les méthodes affectent l’ajout CharacterCount de <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 à parler cette chaîne numérique (trente pour cent). Les CharacterCount caractères CharacterPosition sont les mêmes pour chaque entrée et représentent les caractères « 30%. Toutefois, les AudioPosition changements à refléter le discours des mots « trente » et « percent » 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 l’objet SpeakProgressEventArgs est créée lorsque l’objet SpeechSynthesizer déclenche l’événement SpeakProgress . L’événement SpeechSynthesizer déclenche cet événement pour chaque nouveau mot qu’il parle dans une invite à l’aide de l’une Speakdes méthodes ou SpeakAsyncSpeakSsml des méthodesSpeakSsmlAsync.

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