PromptBuilder.AppendSsml 메서드

정의

SSML 파일을 PromptBuilder 개체에 추가합니다.Appends an SSML file to a PromptBuilder object.

오버로드

AppendSsml(String)

지정된 경로의 SSML 파일을 PromptBuilder 개체에 추가합니다.Appends the SSML file at the specified path to the PromptBuilder object.

AppendSsml(Uri)

지정된 URI의 SSML 파일을 PromptBuilder 개체에 추가합니다.Appends the SSML file at the specified URI to the PromptBuilder object.

AppendSsml(XmlReader)

SSML 프롬프트를 참조하는 XMLReader 개체를 PromptBuilder 개체에 추가합니다.Appends an XMLReader object that references an SSML prompt to the PromptBuilder object.

AppendSsml(String)

지정된 경로의 SSML 파일을 PromptBuilder 개체에 추가합니다.Appends the SSML file at the specified path to the PromptBuilder object.

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

매개 변수

path
String

추가할 SSML 파일의 정규화된 경로입니다.A fully qualified path to the SSML file to append.

예제

뒤에 나오는 예제 만듭니다는 PromptBuilder 개체를 사용 하 여 SSML 파일의 내용을 추가 AppendSsml 메서드.The example that follows creates a PromptBuilder object and appends the contents of an SSML file using the AppendSsml method.

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

다음은 앞의 예제를 참조 하는 SSML 파일입니다.The following is the SSML file that the preceding example references.

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

설명

SSML 파일에는 준수 하는 XML 서식 파일을 해야 합니다 Speech Synthesis Markup Language (SSML) 버전 1.0 사양입니다.The SSML file must be an XML-format file that conforms to the Speech Synthesis Markup Language (SSML) Version 1.0 specification.

SSML 태그를 사용 하 여 문자열을 추가할 수 있습니다 AppendSsmlMarkup합니다.You can also append SSML markup as a string using AppendSsmlMarkup.

AppendSsml(Uri)

지정된 URI의 SSML 파일을 PromptBuilder 개체에 추가합니다.Appends the SSML file at the specified URI to the PromptBuilder object.

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

매개 변수

ssmlFile
Uri

추가할 SSML 파일의 정규화된 URI입니다.A fully qualified URI to the SSML file to append.

예제

뒤에 나오는 예제 만듭니다는 PromptBuilder 개체를 사용 하 여 SSML 파일의 내용을 추가 AppendSsml 메서드.The example that follows creates a PromptBuilder object and appends the contents of an SSML file using the AppendSsml method.

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

다음은 앞의 예제를 참조 하는 SSML 파일입니다.The following is the SSML file that the preceding example references.

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

설명

SSML 파일에는 준수 하는 XML 서식 파일을 해야 합니다 Speech Synthesis Markup Language (SSML) 버전 1.0 사양입니다.The SSML file must be an XML-format file that conforms to the Speech Synthesis Markup Language (SSML) Version 1.0 specification.

SSML 태그를 사용 하 여 문자열을 추가할 수 있습니다 AppendSsmlMarkup합니다.You can also append SSML markup as a string using AppendSsmlMarkup.

AppendSsml(XmlReader)

SSML 프롬프트를 참조하는 XMLReader 개체를 PromptBuilder 개체에 추가합니다.Appends an XMLReader object that references an SSML prompt to the PromptBuilder object.

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)

매개 변수

ssmlFile
XmlReader

추가할 XML 파일의 정규화된 이름입니다.A fully qualified name to the XML file to append.

예제

다음 예제는 PromptBuilder 에서 개체를 XmlReader Speech Synthesis Markup Language (SSML) 태그를 포함 하는 파일을 참조 하는 개체입니다.The following example creates a PromptBuilder object from an XmlReader object that references a file containing Speech Synthesis Markup Language (SSML) markup.

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

설명

SSML 파일에는 준수 하는 XML 서식 파일을 해야 합니다 Speech Synthesis Markup Language (SSML) 버전 1.0 사양입니다.The SSML file must be an XML-format file that conforms to the Speech Synthesis Markup Language (SSML) Version 1.0 specification.

SSML 태그를 사용 하 여 문자열을 추가할 수 있습니다 AppendSsmlMarkup합니다.You can also append SSML markup as a string using AppendSsmlMarkup.

적용 대상