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

Los 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 SpeakAsync contenido del 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, animación de Paint, 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, SpeechSynthesizer puede generar 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 comienza a generar voz.Raised when the synthesizer begins generating speech.

  • PhonemeReached.PhonemeReached. Se produce cada vez que el sintetizador alcanza una letra o una combinación de letras que constituye 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 produce cada vez que el sintetizador finaliza la voz de una palabra.Raised each time the synthesizer completes speaking a word.

  • VisemeReached.VisemeReached. Se genera cada vez que la salida hablada requiere un cambio en la posición de la boca o los músculos faciales utilizados para generar la 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 la voz de habla del sintetizador cambia.Raised when the speaking voice for the synthesizer changes.

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

Si la aplicación no necesita realizar tareas mientras habla, puede usar los Speak métodos o el método para generar la SpeakSsml voz sincrónicamente.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 Prompt SpeakAsync se crea un objeto a partir de una cadena y se pasa el objeto como argumento al 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 mensaje con el SpeakAsyncCancel SpeakAsyncCancelAll método o.You can cancel the asynchronous speaking of a prompt with the SpeakAsyncCancel or the SpeakAsyncCancelAll method.

Para hablar sincrónicamente del contenido Prompt de un objeto Speak, use.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 PromptBuilder SpeakAsync se crea un objeto a partir de una cadena y se pasa el objeto como argumento al 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 hablar sincrónicamente del contenido PromptBuilder de un objeto Speak, use.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, SpeakAsync el método proporciona los medios más sencillos para generar la salida de voz 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 de una cadena que contiene marcado SSML SpeakSsmlAsync , use el método.To asynchronously speak a string that contains SSML markup, use the SpeakSsmlAsync method. Para decir sincrónicamente el contenido de una cadena, Speak use el método.To synchronously speak the contents of a string, use the Speak method. Puede cancelar la lectura asincrónica de un mensaje con el SpeakAsyncCancel SpeakAsyncCancelAll método o.You can cancel the asynchronous speaking of a prompt with the SpeakAsyncCancel or the SpeakAsyncCancelAll method.

Consulte también:

Se aplica a