SpeechSynthesizer.Speak SpeechSynthesizer.Speak SpeechSynthesizer.Speak SpeechSynthesizer.Speak Method

定義

音声出力を文字列から同期的に生成、Promptオブジェクト、またはPromptBuilderオブジェクト。Generates speech output synchronously from a string, a Prompt object, or a PromptBuilder object.

オーバーロード

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

内容を同期的に講演をPromptオブジェクト。Synchronously speaks the contents of a Prompt object.

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.

注釈

Speakメソッドは同期的に音声を生成します。The Speak methods generate speech synchronously. 内容まで、メソッドが返さない、Speakインスタンスが完全に読み上げられます。The methods do not return until the content of the Speak instance has been completely spoken. これは、音声を生成する最も簡単な方法です。This is the simplest way to generate speech. ただし、話すときにタスクを実行する場合、アプリケーションは、たとえば強調表示テキスト、ペイント アニメーション、モニターのコントロールまたはその他のタスクを使用して、SpeakAsyncメソッドまたはSpeakSsmlAsyncメソッドを非同期的に音声を生成します。However, if your application needs to perform tasks while speaking, for example highlight text, paint animation, monitor controls, or other tasks, use the SpeakAsync methods or the SpeakSsmlAsync method to generate speech asynchronously.

このメソッドの呼び出し中に、SpeechSynthesizer次のイベントを発生させることができます。During a call to this method, the SpeechSynthesizer can raise the following events:

  • StateChangedStateChanged. シンセサイザーの音声読み上げの状態が変更されたときに発生します。Raised when the speaking state of the synthesizer changes.

  • SpeakStartedSpeakStarted. シンセサイザー音声の生成を開始するときに発生します。Raised when the synthesizer begins generating speech.

  • PhonemeReachedPhonemeReached. シンセサイザーは文字または言語で音声の個別のサウンドを構成する文字の組み合わせに達するたびに発生します。Raised each time the synthesizer reaches a letter or combination of letters that constitute a discreet sound of speech in a language.

  • SpeakProgressSpeakProgress. たびに発生シンセサイザーは単語の読み上げを完了します。Raised each time the synthesizer completes speaking a word.

  • VisemeReachedVisemeReached. 音声出力、口または音声を生成するために使用される顔筋肉の位置の変更を必要とするたびに発生します。Raised each time spoken output requires a change in the position of the mouth or the facial muscles used to produce speech.

  • BookmarkReachedBookmarkReached. シンセサイザー、プロンプトのブックマークを検出するときに発生します。Raised when the synthesizer encounters a bookmark in a prompt.

  • VoiceChangeVoiceChange. シンセサイザーの声が変更されたときに発生します。Raised when the speaking voice for the synthesizer changes.

SpeechSynthesizerは発生しません、SpeakCompletedイベントのいずれかの処理中に、Speakメソッド。The SpeechSynthesizer does not raise the SpeakCompleted event while processing any of the Speak methods.

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

内容を同期的に講演をPromptオブジェクト。Synchronously speaks the contents of a Prompt object.

public:
 void Speak(System::Speech::Synthesis::Prompt ^ prompt);
public void Speak (System.Speech.Synthesis.Prompt prompt);
member this.Speak : System.Speech.Synthesis.Prompt -> unit

パラメーター

prompt
Prompt Prompt Prompt Prompt

話すコンテンツ。The content to speak.

次の例では、作成、Prompt文字列からオブジェクトへの引数として、オブジェクトを渡すと、Speakメソッド。The following example creates a Prompt object from a string and passes the object as an argument to the Speak method.

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.SetOutputToDefaultAudioDevice();  

        // Create a prompt from a string.  
        Prompt color = new Prompt("What is your favorite color?");  

        // Speak the contents of the prompt synchronously.  
        synth.Speak(color);  
      }  

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

注釈

非同期的の内容を読み上げる、Promptオブジェクトを使用してSpeakAsyncします。To asynchronously speak the contents of a Prompt object, use SpeakAsync.

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

内容を同期的に講演をPromptBuilderオブジェクト。Synchronously speaks the contents of a PromptBuilder object.

public:
 void Speak(System::Speech::Synthesis::PromptBuilder ^ promptBuilder);
public void Speak (System.Speech.Synthesis.PromptBuilder promptBuilder);
member this.Speak : System.Speech.Synthesis.PromptBuilder -> unit

パラメーター

promptBuilder
PromptBuilder PromptBuilder PromptBuilder PromptBuilder

話すコンテンツ。The content to speak.

次の例では、作成、PromptBuilder文字列からオブジェクトへの引数として、オブジェクトを渡すと、Speakメソッド。The following example creates a PromptBuilder object from a string and passes the object as an argument to the Speak method.

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.SetOutputToDefaultAudioDevice();  

        // Create a PromptBuilder object and append a text string.  
        PromptBuilder song = new PromptBuilder();  
        song.AppendText("Say the name of the song you want to hear");  

        // Speak the contents of the prompt synchronously.  
        synth.Speak(song);  
      }  

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

注釈

非同期的の内容を読み上げる、PromptBuilderオブジェクトを使用してSpeakAsyncします。To asynchronously speak the contents of a PromptBuilder object, use SpeakAsync.

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

文字列の内容を同期的に話します。Synchronously speaks the contents of a string.

public:
 void Speak(System::String ^ textToSpeak);
public void Speak (string textToSpeak);
member this.Speak : string -> unit
Public Sub Speak (textToSpeak As String)

パラメーター

textToSpeak
String String String String

読み上げるテキスト。The text to speak.

次の例で示すように、Speakメソッドは、音声が同期的に出力を生成する最も簡単な手段を提供します。As shown in the following example, the Speak method provides the simplest means to generate speech output synchronously.

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.SetOutputToDefaultAudioDevice();  

        // Speak a string synchronously.  
        synth.Speak("What is your favorite color?");  
      }  

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

注釈

同期的に SSML マークアップを含む文字列を読み上げを使用して、SpeakSsmlメソッド。To synchronously speak a string that contains SSML markup, use the SpeakSsml method. 非同期的に文字列の内容を読み上げるを使用して、SpeakAsyncメソッド。To asynchronously speak the contents of a string, use the SpeakAsync method.

適用対象