TextFragment Klasse

Definition

Enthält Attributinformationen zu Text und Sprache für die Verarbeitung durch eine Sprachsynthesizer-Engine.Contains text and speech attribute information for consumption by a speech synthesizer engine.

public ref class TextFragment
public class TextFragment
type TextFragment = class
Public Class TextFragment
Vererbung
TextFragment

Beispiele

Das folgende Beispiel ist Teil einer benutzerdefinierten Sprachsynthese Implementierung, die von, und verwendet wird, und TtsEngineSsml verwendet die Verwendung von TextFragment , SpeechEventInfo , FragmentState und TtsEventId .The example below is part of a custom speech synthesis implementation inheriting from TtsEngineSsml, and using the use of TextFragment, SpeechEventInfo, FragmentState, and TtsEventId.

Die Implementierung von SpeakThe implementation of Speak

  1. Empfängt ein Array von TextFragment -Instanzen und erstellt ein neues Array von- TextFragment Instanzen, die an die- Speak Methode in einer zugrunde liegenden Synthese-Engine weitergeleitet werden sollen.Receives an array of TextFragment instances and creates a new array of TextFragment instances to be passed to the Speak method on an underlying synthesis engine.

    Bei der TextOffset TextLength Erstellung von TextFragment TextToSpeak auf den neuen-Instanzen wird auf der Original-auf bestimmte Sorgfalt geachtet TextFragment .Particular care is used to respect the TextOffset, TextLength on the original TextFragment when creating the TextToSpeak on the new TextFragment instances.

  2. Wenn der TtsEngineAction Enumerationswert, der von der-Eigenschaft Action FragmentState der zurückgegeben wird, die von der- State Eigenschaft jeder Instanz zurückgegeben TextFragment Speak wurde, ist,If the TtsEngineAction enumeration value by found from the Action property on the FragmentState returned by the State property of each TextFragment instance is Speak, the implementation

    • Übersetzt Amerikanismus in britishisms in den zu sprechenden Text.Translates Americanism to Britishisms in the text to be spoken.

    • Wenn die- EventInterest Eigenschaft für die ITtsEngineSite Schnittstellen, die für die Implementierung bereitgestellt werden WordBoundary , den Ereignistyp unterstützt, wird eine- SpeechEventInfo Instanz verwendet, um ein Ereignis zu erstellenIf the EventInterest property on the ITtsEngineSite interfaces provided to the implementation support the WordBoundary event type, a SpeechEventInfo instance is used to create an event to drive a synthesizer progress meter is created.

  3. Anschließend wird ein sprachrenderingmodul mit dem geänderten TextFragment Array aufgerufen.A speech rendering engine is then called with the modified TextFragment array.

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

}  

Hinweise

Die sprach Platt Form Infrastruktur entpackt die XML-basierte Struktur der SSML-Eingabe und erstellt TextFragment Objekte.The Speech platform infrastructure unpacks the XML based structure of the SSML input and constructs TextFragment objects.

Sprachinhalte sind über die TextLength Eigenschaften, TextOffset und einer- TextToSpeak Instanz verfügbar TextFragment .Speech content is available through the TextLength, TextOffset, and TextToSpeak properties of a TextFragment instance.

Informationen zu sprach Attributen, wie z. b. Betonung, Tonhöhe und Rate, werden aus dem FragmentState von der-Eigenschaft zurückgegebenen-Objekt abgerufen TextFragment State .Speech attribute information, such as emphasis, pitch, and rate, are obtained from the FragmentState object returned by the TextFragmentState property.

Konstruktoren

TextFragment()

Erstellt eine neue Instanz von TextFragment.Constructs a new instance of TextFragment.

Eigenschaften

State

Ruft Sprachattributinformationen für eine TextFragment ab oder legt diese fest.Gets or sets speech attribute information for a TextFragment.

TextLength

Ruft die Länge des Sprachtexts im Fragment ab oder legt diese fest.Gets or sets the length of the speech text in the fragment.

TextOffset

Ruft die Startposition des Texts im Fragment ab oder legt diese fest.Gets or sets the starting location of the text in the fragment.

TextToSpeak

Ruft den Sprachtext des Fragments ab oder legt diesen fest.Gets or sets the speech text of the fragment.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für: