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

Definición

De forma sincrónica habla un String que contiene el marcado SSML.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)

Parámetros

textToSpeak
String String String String

Cadena SSML para hablar.The SSML string to speak.

Ejemplos

En el ejemplo siguiente se representa la fecha 1/29/2009 como una fecha, en el mes, el día, el orden del año.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();  
    }  
  }  
}  

Comentarios

El contenido del textToSpeak parámetro debe incluir un speak elemento y debe ajustarse a la versión 1,0 del lenguaje de marcado de síntesis de voz (SSML).The contents of the textToSpeak parameter must include a speak element and must conform to the Speech Synthesis Markup Language (SSML) Version 1.0. Para obtener más información, vea Referencia del lenguaje de marcado de síntesis de voz.For more information, see Speech Synthesis Markup Language Reference.

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. Puede usar Speak para iniciar la lectura sincrónica de una cadena que no contiene marcado SSML.You can use Speak to initiate the synchronous speaking of a string that does not contain SSML markup.

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.

No genera el SpeakCompleted evento mientras se procesa el SpeakSsml método. SpeechSynthesizerThe SpeechSynthesizer does not raise the SpeakCompleted event while processing the SpeakSsml method.

Se aplica a