Partilhar via


SpeechSynthesizer.SpeakSsml(String) Método

Definição

Fala de forma síncrona uma String que contém marcação SSML.

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

A cadeia de caracteres SSML a ser falada.

Exemplos

O exemplo a seguir renderiza a data 29/1/2009 como uma data, no mês, dia, ordem do ano.

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();
    }
  }
}

Comentários

O conteúdo do textToSpeak parâmetro deve incluir um speak elemento e deve estar em conformidade com o SSML (Speech Synthesis Markup Language) versão 1.0. Para obter mais informações, consulte Referência da linguagem de marcação de síntese de fala.

Para falar de forma assíncrona uma cadeia de caracteres que contém marcação SSML, use o SpeakSsmlAsync método . Você pode usar Speak para iniciar a fala síncrona de uma cadeia de caracteres que não contém marcação SSML.

Durante uma chamada para esse método, o SpeechSynthesizer pode gerar os seguintes eventos:

  • StateChanged. Gerado quando o estado de fala do sintetizador é alterado.

  • SpeakStarted. Gerado quando o sintetizador começa a gerar fala.

  • PhonemeReached. Gerado sempre que o sintetizador atinge uma letra ou combinação de letras que constituem um som discreto de fala em uma linguagem.

  • SpeakProgress. Gerado sempre que o sintetizador conclui falando uma palavra.

  • VisemeReached. Gerado sempre que a saída falada requer uma mudança na posição da boca ou nos músculos faciais usados para produzir fala.

  • BookmarkReached. Gerado quando o sintetizador encontra um indicador em um prompt.

  • VoiceChange. Gerado quando a voz de fala para o sintetizador é alterada.

O SpeechSynthesizer não gera o evento durante o SpeakCompleted processamento do SpeakSsml método.

Aplica-se a