SpeechSynthesizer.SpeakSsml(String) メソッド


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

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



読み上げる SSML 文字列。The SSML string to speak.

次の例では、日付1/29/2009 を月、日、年の順に日付として表示します。The following example renders the date 1/29/2009 as a date, in month, day, year order.

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.   
      // 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 synchronously.
      Console.WriteLine("Press any key to exit...");  


textToSpeakパラメーターの内容にはspeak要素が含まれている必要があり、 Speech 合成マークアップ言語 (SSML) バージョン 1.0に準拠している必要があります。The contents of the textToSpeak parameter must include a speak element and must conform to the Speech Synthesis Markup Language (SSML) Version 1.0. 詳細については、「 Speech 合成マークアップ言語のリファレンス」を参照してください。For more information, see Speech Synthesis Markup Language Reference.

SSML マークアップを含む文字列を非同期に読み上げるにはSpeakSsmlAsync 、メソッドを使用します。To asynchronously speak a string that contains SSML markup, use the SpeakSsmlAsync method. を使用Speakすると、SSML マークアップを含まない文字列の同期を開始できます。You can use Speak to initiate the synchronous speaking of a string that does not contain SSML markup.

このメソッドの呼び出し中に、は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.

SpeechSynthesizer 、メソッドSpeakCompletedSpeakSsml処理中にイベントを発生させません。The SpeechSynthesizer does not raise the SpeakCompleted event while processing the SpeakSsml method.