PromptBuilder.AppendTextWithPronunciation(String, String) 方法

定義

命名空間:

System.Speech.Synthesis

組件:

System.Speech.dll

套件:

System.Speech v9.0.0-rc.2.24473.5

來源:

PromptBuilder.cs

將文字附加至 PromptBuilder 物件，並指定文字的發音。

public:
 void AppendTextWithPronunciation(System::String ^ textToSpeak, System::String ^ pronunciation);

public void AppendTextWithPronunciation (string textToSpeak, string pronunciation);

member this.AppendTextWithPronunciation : string * string -> unit

Public Sub AppendTextWithPronunciation (textToSpeak As String, pronunciation As String)

參數

textToSpeak

String

字串，包含使用某語言傳統字母之單字的書寫形式。

pronunciation

String

字串，包含要從國際音標 (IPA) 讀出的音素。

範例

下列範例會初始化 類別的新實例 PromptBuilder 。 然後，它會將文字字串 「My name is」 附加至 實例。 最後，它會附加包含適當名稱 「DuBois」 的字串，並指定名稱的發音。

public void ProperName()  
{  
    PromptBuilder builder = new PromptBuilder();  
    builder.AppendText("My name is");  

    // Add a proper name and its pronunciation.  
    builder.AppendTextWithPronunciation("DuBois", "duˈbwɑ");     
}  

下列標記顯示這個 PromptBuilder 物件產生的 SSML。

<speak xmlns="http://www.w3.org/2001/10/synthesis" xml:lang="en-us">  
  My name is <phoneme ph="duˈbwɑ"> DuBois </phoneme>  
</speak>  

備註

合成器會說出 參數的內容 pronunciation ，而不是 參數的內容 textToSpeak 。

在提示中指定內嵌的發音僅適用於個別出現的單字，並覆寫語音引擎或其目前作用中語彙的任何發音。 一般而言，您將會使用內嵌發音來自定義現有單字的發音，或用於不常見單字的發音，例如語音合成引擎可能不會發音和預期的適當名稱。

必須使用來自國際語音字母 (IPA) 的手機來指定內嵌發音。 手機是代表語音離散音效的字母或字元。 符合 語音合成標記語言的語音引擎 (SSML) 1.0 版規格會從 IPA 讀出手機。 若要使用其他注音字母來指定內嵌發音，請參閱 AppendSsmlMarkup。

IPA 會發佈 圖表 來列出其手機，並將其對應至 Unicode 號碼。

IPA 字母中的某些手機具有與拉丁字母中的字母相同的表示法。 在這些情況下，可以輸入拉丁字元，並具有手機的適當表示法。 因為文字中常用的拉丁字元可能會代表 IPA 電話集的數部手機，所以只要輸入拉丁字元，就可能不會產生所需的精確 IPA 電話。 其他 IPA 字母的電話必須以程式代碼表示為字元參考，其中包含 ampersand (&) 、數位符號 (#) ，以及所需手機的 Unicode 號碼，以十六進位或十進制表示，全部後面接著分號 (;) 。 例如，schwa (ə) 會以 ə表示。

若要為多個單字新增或自定義發音，例如表示地區方言，或新增教育或醫療專業領域特有的適當名稱或詞彙，請建置語彙，並使用 AddLexicon將其新增至 SpeechSynthesizer 。

另請參閱

• 國際注音關聯