PromptBuilder.AppendText Méthode

Définition

Espace de noms:

System.Speech.Synthesis

Assembly:

System.Speech.dll

Paquet:

System.Speech v9.0.0-preview.3.24172.9

Ajoute le texte à l'objet PromptBuilder.

Surcharges

AppendText(String)	Spécifie le texte à ajouter à l'objet PromptBuilder.
AppendText(String, PromptEmphasis)	Ajoute du texte à l'objet PromptBuilder et spécifie le niveau d'importance du texte.
AppendText(String, PromptRate)	Ajoute du texte à l'objet PromptBuilder et spécifie la vitesse d'énonciation du texte.
AppendText(String, PromptVolume)	Ajoute du texte à l'objet PromptBuilder et spécifie le volume de prononciation du texte.

AppendText(String)

Source:

PromptBuilder.cs

Spécifie le texte à ajouter à l'objet PromptBuilder.

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

public void AppendText (string textToSpeak);

member this.AppendText : string -> unit

Public Sub AppendText (textToSpeak As String)

Paramètres

textToSpeak

String

Chaîne contenant le texte à énoncer.

Exemples

L’exemple suivant crée un PromptBuilder objet et ajoute une chaîne de texte à l’aide de la AppendText méthode .

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

Remarques

Pour ajouter du texte mis en forme en tant que langage de balisage SSML, utilisez AppendSsmlMarkup.

AppendText(String, PromptEmphasis)

Source:

PromptBuilder.cs

Ajoute du texte à l'objet PromptBuilder et spécifie le niveau d'importance du texte.

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)

Paramètres

textToSpeak

String

Chaîne contenant le texte à énoncer.

emphasis

PromptEmphasis

Valeur de l'importance ou de la contrainte à appliquer au texte.

Remarques

Les moteurs de synthèse vocale dans Windows ne prennent pas en charge le paramètre d’accentuation pour le moment. La définition des valeurs pour le paramètre d’accentuation ne produit aucune modification audible dans la sortie vocale synthétisée.

AppendText(String, PromptRate)

Source:

PromptBuilder.cs

Ajoute du texte à l'objet PromptBuilder et spécifie la vitesse d'énonciation du texte.

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)

Paramètres

textToSpeak

String

Chaîne contenant le texte à énoncer.

rate

PromptRate

Valeur de la vitesse d'énonciation qui s'applique au texte.

Exemples

L’exemple suivant crée un PromptBuilder objet et ajoute des chaînes de texte. L’exemple utilise la AppendText méthode pour spécifier un taux de langage lent pour la chaîne ajoutée, qui énumère le contenu d’une commande.

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

Ajoute du texte à l'objet PromptBuilder et spécifie le volume de prononciation du texte.

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)

Paramètres

textToSpeak

String

Chaîne contenant le texte à énoncer.

volume

PromptVolume

Valeur du volume d'énonciation (profondeur sonore) à appliquer au texte.

Exemples

L’exemple suivant utilise la AppendText méthode pour spécifier les paramètres de volume que le doit appliquer à la SpeechSynthesizer sortie vocale.

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

Remarques

Le Default paramètre pour PromptVolume est le volume complet, qui est le même que ExtraLoud. Les autres paramètres réduisent le volume de la sortie vocale par rapport au volume total.