SpeakProgressEventArgs Klas

Definitie

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

Overname

Object

EventArgs

AsyncCompletedEventArgs

PromptEventArgs

SpeakProgressEventArgs

Voorbeelden

In het volgende voorbeeld ziet u de informatie die beschikbaar is in SpeakProgressEventArgs. Let op hoe de StartParagraph, EndParagraphen EndSentenceStartSentencemethoden van invloed zijn op de CharacterCount toevoeging van <p>-, </p>-, <s>- en </s-tags> aan de gegenereerde SSML. Er zijn ook twee vermeldingen in de uitvoer voor '30%', één voor elk woord om deze numerieke tekenreeks (dertig procent) te spreken. De CharacterCount en CharacterPosition zijn hetzelfde voor elke vermelding en vertegenwoordigen de tekens '30%. De AudioPosition wijzigingen moeten echter overeenkomen met de woorden "dertig" en "percentage" door de 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);
    }
  }
}

Opmerkingen

Er wordt een exemplaar van SpeakProgressEventArgs gemaakt wanneer het SpeechSynthesizer object de SpeakProgress gebeurtenis genereert. De SpeechSynthesizer gebeurtenis genereert deze gebeurtenis voor elk nieuw woord dat wordt gesproken in een prompt met behulp van een van de Speak, SpeakAsyncof SpeakSsmlAsyncSpeakSsmlmethoden.

De geretourneerde gegevens zijn gebaseerd op de Speech Synthesis Markup Language (SSML) die door de code wordt gegenereerd. De waarden die worden geretourneerd voor CharacterCount het opnemen van spaties en de tekens en inhoud van de SSML-tags die door de code worden gegenereerd.