共用方式為


TtsEngineAction 列舉

定義

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

public enum class TtsEngineAction
public enum TtsEngineAction
type TtsEngineAction = 
Public Enum TtsEngineAction
繼承
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 屬性所 StateDuration 回之 物件的 屬性 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 的自訂語音合成實作的一部分,並使用 TextFragmentFragmentStateTtsEventId

的實作 Speak

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

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

  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 語音合成實作所處理。

適用於