SpeechSynthesizer SpeechSynthesizer SpeechSynthesizer SpeechSynthesizer Class

定義

インストール済みの音声合成エンジン機能へのアクセスを提供します。Provides access to the functionality of an installed speech synthesis engine.

public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
    interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
継承
SpeechSynthesizerSpeechSynthesizerSpeechSynthesizerSpeechSynthesizer
実装

次の例は、オブジェクトをSpeechSynthesizer初期化して文字列を読み上げるコンソールアプリケーションの一部です。The following example is part of a console application that initializes a SpeechSynthesizer object and speaks a string.


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オブジェクトを作成すると、既定のシステム音声が使用されます。When you create a new SpeechSynthesizer object, it uses the default system voice. インストールされSpeechSynthesizerている音声合成 (音声合成) のいずれかを使用するようにを構成するSelectVoiceSelectVoiceByHintsは、メソッドまたはメソッドを使用します。To configure the SpeechSynthesizer to use one of the installed speech synthesis (text-to-speech) voices, use the SelectVoice or SelectVoiceByHints method. インストールされている音声に関する情報を取得GetInstalledVoicesするにはVoiceInfo 、メソッドとクラスを使用します。To get information about which voices are installed, use the GetInstalledVoices method and the VoiceInfo class.

このクラスは、音声合成の次の側面を制御することもできます。This class also provides control over the following aspects of speech synthesis:

SpeechSynthesizer 、プロンプトで特定の機能 (BookmarkReachedPhonemeReached VisemeReached、、およびSpeakProgress) が検出されたときにイベントを発生させます。The SpeechSynthesizer raises events when it encounters certain features in prompts: (BookmarkReached, PhonemeReached, VisemeReached, and SpeakProgress). また、読み上げ操作の開始 (SpeakStarted) と終了 (SpeakCompleted) について報告するイベントや、音声通話の変化 (VoiceChange) を報告するイベントも発生します。It also raises events that report on the start (SpeakStarted) and end (SpeakCompleted) of speak operations and on the change of the speaking voice (VoiceChange).

注意

SpeechSynthesizerへの最後の参照を解放する前に、必ずDisposeを呼び出してください。Always call Dispose before you release your last reference to the SpeechSynthesizer. そうしないと、ガベージ コレクターが SpeechSynthesizer オブジェクトの Finalize メソッドを呼び出すまで、使用されているリソースは解放されません。Otherwise, the resources it is using will not be freed until the garbage collector calls the SpeechSynthesizer object's Finalize method.

コンストラクター

SpeechSynthesizer() SpeechSynthesizer() SpeechSynthesizer() SpeechSynthesizer()

SpeechSynthesizer クラスの新しいインスタンスを初期化します。Initializes a new instance of the SpeechSynthesizer class.

プロパティ

Rate Rate Rate Rate

現在の SpeechSynthesizer オブジェクトの読み上げ速度を取得または設定します。Gets or sets the speaking rate of the SpeechSynthesizer object.

State State State State

SpeechSynthesizer オブジェクトの現在の音声読み上げの状態を取得します。Gets the current speaking state of the SpeechSynthesizer object.

Voice Voice Voice Voice

SpeechSynthesizer オブジェクトの現在の音声に関する情報を取得します。Gets information about the current voice of the SpeechSynthesizer object.

Volume Volume Volume Volume

SpeechSynthesizer オブジェクトの出力ボリュームを取得または設定します。Get or sets the output volume of the SpeechSynthesizer object.

メソッド

AddLexicon(Uri, String) AddLexicon(Uri, String) AddLexicon(Uri, String) AddLexicon(Uri, String)

用語集を SpeechSynthesizer オブジェクトに追加します。Adds a lexicon to the SpeechSynthesizer object.

Dispose() Dispose() Dispose() Dispose()

SpeechSynthesizer オブジェクトを破棄し、セッション中に使用するリソースを解放します。Disposes the SpeechSynthesizer object and releases resources used during the session.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Dispose() メソッドが呼び出されなかった場合にリソースをクリーンアップするための安全装置として動作します。Acts as a safeguard to clean up resources in the event that the Dispose() method is not called.

GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt()

SpeechSynthesizer が読み上げているプロンプトを取得します。Gets the prompt that the SpeechSynthesizer is speaking.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetInstalledVoices() GetInstalledVoices() GetInstalledVoices() GetInstalledVoices()

インストール済みの音声合成 (音声変換) の音声を返します。Returns all of the installed speech synthesis (text-to-speech) voices.

GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo)

特定のロケールをサポートする、インストール済みの音声合成 (音声変換) の音声を返します。Returns all of the installed speech synthesis (text-to-speech) voices that support a specific locale.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
Pause() Pause() Pause() Pause()

SpeechSynthesizer オブジェクトを一時停止します。Pauses the SpeechSynthesizer object.

RemoveLexicon(Uri) RemoveLexicon(Uri) RemoveLexicon(Uri) RemoveLexicon(Uri)

SpeechSynthesizer オブジェクトから辞書を削除します。Removes a lexicon from the SpeechSynthesizer object.

Resume() Resume() Resume() Resume()

一時停止した後、SpeechSynthesizer オブジェクトを再開します。Resumes the SpeechSynthesizer object after it has been paused.

SelectVoice(String) SelectVoice(String) SelectVoice(String) SelectVoice(String)

特定の音声を名前で選択します。Selects a specific voice by name.

SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender)

特定の性別の音声を選択します。Selects a voice with a specific gender.

SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge)

特定の性別と年齢の音声を選択します。Selects a voice with a specific gender and age.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32)

音声が並べられる位置に基づき、特定の性別や年齢の音声を選択します。Selects a voice with a specific gender and age, based on the position in which the voices are ordered.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)

音声が並べられる位置に基づき、特定の性別、年齢、ロケールの音声を選択します。Selects a voice with a specific gender, age, and locale, based on the position in which the voices are ordered.

SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

SpeechSynthesizer オブジェクトを、オーディオ ストリームへの出力を追加するように構成します。Configures the SpeechSynthesizer object to append output to an audio stream.

SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice()

SpeechSynthesizer オブジェクトを、既定のオーディオ デバイスへの出力を送信するように構成します。Configures the SpeechSynthesizer object to send output to the default audio device.

SetOutputToNull() SetOutputToNull() SetOutputToNull() SetOutputToNull()

SpeechSynthesizer オブジェクトを、合成操作からの出力をデバイス、ファイル、またはストリームに送信しないように設定します。Configures the SpeechSynthesizer object to not send output from synthesis operations to a device, file, or stream.

SetOutputToWaveFile(String) SetOutputToWaveFile(String) SetOutputToWaveFile(String) SetOutputToWaveFile(String)

SpeechSynthesizer オブジェクトを、WAVE 形式のオーディオを含むファイルに出力を追加するように構成します。Configures the SpeechSynthesizer object to append output to a file that contains Waveform format audio.

SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo)

SpeechSynthesizer のオブジェクトを、指定された形式で WAVE 形式のオーディオ形式ファイルに出力を追加するように構成します。Configures the SpeechSynthesizer object to append output to a Waveform audio format file in a specified format.

SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream)

SpeechSynthesizer オブジェクトを、WAVE 形式のオーディオを含むストリームに出力を追加するように構成します。Configures the SpeechSynthesizer object to append output to a stream that contains Waveform format audio.

Speak(Prompt) Speak(Prompt) Speak(Prompt) Speak(Prompt)

非同期的に Prompt オブジェクトのコンテンツを指示します。Synchronously speaks the contents of a Prompt object.

Speak(PromptBuilder) Speak(PromptBuilder) Speak(PromptBuilder) Speak(PromptBuilder)

非同期的に PromptBuilder オブジェクトのコンテンツを指示します。Synchronously speaks the contents of a PromptBuilder object.

Speak(String) Speak(String) Speak(String) Speak(String)

同期的に文字列のコンテンツを指示します。Synchronously speaks the contents of a string.

SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt)

非同期的に Prompt のオブジェクトのコンテンツを指示します。Asynchronously speaks the contents of a Prompt object.

SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder)

非同期的に PromptBuilder のオブジェクトのコンテンツを指示します。Asynchronously speaks the contents of a PromptBuilder object.

SpeakAsync(String) SpeakAsync(String) SpeakAsync(String) SpeakAsync(String)

非同期的に文字列のコンテンツを指示します。Asynchronously speaks the contents of a string.

SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt)

キューに挿入されたプロンプトの非同期合成操作をキャンセルします。Cancels the asynchronous synthesis operation for a queued prompt.

SpeakAsyncCancelAll() SpeakAsyncCancelAll() SpeakAsyncCancelAll() SpeakAsyncCancelAll()

すべてのキュー操作、非同期操作、音声合成操作をキャンセルします。Cancels all queued, asynchronous, speech synthesis operations.

SpeakSsml(String) SpeakSsml(String) SpeakSsml(String) SpeakSsml(String)

同期的に SSML マークアップを含む String を指示します。Synchronously speaks a String that contains SSML markup.

SpeakSsmlAsync(String) SpeakSsmlAsync(String) SpeakSsmlAsync(String) SpeakSsmlAsync(String)

非同期的に SSML マークアップを含む String を指示します。Asynchronously speaks a String that contains SSML markup.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

イベント

BookmarkReached BookmarkReached BookmarkReached BookmarkReached

SpeechSynthesizer がプロンプトのブックマークを検出したときに発生します。Raised when the SpeechSynthesizer encounters a bookmark in a prompt.

PhonemeReached PhonemeReached PhonemeReached PhonemeReached

音素に到達したときに発生します。Raised when a phoneme is reached.

SpeakCompleted SpeakCompleted SpeakCompleted SpeakCompleted

SpeechSynthesizer がプロンプトの読み上げを完了するときに発生します。Raised when the SpeechSynthesizer completes the speaking of a prompt.

SpeakProgress SpeakProgress SpeakProgress SpeakProgress

SpeechSynthesizer がプロンプトの個々の各単語を読み上げた後に発生します。Raised after the SpeechSynthesizer speaks each individual word of a prompt.

SpeakStarted SpeakStarted SpeakStarted SpeakStarted

SpeechSynthesizer がプロンプトの読み上げを開始するときに発生します。Raised when the SpeechSynthesizer begins the speaking of a prompt.

StateChanged StateChanged StateChanged StateChanged

SpeechSynthesizer の状態が変更されたときに発生します。Raised when the state of the SpeechSynthesizer changes.

VisemeReached VisemeReached VisemeReached VisemeReached

viseme に到達したときに発生します。Raised when a viseme is reached.

VoiceChange VoiceChange VoiceChange VoiceChange

SpeechSynthesizer の音声が変更されたときに発生します。Raised when the voice of the SpeechSynthesizer changes.

適用対象

こちらもご覧ください