SpeechSynthesizer.SpeakSsmlAsync(String) メソッド

定義

名前空間:

System.Speech.Synthesis

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v9.0.0-rc.2.24473.5

ソース:

SpeechSynthesizer.cs

非同期的に SSML マークアップを含む String を指示します。

public:
 System::Speech::Synthesis::Prompt ^ SpeakSsmlAsync(System::String ^ textToSpeak);

public System.Speech.Synthesis.Prompt SpeakSsmlAsync (string textToSpeak);

member this.SpeakSsmlAsync : string -> System.Speech.Synthesis.Prompt

Public Function SpeakSsmlAsync (textToSpeak As String) As Prompt

パラメーター

textToSpeak

String

読み上げるための SMML のマークアップ。

戻り値

Prompt

読み上げるコンテンツを含む オブジェクト。

例外

ArgumentNullException

textToSpeak は null です。

例

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

      // Build an SSML prompt in a string.
      string str = "<speak version=\"1.0\"";
      str += " xmlns=\"http://www.w3.org/2001/10/synthesis\"";
      str += " xml:lang=\"en-US\">";
      str += "<say-as type=\"date:mdy\"> 1/29/2009 </say-as>";
      str += "</speak>";

      // Speak the contents of the prompt asynchronously.
      synth.SpeakSsmlAsync(str);

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

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって SpeakSsml(String)スローされる例外に関するページを参照してください。

注釈

パラメーターの内容には 要素をtextToSpeakspeak含める必要があり、音声合成マークアップ言語 (SSML) バージョン 1.0 に準拠している必要があります。 詳細については、「 音声合成マークアップ言語リファレンス」を参照してください。

SSML マークアップを含む文字列を同期的に読み上げるには、 メソッドを使用します SpeakSsml 。 を使用 SpeakAsync して、SSML マークアップを含まない文字列の非同期読み上げを開始できます。

このメソッドの呼び出し中に、 は SpeechSynthesizer 次のイベントを発生させることができます。

• StateChanged. シンセサイザーの読み上げ状態が変化したときに発生します。

• SpeakStarted. シンセサイザーが音声の生成を開始すると発生します。

• PhonemeReached. シンセサイザーが文字または単語の組み合わせに達するたびに発生し、言語の目立たない音声を構成します。

• SpeakProgress. シンセサイザーが単語を話すのを完了するたびに発生します。

• VisemeReached. 音声出力のたびに発生させるには、音声の生成に使用される口または顔の筋肉の位置を変更する必要があります。

• BookmarkReached. シンセサイザーがプロンプトでブックマークを検出したときに発生します。

• VoiceChange. シンセサイザーの話し声が変わると発生します。

• SpeakCompleted. シンセサイザーが操作の処理 SpeakSsmlAsync を完了したときに発生します。

アプリケーションで読み上げ中にタスクを実行する必要がない場合は、 メソッドまたは メソッドをSpeakSsml使用Speakして音声を同期的に生成できます。