SpeechSynthesizer.SpeakAsync SpeechSynthesizer.SpeakAsync SpeechSynthesizer.SpeakAsync SpeechSynthesizer.SpeakAsync Method

Definición

Genera voz emitida de forma asincrónica desde una cadena, un objeto Prompt o un objeto PromptBuilder.Generates speech output asynchronously from a string, a Prompt object, or a PromptBuilder object.

Sobrecargas

SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt)

De forma asincrónica habla el contenido de un objeto Prompt.Asynchronously speaks the contents of a Prompt object.

SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder)

De forma asincrónica habla el contenido de un objeto PromptBuilder.Asynchronously speaks the contents of a PromptBuilder object.

SpeakAsync(String) SpeakAsync(String) SpeakAsync(String) SpeakAsync(String)

De forma asincrónica habla el contenido de una cadena.Asynchronously speaks the contents of a string.

Comentarios

El SpeakAsync métodos generan voz de forma asincrónica.The SpeakAsync methods generate speech asynchronously. Los métodos devuelven inmediatamente sin esperar a que el contenido de la SpeakAsync objeto termine de hablar.The methods return immediately without waiting for the content of the SpeakAsync object to finish speaking. Use SpeakAsync si la aplicación necesita realizar tareas mientras habla, por ejemplo, resaltar texto, pintar la animación, controles de supervisión u otras tareas.Use SpeakAsync if your application needs to perform tasks while speaking, for example highlight text, paint animation, monitor controls, or other tasks.

Durante una llamada a este método, el SpeechSynthesizer puede provocar los eventos siguientes:During a call to this method, the SpeechSynthesizer can raise the following events:

  • StateChanged.StateChanged. Se genera cuando cambia el estado de habla del sintetizador.Raised when the speaking state of the synthesizer changes.

  • SpeakStarted.SpeakStarted. Se genera cuando el sintetizador comience a generar la voz.Raised when the synthesizer begins generating speech.

  • PhonemeReached.PhonemeReached. Se genera cada vez que el sintetizador alcanza una letra o una combinación de letras que constituyen un sonido discreto de voz en un idioma.Raised each time the synthesizer reaches a letter or combination of letters that constitute a discreet sound of speech in a language.

  • SpeakProgress.SpeakProgress. Se genera cada vez que el sintetizador completa hablando de una palabra.Raised each time the synthesizer completes speaking a word.

  • VisemeReached.VisemeReached. Genera cada vez salida de voz requiere un cambio en la posición de la boca o los músculos faciales utilizados para generar voz.Raised each time spoken output requires a change in the position of the mouth or the facial muscles used to produce speech.

  • BookmarkReached.BookmarkReached. Se genera cuando el sintetizador encuentra un marcador en un símbolo del sistema.Raised when the synthesizer encounters a bookmark in a prompt.

  • VoiceChange.VoiceChange. Se genera cuando cambia el tono de voz para el sintetizador.Raised when the speaking voice for the synthesizer changes.

  • SpeakCompleted.SpeakCompleted. Se genera cuando termina el sintetizador un SpeakAsync operación.Raised when the synthesizer finishes a SpeakAsync operation.

Si la aplicación no necesita realizar tareas mientras habla, puede usar el Speak métodos o SpeakSsml método para generar voz de forma sincrónica.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)

De forma asincrónica habla el contenido de un objeto 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

Parámetros

prompt
Prompt Prompt Prompt Prompt

El contenido para hablar.The content to speak.

Ejemplos

En el ejemplo siguiente se crea un Prompt cadena en un objeto y el objeto se pasa como argumento a la SpeakAsync método.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();  
    }  
  }  
}  

Comentarios

Puede cancelar la lectura asincrónica de un símbolo del sistema con el SpeakAsyncCancel o SpeakAsyncCancelAll método.You can cancel the asynchronous speaking of a prompt with the SpeakAsyncCancel or the SpeakAsyncCancelAll method.

Para comunicar de forma sincrónica el contenido de un Prompt de objeto, utilice Speak.To synchronously speak the contents of a Prompt object, use Speak.

SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder)

De forma asincrónica habla el contenido de un objeto 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

Parámetros

promptBuilder
PromptBuilder PromptBuilder PromptBuilder PromptBuilder

El contenido para hablar.The content to speak.

Devoluciones

Devuelve el objeto que contiene el contenido para hablar.Returns the object that contains the content to speak.

Ejemplos

En el ejemplo siguiente se crea un PromptBuilder cadena en un objeto y el objeto se pasa como argumento a la SpeakAsync método.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();  
    }  
  }  
}  

Comentarios

Para comunicar de forma sincrónica el contenido de un PromptBuilder de objeto, utilice Speak.To synchronously speak the contents of a PromptBuilder object, use Speak.

SpeakAsync(String) SpeakAsync(String) SpeakAsync(String) SpeakAsync(String)

De forma asincrónica habla el contenido de una cadena.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

Parámetros

textToSpeak
String String String String

Texto para hablar.The text to speak.

Devoluciones

Devuelve el objeto que contiene el contenido para hablar.Returns the object that contains the content to speak.

Ejemplos

Como se muestra en el ejemplo siguiente, la SpeakAsync método proporciona los medios más sencillos para generar voz de salida de forma asincrónica.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();  
    }  
  }  
}  

Comentarios

Para hablar de forma asincrónica una cadena que contiene el marcado SSML, utilice el SpeakSsmlAsync método.To asynchronously speak a string that contains SSML markup, use the SpeakSsmlAsync method. Para comunicar sincrónicamente el contenido de una cadena, utilice el Speak método.To synchronously speak the contents of a string, use the Speak method. Puede cancelar la lectura asincrónica de un símbolo del sistema con el SpeakAsyncCancel o SpeakAsyncCancelAll método.You can cancel the asynchronous speaking of a prompt with the SpeakAsyncCancel or the SpeakAsyncCancelAll method.

Se aplica a