SpeechSynthesizer.AddLexicon(Uri, String) 方法

定義

命名空間:

System.Speech.Synthesis

組件:

System.Speech.dll

套件:

System.Speech v9.0.0-rc.2.24473.5

來源:

SpeechSynthesizer.cs

將字典加入至 SpeechSynthesizer 物件。

public:
 void AddLexicon(Uri ^ uri, System::String ^ mediaType);

public void AddLexicon (Uri uri, string mediaType);

member this.AddLexicon : Uri * string -> unit

Public Sub AddLexicon (uri As Uri, mediaType As String)

參數

uri

Uri

語彙資訊的位置。

mediaType

String

字典的媒體類型。 媒體類型不區分大小寫。

範例

下列範例示範新增和移除語彙的效果，其中包含 「blue」 一詞的自定義發音。 語彙會定義 「blue」 的發音，如 「bleep」。 載入語彙時，語音合成器會使用語彙中所定義的發音。

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

        // Speak the prompt.
        synth.Speak("My favorite color is blue.");

        // Add a lexicon that changes the pronunciation of "blue".
        synth.AddLexicon(new Uri("C:\\test\\Blue.pls"), "application/pls+xml");

        // Speak the prompt.
        synth.Speak("My favorite color is blue.");

        // Remove the lexicon.
        synth.RemoveLexicon(new Uri("C:\\test\\Blue.pls"));

        // Speak the prompt.
        synth.Speak("My favorite color is blue.");
      }

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

以下是Blue.pls 檔案的語彙內容：

<?xml version="1.0" encoding="UTF-8"?>

<lexicon version="1.0"
      xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
      alphabet="x-microsoft-ups" xml:lang="en-US">

  <lexeme>
    <grapheme> blue </grapheme>
    <phoneme> B L I P </phoneme>
  </lexeme>

</lexicon>

備註

發音語彙是單字或片語的集合，以及其發音，由支援的注音字母和字元所組成。 您可以使用語彙來指定應用程式中特製化詞彙的自定義發音。

外部語彙檔案中指定的發音優先於語音合成器的內部語彙或字典的發音。 不過，使用任何 AppendTextWithPronunciation、 AppendSsmlMarkup或 AppendSsml 方法所建立的提示內嵌指定的發音優先於任何語匯中所指定的發音。 內嵌發音僅適用於單一出現的單字。 如需詳細資訊，請參閱 Lexicons 和注音字母 。

您可以將多個語彙新增至 SpeechSynthesizer 物件。 參數目前支援兩個 mediaType 值：

• 值 application/pls+xml 表示語 彙符合發音語匯規格 (PLS) 1.0 版。 這是慣用的格式。

• 值 application/vdn.ms-sapi-lex 表示語彙格式為 Uncompressed Lexicon，這是 Microsoft 專屬的格式。 這是舊版格式，建議您使用上述 PLS 格式。

另請參閱

• RemoveLexicon(Uri)