SpeakProgressEventArgs Sınıf

Tanım

Ad Alanı:

System.Speech.Synthesis

Bütünleştirilmiş Kod:

System.Speech.dll

Paket:

System.Speech v11.0.0-preview.5.26302.115

Kaynak:

SpeakProgressEventArgs.cs

Olaydaki SpeakProgress verileri döndürür.

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

Devralma

Object

EventArgs

AsyncCompletedEventArgs

PromptEventArgs

SpeakProgressEventArgs

Örnekler

Aşağıdaki örnekte, içinden SpeakProgressEventArgssağlanan bilgiler gösterilmektedir. , , StartParagraphEndParagraphve StartSentence yöntemlerininEndSentence, oluşturulan SSML'ye > nasıl etkilediğine ><><> Ayrıca, çıktıda "30%" için iki giriş vardır ve her sözcük için bu sayı dizesini (yüzde otuz) seslendirecek bir tane vardır. CharacterCount ve CharacterPosition her girdi için aynıdır ve "30%karakterlerini temsil eder. Ancak, AudioPosition değişiklikleri tarafından "otuz" ve "yüzde" sözcüklerinin konuşmasını SpeechSynthesizeryansıtır.

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);
    }
  }
}

Açıklamalar

nesnesi olayı oluşturduğunda SpeakProgressEventArgsSpeechSynthesizer bir örneği SpeakProgress oluşturulur. , SpeechSynthesizer , SpeakSpeakAsyncveya SpeakSsml yöntemlerinden herhangi birini SpeakSsmlAsynckullanarak bir istemde konuştuğu her yeni sözcük için bu olayı tetikler.

Döndürülen veriler, kodun oluşturduğu Konuşma Sentezi biçimlendirme dilini (SSML) temel alır. için CharacterCount döndürülen değerler boşluklar ile kod tarafından oluşturulan SSML etiketlerinin karakterlerini ve içeriğini içerir.

Özellikler

Name	Description
AudioPosition	Olayın ses konumunu alır.
CharacterCount	Olay tetiklemeden hemen önce konuşulan sözcükteki karakter sayısını alır.
CharacterPosition	komut isteminin başından yeni konuşulan sözcüğün ilk harfinden önceki konuma kadar olan karakter ve boşluk sayısını alır.
Prompt	Olayla ilişkili istem alır. (Devralındığı yer: PromptEventArgs)
Text	Olay tetiklendiğinde konuşulan metin.