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:

  • 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.

  • SpeakCompleted.SpeakCompleted. 신시사이저 완료 될 때 발생 한 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.

추가 정보

적용 대상