TtsEngineAction 列舉

定義

命名空間:

System.Speech.Synthesis.TtsEngine

組件:

System.Speech.dll

套件:

System.Speech v8.0.0

Source:

TTSEngineTypes.cs

指定呈現指定之 TextFragment 要採取的語音合成標記語言 (SSML) 動作。

public enum class TtsEngineAction

public enum TtsEngineAction

type TtsEngineAction = 

Public Enum TtsEngineAction

繼承

Object

ValueType

Enum

TtsEngineAction

欄位

Bookmark	3	表示 TextFragment 是做為書籤的內容。 它會對應至 <mark> SSML 規格中的 XML 標記。
ParseUnknownTag	7	表示尚未從 SSML 輸入決定採取任何動作。 根據合成引擎的判斷，可能會解譯或忽略這項輸入。 關聯的 TextFragment 是未知的 XML 標記，不是 SSML 標準的一部分。
Pronounce	2	要求輸入 TextFragment 文字被解譯為音素。 確切發音是由 TextFragment 執行個體上 State 屬性所傳回 FragmentState 物件的 Phoneme 成員指定。 它會對應至 <Phoneme> SSML 規格中的 XML 標記。
Silence	1	表示 TextFragment 不包含要轉譯為語音的文字。 無聲的持續時間是由 實例上 TextFragment 屬性所 State 傳 Duration 回之 物件的 屬性 FragmentState 所指定。 它會對應至 <Silence> SSML 規格中的 XML 標記。
Speak	0	要求相關的 TextFragment 應該加以處理並讀出。 這是 TextFragment 的預設值。 它會對應至 <speak> SSML 規格中的 XML 標記。
SpellOut	4	表示由 TextFragment 透過其 TextToSpeak 屬性提供的文字值要當做個別字元進行合成。 這個轉譯包括空白字元以外的標點符號，以及英數文字。 例如，相關聯的文字片段 「word！」 應該合成為 「w o r d 驚嘆號」。
StartParagraph	6	表示段落的狀態。 它會對應至 <p> SSML 規格中的 XML 標記。
StartSentence	5	表示句子的開頭。 它會對應至 <s> SSML 規格中的 XML 標記。

範例

下列範例是繼承自 TtsEngineSsml 的自訂語音合成實作的一部分，並使用 TextFragment 、 FragmentState 和 TtsEventId

的實作 Speak

1. 接收實例的 TextFragment 陣列，並建立新的實例陣列 TextFragment ，以傳遞至 Speak 基礎合成引擎上的 方法。

2. TtsEngineAction如果從 Action 每個 TextFragment 實例的 屬性所傳回 State 之 屬性 FragmentState 找到的列舉值為 Speak，則實作

   • 將美式原則轉譯為要說出的文字中的英式原則。

   • EventInterest如果提供給實作的 ITtsEngineSite 介面上的 屬性支援 TtsEventId.WordBoundary 事件種類，則會建立事件來驅動合成器進度表。

3. 接著會使用修改 TextFragment 的陣列呼叫語音轉譯引擎。

private const int WordBoundaryFlag = 1 << (int)TtsEventId.WordBoundary;
private readonly char[] spaces = new char[] { ' ', '\t', '\r', '\n' };
internal struct UsVsUk
{
    internal string UK;
    internal string US;
}

override public void Speak (TextFragment [] frags, IntPtr wfx, ITtsEngineSite site)
{
    TextFragment [] newFrags=new TextFragment[frags.Length];  

    for (int i=0;i<frags.Length;i++)
    {
        newFrags[i].State=frags[i].State;
        //truncate
        newFrags[i].TextToSpeak = frags[i].TextToSpeak.Substring(frags[i].TextOffset,
                                  frags[i].TextLength);
        newFrags[i].TextLength = newFrags[i].TextToSpeak.Length;
        newFrags[i].TextOffset = 0;
        if (newFrags[i].State.Action == TtsEngineAction.Speak) 
        {
            //US to UK conversion
            foreach (UsVsUk term in TransList)
            {
                newFrags[i].TextToSpeak.Replace(term.US, term.UK);
            }
            //Generate progress meter events if supported
            if ((site.EventInterest & WordBoundaryFlag) != 0)
            {
                string[] subs = newFrags[i].TextToSpeak.Split(spaces);

                foreach (string s in subs)
                {
                    int offset = newFrags[i].TextOffset;
                    SpeechEventInfo spEvent = new SpeechEventInfo((Int16)TtsEventId.WordBoundary,
                          (Int16)EventParameterType.Undefined,
                          s.Length, new IntPtr(offset));
                    offset += s.Length;
                    if (s.Trim().Length > 0) 
                    {
                        SpeechEventInfo[] events = new SpeechEventInfo[1];
                        events[0] = spEvent;
                        site.AddEvents(events, 1);
                    }
                }
            }
        }
    }

    _baseSynthesize.Speak(newFrags, wfx, site);

}

備註

TtsEngineAction 表示維護 TextFragment 的要求。 動作會與 SSML 規格中的專案緊密對應，並且會在 屬性在 上傳回的 TextToSpeak 文字上 TextFragment 實作。

與 TtsEngineAction 相關聯的 TextFragment 值是由 屬性傳 State 回。

TtsEngineAction屬性所 State 傳回值的處理是由衍生自 TtsEngineSsml 的類別上方法的 Speak 語音合成實作所處理。