SpeechSynthesizer 類別

定義

命名空間:

System.Speech.Synthesis

組件:

System.Speech.dll

套件:

System.Speech v8.0.0

Source:

SpeechSynthesizer.cs

提供安裝的語音合成引擎功能的存取權。

public ref class SpeechSynthesizer sealed : IDisposable

public sealed class SpeechSynthesizer : IDisposable

type SpeechSynthesizer = class
    interface IDisposable

Public NotInheritable Class SpeechSynthesizer
Implements IDisposable

繼承

Object

SpeechSynthesizer

實作

IDisposable

範例

下列範例是初始化 物件並讀出字串之主控台應用程式的 SpeechSynthesizer 一部分。

using System;
using System.Speech.Synthesis;

namespace SampleSynthesis
{
  class Program
  {
    static void Main(string[] args)
    {

      // Initialize a new instance of the SpeechSynthesizer.
      SpeechSynthesizer synth = new SpeechSynthesizer();

      // Configure the audio output.
      synth.SetOutputToDefaultAudioDevice();

      // Speak a string.
      synth.Speak("This example demonstrates a basic use of Speech Synthesizer");

      Console.WriteLine();
      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }
  }
}

備註

當您建立新的 SpeechSynthesizer 物件時，它會使用預設的系統語音。 若要將 設定 SpeechSynthesizer 為使用其中一個已安裝的語音合成 (文字轉換語音) 語音，請使用 SelectVoice 或 SelectVoiceByHints 方法。 若要取得已安裝哪些語音的相關資訊，請使用 GetInstalledVoices 方法和 VoiceInfo 類別。

此類別也提供語音合成下列層面的控制：

• 若要設定 物件的輸出 SpeechSynthesizer ，請使用 SetOutputToAudioStream 、 SetOutputToDefaultAudioDevice 、 SetOutputToNull 和 SetOutputToWaveFile 方法。

• 若要產生語音，請使用 Speak 、 SpeakAsync 、 SpeakSsml 或 SpeakSsmlAsync 方法。 SpeechSynthesizer可以從文字、 Prompt 或 PromptBuilder 物件或語音合成標記語言產生語音， (SSML) 1.0 版。

• 若要暫停和繼續語音合成，請使用 Pause 和 Resume 方法。

• 若要新增或移除語彙，請使用 AddLexicon 和 RemoveLexicon 方法。 SpeechSynthesizer可以使用一或多個語彙來引導其單字發音。

• 若要修改語音輸出的傳遞，請使用 Rate 和 Volume 屬性。

SpeechSynthesizer會在出現提示時引發事件： (BookmarkReached 、 PhonemeReached 、 VisemeReached 和 SpeakProgress) 。 它也會引發事件，這些事件會報告說話作業的開始 (SpeakStarted) 和結束 (SpeakCompleted) ，以及說話語音 () VoiceChange 的變更。

注意

在您釋放最後一個 Dispose 參考之前，請務必呼叫 SpeechSynthesizer。 否則工作窗格所使用的資源不會釋放，直到記憶體回收行程呼叫 SpeechSynthesizer 物件的 Finalize 方法。

建構函式

SpeechSynthesizer()

初始化 SpeechSynthesizer 類別的新執行個體。

屬性

Rate	取得或設定 SpeechSynthesizer 物件的讀出速率。
State	取得 SpeechSynthesizer 物件目前的讀出狀態。
Voice	取得目前 SpeechSynthesizer 物件之語音的相關資訊。
Volume	取得或設定 SpeechSynthesizer 物件的輸出音量。

方法

AddLexicon(Uri, String)	將字典加入至 SpeechSynthesizer 物件。
Dispose()	處置 SpeechSynthesizer 物件，並釋放工作階段期間所使用的資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Finalize()	在未呼叫 Dispose() 方法時，做為清除資源的防護措施。
GetCurrentlySpokenPrompt()	取得 SpeechSynthesizer 正在讀出的提示。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetInstalledVoices()	傳回所有已安裝的語音合成 (文字轉換語音) 語音。
GetInstalledVoices(CultureInfo)	傳回支援特定地區設定的所有已安裝語音合成 (文字轉換語音) 語音。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Pause()	暫停 SpeechSynthesizer 物件。
RemoveLexicon(Uri)	從 SpeechSynthesizer 物件中移除字典。
Resume()	在暫停 SpeechSynthesizer 物件之後使其繼續。
SelectVoice(String)	依名稱選取特定的語音。
SelectVoiceByHints(VoiceGender)	選取特定性別的語音。
SelectVoiceByHints(VoiceGender, VoiceAge)	選取特定性別和年齡的語音。
SelectVoiceByHints(VoiceGender, VoiceAge, Int32)	根據已排序的語音位置，選取特定性別和年齡的語音。
SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)	根據已排序的語音位置，選取特定性別、年齡和地區設定的語音。
SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)	設定SpeechSynthesizer物件，以便將輸出附加至音訊資料流。
SetOutputToDefaultAudioDevice()	設定SpeechSynthesizer物件，以便將輸出傳送至預設音訊裝置。
SetOutputToNull()	設定SpeechSynthesizer物件，不將來自合成作業的輸出傳送至裝置、檔案或資料流。
SetOutputToWaveFile(String)	設定SpeechSynthesizer物件，以便將輸出附加至包含波形格式音訊的檔案。
SetOutputToWaveFile(String, SpeechAudioFormatInfo)	設定SpeechSynthesizer物件，以便將輸出附加至指定格式的波形音訊格式檔案。
SetOutputToWaveStream(Stream)	設定SpeechSynthesizer物件，以便將輸出附加至包含波形格式音訊的資料流。
Speak(Prompt)	以同步方式讀出 Prompt 物件的內容。
Speak(PromptBuilder)	以同步方式讀出 PromptBuilder 物件的內容。
Speak(String)	以同步方式讀出字串的內容。
SpeakAsync(Prompt)	以非同步方式讀出 Prompt 物件的內容。
SpeakAsync(PromptBuilder)	以非同步方式讀出 PromptBuilder 物件的內容。
SpeakAsync(String)	以非同步方式讀出字串的內容。
SpeakAsyncCancel(Prompt)	取消已佇列提示的非同步合成作業。
SpeakAsyncCancelAll()	取消所有已佇列、非同步的語音合成作業。
SpeakSsml(String)	以同步方式讀出包含 SSML 標記的 String。
SpeakSsmlAsync(String)	以非同步方式讀出包含 SSML 標記的 String。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

BookmarkReached	SpeechSynthesizer 在提示中遇到書籤時引發。
PhonemeReached	到達音素時引發。
SpeakCompleted	SpeechSynthesizer 完成讀出提示時引發。
SpeakProgress	在 SpeechSynthesizer 說出提示的每個字之後引發。
SpeakStarted	SpeechSynthesizer 開始讀出提示時引發。
StateChanged	變更 SpeechSynthesizer 的狀態時引發。
VisemeReached	到達視素 (Viseme) 時引發。
VoiceChange	變更 SpeechSynthesizer 的語音時引發。

另請參閱

• InstalledVoice
• Prompt
• PromptBuilder
• 語音合成