SpeechSynthesizer.SpeakSsml(String) SpeechSynthesizer.SpeakSsml(String) SpeechSynthesizer.SpeakSsml(String) SpeechSynthesizer.SpeakSsml(String) Method

정의

SSML 태그를 포함하는 String을 동기적으로 말합니다.Synchronously speaks a String that contains SSML markup.

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

매개 변수

textToSpeak
String String String 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.   
      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 synchronously.
      synth.SpeakSsml(str);  
  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

설명

내용의 textToSpeak 매개 변수를 포함 해야 합니다는 speak 요소에 맞아야 합니다 Speech Synthesis Markup Language (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 Synthesis Markup 언어 참조합니다.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:

  • StateChanged.StateChanged. 음성 신시사이저의 상태 변경 될 때 발생 합니다.Raised when the speaking state of the synthesizer changes.

  • SpeakStarted.SpeakStarted. 신시사이저 음성의 생성을 시작 하는 경우 발생 합니다.Raised when the synthesizer begins generating speech.

  • PhonemeReached.PhonemeReached. 신시사이저 문자 또는 음성 언어의 신중한 소리를 구성 하는 문자 조합에 도달할 때마다를 발생 합니다.Raised each time the synthesizer reaches a letter or combination of letters that constitute a discreet sound of speech in a language.

  • SpeakProgress.SpeakProgress. 단어를 말하는 신시사이저 완료 될 때마다 발생 합니다.Raised each time the synthesizer completes speaking a word.

  • VisemeReached.VisemeReached. 음성된 출력 입 또는 음성을 생성 하는 데 얼굴 근육의 위치에서를 변경 해야 때마다를 발생 합니다.Raised each time spoken output requires a change in the position of the mouth or the facial muscles used to produce speech.

  • BookmarkReached.BookmarkReached. 신시사이저 프롬프트에서 책갈피를 발견할 때 발생 합니다.Raised when the synthesizer encounters a bookmark in a prompt.

  • VoiceChange.VoiceChange. 음성 신시사이저에 대 한 변경 될 때 발생 합니다.Raised when the speaking voice for the synthesizer changes.

합니다 SpeechSynthesizer 발생 하지 않습니다 합니다 SpeakCompleted 처리 하는 동안 이벤트를 SpeakSsml 메서드.The SpeechSynthesizer does not raise the SpeakCompleted event while processing the SpeakSsml method.

적용 대상