SpeechSynthesizer.Speak 메서드

정의

문자열, Prompt 개체 또는 PromptBuilder 개체로부터 음성 출력을 동기적으로 생성합니다.Generates speech output synchronously from a string, a Prompt object, or a PromptBuilder object.

오버로드

Speak(Prompt)

Prompt 객체의 내용을 동기적으로 말합니다.Synchronously speaks the contents of a Prompt object.

Speak(PromptBuilder)

PromptBuilder 객체의 내용을 동기적으로 말합니다.Synchronously speaks the contents of a PromptBuilder object.

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:

  • 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 중 하나를 처리 하는 동안 이벤트를 Speak 메서드.The SpeechSynthesizer does not raise the SpeakCompleted event while processing any of the Speak methods.

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

말할 콘텐츠입니다.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)

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

말할 콘텐츠입니다.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)

문자열의 내용을 동기적으로 말합니다.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

읽을 텍스트입니다.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.

적용 대상