PromptBuilder.AppendText Método

Definición

Espacio de nombres:

System.Speech.Synthesis

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v9.0.0-preview.3.24172.9

Anexa texto al objeto PromptBuilder.

Sobrecargas

AppendText(String)	Especifica el texto que se va a anexar al objeto PromptBuilder.
AppendText(String, PromptEmphasis)	Anexa texto al objeto PromptBuilder y especifica el grado de énfasis para el texto.
AppendText(String, PromptRate)	Anexa texto al objeto PromptBuilder y especifica la velocidad con que se va a decir el texto.
AppendText(String, PromptVolume)	Anexa texto al objeto PromptBuilder y especifica el volumen con que se va a decir el texto.

AppendText(String)

Source:

PromptBuilder.cs

Especifica el texto que se va a anexar al objeto PromptBuilder.

public:
 void AppendText(System::String ^ textToSpeak);

public void AppendText (string textToSpeak);

member this.AppendText : string -> unit

Public Sub AppendText (textToSpeak As String)

Parámetros

textToSpeak

String

Cadena que contiene el texto que se va a decir.

Ejemplos

En el ejemplo siguiente se crea un PromptBuilder objeto y se anexa una cadena de texto mediante el AppendText método .

using System;  
using System.Speech.Synthesis;  

namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  

        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  

        // Create a PromptBuilder object and append a text string.  
        PromptBuilder speakText = new PromptBuilder();  
        speakText.AppendText("Say the name of the song you want to hear");  

        // Speak the contents of the prompt.  
        synth.Speak(speakText);  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

Comentarios

Para anexar texto con formato de lenguaje de marcado SSML, use AppendSsmlMarkup.

AppendText(String, PromptEmphasis)

Source:

PromptBuilder.cs

Anexa texto al objeto PromptBuilder y especifica el grado de énfasis para el texto.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptEmphasis emphasis);

public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptEmphasis emphasis);

member this.AppendText : string * System.Speech.Synthesis.PromptEmphasis -> unit

Public Sub AppendText (textToSpeak As String, emphasis As PromptEmphasis)

Parámetros

textToSpeak

String

Cadena que contiene el texto que se va a decir.

emphasis

PromptEmphasis

Valor del énfasis que se va a aplicar al texto.

Comentarios

Los motores de síntesis de voz de Windows no admiten el parámetro de énfasis en este momento. Establecer valores para el parámetro de énfasis no producirá ningún cambio audible en la salida de voz sintetizada.

AppendText(String, PromptRate)

Source:

PromptBuilder.cs

Anexa texto al objeto PromptBuilder y especifica la velocidad con que se va a decir el texto.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptRate rate);

public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptRate rate);

member this.AppendText : string * System.Speech.Synthesis.PromptRate -> unit

Public Sub AppendText (textToSpeak As String, rate As PromptRate)

Parámetros

textToSpeak

String

Cadena que contiene el texto que se va a decir.

rate

PromptRate

Valor de la velocidad de habla que se va a aplicar al texto.

Ejemplos

En el ejemplo siguiente se crea un PromptBuilder objeto y se anexan cadenas de texto. En el ejemplo se usa el AppendText método para especificar una velocidad de habla lenta para la cadena que se va a agregar, que enumera el contenido de un pedido.

using System;  
using System.Speech.Synthesis;  

namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  

        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  

        // Create a PromptBuilder object and add content.  
        PromptBuilder speakRate = new PromptBuilder();  
        speakRate.AppendText("Your order for");  
        speakRate.AppendText("one kitchen sink and one faucet", PromptRate.Slow);  
        speakRate.AppendText("has been confirmed.");  

        // Speak the contents of the SSML prompt.  
        synth.Speak(speakRate);  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

AppendText(String, PromptVolume)

Source:

PromptBuilder.cs

Anexa texto al objeto PromptBuilder y especifica el volumen con que se va a decir el texto.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptVolume volume);

public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptVolume volume);

member this.AppendText : string * System.Speech.Synthesis.PromptVolume -> unit

Public Sub AppendText (textToSpeak As String, volume As PromptVolume)

Parámetros

textToSpeak

String

Cadena que contiene el texto que se va a decir.

volume

PromptVolume

Valor del volumen de habla que se va a aplicar al texto.

Ejemplos

En el ejemplo siguiente se usa el método para especificar la AppendText configuración del volumen que se debe aplicar a la SpeechSynthesizer salida de voz.

using System;  
using System.Speech.Synthesis;  

namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  

        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  

        // Build a prompt that applies different volume settings.  
        PromptBuilder builder = new PromptBuilder();  
        builder.AppendText("This is the default speaking volume.", PromptVolume.Default);  
        builder.AppendBreak();  
        builder.AppendText("This is the extra loud speaking volume.", PromptVolume.ExtraLoud);  
        builder.AppendBreak();  
        builder.AppendText("This is the medium speaking volume.", PromptVolume.Medium);  

        // Speak the prompt.  
        synth.Speak(builder);  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

Comentarios

El Default valor de PromptVolume es el volumen completo, que es el mismo ExtraLoudque . La otra configuración reduce el volumen de salida de voz en relación con el volumen completo.