SpeakProgressEventArgs Kelas

Definisi

Ruang nama:

System.Speech.Synthesis

Rakitan:

System.Speech.dll

Paket:

System.Speech v9.0.0-preview.5.24306.7

Sumber:

SpeakProgressEventArgs.cs

Mengembalikan data dari SpeakProgress peristiwa.

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

Warisan

Object

EventArgs

AsyncCompletedEventArgs

PromptEventArgs

SpeakProgressEventArgs

Contoh

Contoh berikut menunjukkan informasi yang tersedia dari SpeakProgressEventArgs. Perhatikan bagaimana StartParagraphmetode , EndParagraph, StartSentence, dan EndSentence mempengaruhi CharacterCount dengan penambahan <tag p>, </p>, s>,< dan </s> ke SSML yang dihasilkan. Selain itu, ada dua entri dalam output untuk "30%", satu untuk setiap kata untuk mengucapkan string angka ini (tiga puluh persen). CharacterCount dan CharacterPosition sama untuk setiap entri dan mewakili karakter "30%. Namun, AudioPosition perubahan untuk mencerminkan berbicara tentang kata-kata "tiga puluh" dan "persen" oleh 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);  
    }  
  }  
}  

Keterangan

Instans SpeakProgressEventArgs dibuat saat SpeechSynthesizer objek menaikkan SpeakProgress peristiwa. SpeechSynthesizer meningkatkan peristiwa ini untuk setiap kata baru yang diucapkannya dalam perintah menggunakan salah Speaksatu metode , , SpeakAsyncSpeakSsml, atau SpeakSsmlAsync .

Data yang dikembalikan didasarkan pada Speech Synthesis Markup Language (SSML) yang dihasilkan kode. Nilai yang dikembalikan untuk CharacterCount menyertakan spasi dan karakter serta konten tag SSML yang dihasilkan oleh kode.

Properti

AudioPosition	Mendapatkan posisi audio peristiwa.
Cancelled	Mendapatkan nilai yang menunjukkan apakah operasi asinkron telah dibatalkan. (Diperoleh dari AsyncCompletedEventArgs)
CharacterCount	Mendapatkan jumlah karakter dalam kata yang diucapkan tepat sebelum acara dinaikkan.
CharacterPosition	Mendapatkan jumlah karakter dan spasi dari awal perintah ke posisi sebelum huruf pertama kata yang baru saja diucapkan.
Error	Mendapatkan nilai yang menunjukkan kesalahan mana yang terjadi selama operasi asinkron. (Diperoleh dari AsyncCompletedEventArgs)
Prompt	Mendapatkan perintah yang terkait dengan peristiwa. (Diperoleh dari PromptEventArgs)
Text	Teks yang baru saja diucapkan saat acara dinaikkan.
UserState	Mendapatkan pengidentifikasi unik untuk tugas asinkron. (Diperoleh dari AsyncCompletedEventArgs)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
RaiseExceptionIfNecessary()	Meningkatkan pengecualian yang disediakan pengguna jika operasi asinkron gagal. (Diperoleh dari AsyncCompletedEventArgs)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)