PromptBuilder.AppendSsml Método

Definição

Espaço de Nomes:
System.Speech.Synthesis
Assemblagem:
System.Speech.dll
Pacote:
System.Speech v11.0.0-preview.4.26230.115

Adiciona um ficheiro SSML a um PromptBuilder objeto.

Sobrecargas

Name Description
AppendSsml(String)

Anexa o ficheiro SSML no caminho especificado ao PromptBuilder objeto.
AppendSsml(Uri)

Anexa o ficheiro SSML no URI especificado ao PromptBuilder objeto.
AppendSsml(XmlReader)

Adiciona um XMLReader objeto que faz referência a um prompt SSML ao PromptBuilder objeto.

AppendSsml(String)

Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs

Anexa o ficheiro SSML no caminho especificado ao PromptBuilder objeto.

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

Parâmetros

path
String

Um caminho totalmente qualificado para o ficheiro SSML para anexar.

Exemplos

O exemplo que se segue cria um PromptBuilder objeto e acrescenta o conteúdo de um ficheiro SSML usando o AppendSsml 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 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();
    }
  }
}

O seguinte é o ficheiro SSML que o exemplo anterior refere.

<?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>

Observações

O ficheiro SSML deve ser um ficheiro em formato XML que cumpra a especificação Speech Synthesis Markup Language (SSML) Versão 1.0 .

Também pode adicionar marcação SSML como uma string usando AppendSsmlMarkup.

Aplica-se a

AppendSsml(Uri)

Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs

Anexa o ficheiro SSML no URI especificado ao PromptBuilder objeto.

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

Parâmetros

ssmlFile
Uri

Um URI totalmente qualificado para o ficheiro SSML para anexar.

Exemplos

O exemplo que se segue cria um PromptBuilder objeto e acrescenta o conteúdo de um ficheiro SSML usando o AppendSsml 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 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();
    }
  }
}

O seguinte é o ficheiro SSML que o exemplo anterior refere.

<?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>

Observações

O ficheiro SSML deve ser um ficheiro em formato XML que cumpra a especificação Speech Synthesis Markup Language (SSML) Versão 1.0 .

Também pode adicionar marcação SSML como uma string usando AppendSsmlMarkup.

Importante

Chamar métodos dessa classe com dados não confiáveis é um risco de segurança. Chame os métodos dessa classe somente com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

Aplica-se a

AppendSsml(XmlReader)

Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs
Origem:
PromptBuilder.cs

Adiciona um XMLReader objeto que faz referência a um prompt SSML ao PromptBuilder objeto.

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)

Parâmetros

ssmlFile
XmlReader

Um nome totalmente qualificado ao ficheiro XML para adicionar.

Exemplos

O exemplo seguinte cria um PromptBuilder objeto a partir de um XmlReader objeto que faz referência a um ficheiro que contém marcação em Speech Synthesis Markup Language (SSML).

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

Observações

Importante

Utilizar uma instância deste tipo com dados não confiáveis é um risco de segurança. Use este objeto apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

O ficheiro SSML deve ser um ficheiro em formato XML que cumpra a especificação Speech Synthesis Markup Language (SSML) Versão 1.0 .

Também pode adicionar marcação SSML como uma string usando AppendSsmlMarkup.

Aplica-se a