SpeechSynthesizer クラス

定義

名前空間:

System.Speech.Synthesis

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v9.0.0-rc.1.24431.7

ソース:

SpeechSynthesizer.cs

インストール済みの音声合成エンジン機能へのアクセスを提供します。

C#

public sealed class SpeechSynthesizer : IDisposable

継承

Object

SpeechSynthesizer

実装

IDisposable

例

次の例は、オブジェクトを初期化して文字列を SpeechSynthesizer 読み上げるコンソール アプリケーションの一部です。

C#

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するには、 メソッドまたは SelectVoiceByHints メソッドをSelectVoice使用します。 インストールされている音声に関する情報を取得するには、 メソッドと クラスをVoiceInfo使用GetInstalledVoicesします。

このクラスでは、音声合成の次の側面も制御できます。

• オブジェクトの出力SpeechSynthesizerを構成するには、および メソッドをSetOutputToWaveFile使用SetOutputToDefaultAudioDeviceSetOutputToAudioStreamSetOutputToNullします。

• 音声を生成するには、または SpeakSsmlAsync メソッドをSpeakSsmlSpeakSpeakAsync使用します。 は SpeechSynthesizer 、テキスト、または PromptPromptBuilder オブジェクト、または 音声合成マークアップ言語 (SSML) バージョン 1.0 から音声を生成できます。

• 音声合成を一時停止して再開するには、 メソッドと Resume メソッドをPause使用します。

• 辞書を追加または削除するには、 メソッドと RemoveLexicon メソッドをAddLexicon使用します。 では SpeechSynthesizer 、1 つ以上の辞書を使用して、単語の発音をガイドできます。

• 音声出力の配信を変更するには、 プロパティと Volume プロパティをRate使用します。

はSpeechSynthesizer、プロンプトで特定の機能 (BookmarkReached、PhonemeReachedVisemeReachedおよび) が発生したときにイベントをSpeakProgress発生させます。 また、読み上げ操作の開始 () と終了 (SpeakStarted) と話し声VoiceChange (SpeakCompleted) の変化を報告するイベントも発生します。

注意

SpeechSynthesizerへの最後の参照を解放する前に、必ずDisposeを呼び出してください。 そうしないと、ガベージ コレクターが 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 オブジェクトを、WAVE 形式のオーディオを含むファイルに出力を追加するように構成します。
SetOutputToWaveFile(String, SpeechAudioFormatInfo)	SpeechSynthesizer のオブジェクトを、指定された形式で WAVE 形式のオーディオ形式ファイルに出力を追加するように構成します。
SetOutputToWaveStream(Stream)	SpeechSynthesizer オブジェクトを、WAVE 形式のオーディオを含むストリームに出力を追加するように構成します。
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
• 音声合成