PromptBuilder.AppendText Methode

Definition

Namespace:

System.Speech.Synthesis

Assembly:

System.Speech.dll

Paket:

System.Speech v9.0.0-preview.3.24172.9

Fügt Text an das PromptBuilder-Objekt an.

Überlädt

AppendText(String)	Bezeichnet Text, der an das Objekt PromptBuilder anzufügen ist.
AppendText(String, PromptEmphasis)	Fügt Text an das PromptBuilder-Objekt an und gibt den Grad der Betonung für den Text an.
AppendText(String, PromptRate)	Fügt Text an das PromptBuilder-Objekt an und gibt die Sprechgeschwindigkeit für den Text an.
AppendText(String, PromptVolume)	Fügt Text an das PromptBuilder-Objekt an und gibt die Lautstärke an, mit der der Text gesprochen werden soll.

AppendText(String)

Quelle:

PromptBuilder.cs

Bezeichnet Text, der an das Objekt PromptBuilder anzufügen ist.

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

public void AppendText (string textToSpeak);

member this.AppendText : string -> unit

Public Sub AppendText (textToSpeak As String)

Parameter

textToSpeak

String

Eine Zeichenfolge, die den zu sprechenden Text enthält.

Beispiele

Im folgenden Beispiel wird ein PromptBuilder -Objekt erstellt und mithilfe der AppendText -Methode eine Textzeichenfolge angefügt.

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

Hinweise

Verwenden Sie AppendSsmlMarkupzum Anfügen von Text, der als SSML-Markupsprache formatiert ist.

AppendText(String, PromptEmphasis)

Quelle:

PromptBuilder.cs

Fügt Text an das PromptBuilder-Objekt an und gibt den Grad der Betonung für den Text an.

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)

Parameter

textToSpeak

String

Eine Zeichenfolge, die den zu sprechenden Text enthält.

emphasis

PromptEmphasis

Der auf den Text anzuwendende Wert für Nachdruck oder Betonung.

Hinweise

Die Sprachsynthese-Engines in Windows unterstützen den Betonungsparameter derzeit nicht. Das Festlegen von Werten für den Hervorhebungsparameter führt zu keiner hörbaren Änderung der synthetisierten Sprachausgabe.

AppendText(String, PromptRate)

Quelle:

PromptBuilder.cs

Fügt Text an das PromptBuilder-Objekt an und gibt die Sprechgeschwindigkeit für den Text an.

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)

Parameter

textToSpeak

String

Eine Zeichenfolge, die den zu sprechenden Text enthält.

rate

PromptRate

Der auf den Text anzuwendende Wert für die Sprechgeschwindigkeit.

Beispiele

Im folgenden Beispiel wird ein PromptBuilder -Objekt erstellt und Textzeichenfolgen angefügt. Im Beispiel wird die AppendText -Methode verwendet, um eine langsame Sprechrate für die hinzugefügte Zeichenfolge anzugeben, die den Inhalt einer Reihenfolge aufzählt.

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)

Quelle:

PromptBuilder.cs

Fügt Text an das PromptBuilder-Objekt an und gibt die Lautstärke an, mit der der Text gesprochen werden soll.

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)

Parameter

textToSpeak

String

Eine Zeichenfolge, die den zu sprechenden Text enthält.

volume

PromptVolume

Der auf den Text anzuwendende Wert für die Sprecherlautstärke.

Beispiele

Im folgenden Beispiel wird die AppendText -Methode verwendet, um Lautstärkeeinstellungen anzugeben, die auf die SpeechSynthesizer Sprachausgabe angewendet werden sollen.

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

Hinweise

Die Default Einstellung für PromptVolume ist die vollständige Lautstärke, die mit identisch ExtraLoudist. Die anderen Einstellungen verringern die Lautstärke der Sprachausgabe relativ zur vollen Lautstärke.