Freigeben über

PromptBuilder.AppendSsml Methode

Definition

Namespace:
System.Speech.Synthesis
Assembly:
System.Speech.dll
Paket:
System.Speech v11.0.0-preview.3.26207.106

Fügt eine SSML-Datei an ein PromptBuilder Objekt an.

Überlädt

Name Beschreibung
AppendSsml(String)

Fügt die SSML-Datei an den angegebenen Pfad an das PromptBuilder Objekt an.
AppendSsml(Uri)

Fügt die SSML-Datei an den angegebenen URI an das PromptBuilder Objekt an.
AppendSsml(XmlReader)

Fügt ein XMLReader Objekt an, das auf eine SSML-Eingabeaufforderung auf das PromptBuilder Objekt verweist.

AppendSsml(String)

Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs

Fügt die SSML-Datei an den angegebenen Pfad an das PromptBuilder Objekt an.

public:
 void AppendSsml(System::String ^ path);
public void AppendSsml(string path);
member this.AppendSsml : string -> unit
Public Sub AppendSsml (path As String)

Parameter

path
String

Ein vollqualifizierter Pfad zur anzufügenden SSML-Datei.

Beispiele

Im folgenden Beispiel wird ein PromptBuilder Objekt erstellt und der Inhalt einer SSML-Datei mithilfe der AppendSsml Methode 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 file that defines an SSML prompt.
        PromptBuilder ssmlFile = new PromptBuilder();
        ssmlFile.AppendSsml("c:\\test\\Weather.ssml");

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

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

Es folgt die SSML-Datei, auf die im vorherigen Beispiel verwiesen wird.

<?xml version="1.0" encoding="ISO-8859-1"?>
<speak version="1.0"
 xmlns="http://www.w3.org/2001/10/synthesis"
 xml:lang="en-US">

  <s> The weather forecast for today is partly cloudy with some sun breaks. </s>

</speak>

Hinweise

Die SSML-Datei muss eine XML-Formatdatei sein, die der SSML-Spezifikation (Speech Synthesis Markup Language) Version 1.0 entspricht.

Sie können SSML-Markup auch als Zeichenfolge mithilfe einer AppendSsmlMarkupZeichenfolge anfügen.

Gilt für:

AppendSsml(Uri)

Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs

Fügt die SSML-Datei an den angegebenen URI an das PromptBuilder Objekt an.

public:
 void AppendSsml(Uri ^ ssmlFile);
public void AppendSsml(Uri ssmlFile);
member this.AppendSsml : Uri -> unit
Public Sub AppendSsml (ssmlFile As Uri)

Parameter

ssmlFile
Uri

Ein vollqualifizierter URI für die anzufügende SSML-Datei.

Beispiele

Im folgenden Beispiel wird ein PromptBuilder Objekt erstellt und der Inhalt einer SSML-Datei mithilfe der AppendSsml Methode 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 file that defines an SSML prompt.
        PromptBuilder ssmlFile = new PromptBuilder();
        ssmlFile.AppendSsml(new Uri("c:\\test\\Weather.ssml"));

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

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

Es folgt die SSML-Datei, auf die im vorherigen Beispiel verwiesen wird.

<?xml version="1.0" encoding="ISO-8859-1"?>
<speak version="1.0"
 xmlns="http://www.w3.org/2001/10/synthesis"
 xml:lang="en-US">

  <s> The weather forecast for today is partly cloudy with some sun breaks. </s>

</speak>

Hinweise

Die SSML-Datei muss eine XML-Formatdatei sein, die der SSML-Spezifikation (Speech Synthesis Markup Language) Version 1.0 entspricht.

Sie können SSML-Markup auch als Zeichenfolge mithilfe einer AppendSsmlMarkupZeichenfolge anfügen.

Important

Das Aufrufen von Methoden aus dieser Klasse mit nicht vertrauenswürdigen Daten ist ein Sicherheitsrisiko. Rufen Sie die Methoden aus dieser Klasse nur mit vertrauenswürdigen Daten auf. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Gilt für:

AppendSsml(XmlReader)

Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs

Fügt ein XMLReader Objekt an, das auf eine SSML-Eingabeaufforderung auf das PromptBuilder Objekt verweist.

public:
 void AppendSsml(System::Xml::XmlReader ^ ssmlFile);
public void AppendSsml(System.Xml.XmlReader ssmlFile);
member this.AppendSsml : System.Xml.XmlReader -> unit
Public Sub AppendSsml (ssmlFile As XmlReader)

Parameter

ssmlFile
XmlReader

Ein vollqualifizierter Name für die ANzufügende XML-Datei.

Beispiele

Im folgenden Beispiel wird ein PromptBuilder Objekt aus einem XmlReader Objekt erstellt, das auf eine Datei verweist, die das SSML-Markup (Speech Synthesis Markup Language) enthält.

using System;
using System.Xml;
using System.IO;
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.SetOutputToWaveFile(@"C:\test\weather.wav");

        // Create a SoundPlayer instance to play the output audio file.
        System.Media.SoundPlayer m_SoundPlayer =
          new System.Media.SoundPlayer(@"C:\test\weather.wav");

        // Create the path to the SSML file.
        string weatherFile = Path.GetFullPath("c:\\test\\Weather.xml");
        PromptBuilder builder = null;

        // Create an XML Reader from the file, create a PromptBuilder and
        // append the XmlReader.
        if (File.Exists(weatherFile))
        {
          XmlReader reader = XmlReader.Create(weatherFile);
          builder = new PromptBuilder();
          builder.AppendSsml(reader);
          reader.Close();
        }

        // Speak the prompt and play back the output file.
        synth.Speak(builder);
        m_SoundPlayer.Play();
      }

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

Hinweise

Important

Die Verwendung einer Instanz dieses Typs mit nicht vertrauenswürdigen Daten ist ein Sicherheitsrisiko. Verwenden Sie dieses Objekt nur mit vertrauenswürdigen Daten. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Die SSML-Datei muss eine XML-Formatdatei sein, die der SSML-Spezifikation (Speech Synthesis Markup Language) Version 1.0 entspricht.

Sie können SSML-Markup auch als Zeichenfolge mithilfe einer AppendSsmlMarkupZeichenfolge anfügen.

Gilt für: