PromptBuilder.AppendText Метод

Определение

Пространство имен:

System.Speech.Synthesis

Сборка:

System.Speech.dll

Пакет:

System.Speech v9.0.0-preview.3.24172.9

Добавляет текст в объект PromptBuilder.

Перегрузки

AppendText(String)	Указывает текст, который необходимо добавить в объект PromptBuilder.
AppendText(String, PromptEmphasis)	Добавляет текст в объект PromptBuilder и указывает степень выделения для текста.
AppendText(String, PromptRate)	Добавляет текст в объект PromptBuilder и указывает скорость озвучивания текста.
AppendText(String, PromptVolume)	Добавляет текст в объект PromptBuilder и указывает громкость озвучивания текста.

AppendText(String)

Исходный код:

PromptBuilder.cs

Указывает текст, который необходимо добавить в объект PromptBuilder.

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

public void AppendText (string textToSpeak);

member this.AppendText : string -> unit

Public Sub AppendText (textToSpeak As String)

Параметры

textToSpeak

String

Строка, содержащая произносимый текст.

Примеры

Следующий пример создает PromptBuilder объект и добавляет текстовую строку с помощью AppendText метода .

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

Комментарии

Чтобы добавить текст, отформатированный как язык разметки SSML, используйте AppendSsmlMarkup.

AppendText(String, PromptEmphasis)

Исходный код:

PromptBuilder.cs

Добавляет текст в объект PromptBuilder и указывает степень выделения для текста.

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)

Параметры

textToSpeak

String

Строка, содержащая произносимый текст.

emphasis

PromptEmphasis

Значение выделения, которое необходимо применить к тексту.

Комментарии

Подсистемы синтеза речи в Windows в настоящее время не поддерживают параметр выделения. Установка значений для параметра выделения не приведет к звуковым изменениям в синтезированных речевых выходных данных.

AppendText(String, PromptRate)

Исходный код:

PromptBuilder.cs

Добавляет текст в объект PromptBuilder и указывает скорость озвучивания текста.

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)

Параметры

textToSpeak

String

Строка, содержащая произносимый текст.

rate

PromptRate

Значение скорости озвучивания, которое необходимо применить к тексту.

Примеры

В следующем примере создается PromptBuilder объект и добавляются текстовые строки. В примере метод используется AppendText для указания скорости медленной речи для добавляемой строки, которая перечисляет содержимое порядка.

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)

Исходный код:

PromptBuilder.cs

Добавляет текст в объект PromptBuilder и указывает громкость озвучивания текста.

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)

Параметры

textToSpeak

String

Строка, содержащая произносимый текст.

volume

PromptVolume

Значение громкости озвучивания, которое необходимо применить к тексту.

Примеры

В следующем примере метод используется для AppendText указания параметров громкости SpeechSynthesizer , которые должны применяться к выходным данным речи.

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

Комментарии

Параметр Default для PromptVolume параметра — полный том, который совпадает с параметром ExtraLoud. Другие параметры уменьшают громкость выходных данных речи относительно полной громкости.