SpeechSynthesizer.SpeakAsync SpeechSynthesizer.SpeakAsync SpeechSynthesizer.SpeakAsync SpeechSynthesizer.SpeakAsync Method

定義

文字列、Prompt オブジェクト、または PromptBuilder オブジェクトから非同期で出力される音声を生成します。Generates speech output asynchronously from a string, a Prompt object, or a PromptBuilder object.

オーバーロード

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

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

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.

注釈

メソッドSpeakAsyncは、音声を非同期的に生成します。The SpeakAsync methods generate speech asynchronously. メソッドは、 SpeakAsyncオブジェクトの内容が読み上げを完了するのを待たずに、すぐに制御を戻します。The methods return immediately without waiting for the content of the SpeakAsync object to finish speaking. アプリケーションSpeakAsyncで読み上げ中にタスクを実行する必要がある場合はを使用します。たとえば、テキストの強調表示、描画アニメーション、モニターコントロール、その他のタスクなどです。Use SpeakAsync if your application needs to perform tasks while speaking, for example highlight text, paint animation, monitor controls, or other tasks.

このメソッドの呼び出し中に、は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. シンセサイザーが1つの文字または文字の組み合わせに到達するたびに発生し、言語の音声を個別に発音します。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.

  • SpeakCompletedSpeakCompleted. シンセサイザーが操作をSpeakAsync終了したときに発生します。Raised when the synthesizer finishes a SpeakAsync operation.

アプリケーションで読み上げ中にタスクを実行する必要がない場合は、 SpeakメソッドSpeakSsmlまたはメソッドを使用して同期的に音声を生成できます。If your application does not need to perform tasks while speaking, you can use the Speak methods or the SpeakSsml method to generate speech synchronously.

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

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

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

パラメーター

prompt
Prompt Prompt Prompt Prompt

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

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

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

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

      // Speak the contents of the prompt asynchronously.  
      synth.SpeakAsync(color);  

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

注釈

SpeakAsyncCancel またはメソッドを使用して、プロンプトの非同期の読み上げを取り消すSpeakAsyncCancelAllことができます。You can cancel the asynchronous speaking of a prompt with the SpeakAsyncCancel or the SpeakAsyncCancelAll method.

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

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

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

public:
 System::Speech::Synthesis::Prompt ^ SpeakAsync(System::Speech::Synthesis::PromptBuilder ^ promptBuilder);
public System.Speech.Synthesis.Prompt SpeakAsync (System.Speech.Synthesis.PromptBuilder promptBuilder);
member this.SpeakAsync : System.Speech.Synthesis.PromptBuilder -> System.Speech.Synthesis.Prompt

パラメーター

promptBuilder
PromptBuilder PromptBuilder PromptBuilder PromptBuilder

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

戻り値

発話するコンテンツを格納するオブジェクトを返します。Returns the object that contains the content to speak.

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

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

      // 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 asynchronously.  
      synth.SpeakAsync(song);  

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

注釈

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

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

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

public:
 System::Speech::Synthesis::Prompt ^ SpeakAsync(System::String ^ textToSpeak);
public System.Speech.Synthesis.Prompt SpeakAsync (string textToSpeak);
member this.SpeakAsync : string -> System.Speech.Synthesis.Prompt
Public Function SpeakAsync (textToSpeak As String) As Prompt

パラメーター

textToSpeak
String String String String

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

戻り値

発話するコンテンツを格納するオブジェクトを返します。Returns the object that contains the content to speak.

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

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 asynchronously.  
      synth.SpeakAsync("What is your favorite color?");  

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

注釈

SSML マークアップを含む文字列を非同期に読み上げるにはSpeakSsmlAsync 、メソッドを使用します。To asynchronously speak a string that contains SSML markup, use the SpeakSsmlAsync method. 文字列の内容を同期的に読み上げるには、 Speakメソッドを使用します。To synchronously speak the contents of a string, use the Speak method. SpeakAsyncCancel またはメソッドを使用して、プロンプトの非同期の読み上げを取り消すSpeakAsyncCancelAllことができます。You can cancel the asynchronous speaking of a prompt with the SpeakAsyncCancel or the SpeakAsyncCancelAll method.

こちらもご覧ください

適用対象