TextFragment 類別

定義

命名空間:

System.Speech.Synthesis.TtsEngine

組件:

System.Speech.dll

包含語音合成器引擎所使用的文字和語音屬性資訊。

public ref class TextFragment

public class TextFragment

type TextFragment = class

Public Class TextFragment

繼承

Object

TextFragment

範例

下列範例是自訂語音合成衍生的一部分 TtsEngineSsml ，並使用 TextFragment 、 SpeechEventInfo 、和來執行 FragmentState TtsEventId 。

的執行 Speak

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

   在 TextOffset TextLength 新的 TextFragment 實例上建立時，請特別小心使用 TextToSpeak TextFragment 。

2. 如果在 TtsEngineAction Action FragmentState State 每個實例之屬性所傳回的屬性中找到列舉值，則 TextFragment 會 Speak 執行

   • 將要說出的文字中的 Americanism 轉譯為 Britishisms。

   • 如果 EventInterest 提供給實作為的介面上的屬性 ITtsEngineSite 支援 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);  

}  

備註

語音平臺基礎結構會解壓縮 SSML 輸入的 XML 架構結構，並建立 TextFragment 物件。

語音內容可透過實例的 TextLength 、 TextOffset 和 TextToSpeak 屬性取得 TextFragment 。

語音屬性資訊（例如強調、音調和速率）是從 FragmentState 屬性傳回的物件取得 TextFragment State 。

建構函式

TextFragment()

建構 TextFragment 的新執行個體。

屬性

State	取得或設定 TextFragment 的語音屬性資訊。
TextLength	取得或設定片段中語音文字的長度。
TextOffset	取得或設定片段中文字起始的位置。
TextToSpeak	取得或設定片段的語音文字。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)