TtsEventId 列舉

定義

命名空間:

System.Speech.Synthesis.TtsEngine

組件:

System.Speech.dll

列舉語音合成器事件的類型。

public enum class TtsEventId

public enum TtsEventId

type TtsEventId = 

Public Enum TtsEventId

繼承

Object

ValueType

Enum

TtsEventId

欄位

AudioLevel	9	識別語音合成引擎在說出時完成音訊層級變更時所產生的事件。
Bookmark	4	識別語音合成引擎在說出時遇到書籤時所產生的事件。
EndInputStream	2	識別語音合成引擎在說出時遇到輸入資料流結尾時所產生的事件。
Phoneme	6	識別語音合成引擎完成說出音素時所產生的事件。
SentenceBoundary	7	識別語音合成引擎完成說出句子時所產生的事件。
StartInputStream	1	識別語音合成引擎開始說出資料流時所產生的事件。
Viseme	8	識別語音合成引擎完成說出視素 (Viseme) 時所產生的事件。
VoiceChange	3	識別語音合成引擎在說出時遇到語音變更時所產生的事件。
WordBoundary	5	識別語音合成引擎完成說出單字時所產生的事件。

範例

下列範例是自訂語音合成實作為繼承自的， TtsEngineSsml 以及使用 TextFragment 、 SpeechEventInfo 、 FragmentState 和 TtsEventId 類別的一部分。

的執行 TtsEngineSsml.Speak 包括下列步驟：

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

2. 如果 Action 每個實例的屬性 TextFragment.State 都等於 TtsEngineAction.Speak ，則程式碼會執行下列動作：

   • 將文字中要說出的美式英文轉譯成英屬。

   • 如果 ITtsEngineSite.EventInterest 提供給實作為的屬性支援 WordBoundary 事件種類，則 SpeechEventInfo 會使用實例來建立事件，以建立可驅動合成器進度計量的事件。

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

}

備註

自訂語音合成引擎會使用來定義提交給語音平臺合成器基礎結構的事件種類 TtsEventId 。

藉由設定 EventId 傳遞給類別成員的實例屬性（property），來執行在 SpeechEventInfo AddEvents ITtsEngineSite Speak 自訂語音引擎的執行時傳遞給方法的介面 TtsEngineSsml 。

語音平臺基礎結構會透過 EventInterest ITtsEngineSite 傳遞給說話執行的上的屬性，來指出目前正在處理的事件種類。

的值 EventInterest 是位元遮罩，其中的成員會 TtsEventId 定義對應于事件種類的位位置。 例如，WordBoundary 的值為 5 (5) ，表示所傳回值中的第五個位 EventInterest 指出網站是否支援事件種類。