TextFragment Klasse

Definition

Namespace:

System.Speech.Synthesis.TtsEngine

Assembly:

System.Speech.dll

Paket:

System.Speech v11.0.0-preview.2.26159.112

Quelle:

TTSEngineTypes.cs

Enthält Text- und Sprachattributinformationen für die Nutzung durch ein Sprachsynthesizermodul.

public ref class TextFragment

public class TextFragment

type TextFragment = class

Public Class TextFragment

Vererbung

Object

TextFragment

Beispiele

Das folgende Beispiel ist Teil einer benutzerdefinierten Sprachsyntheseimplementierung, die von TtsEngineSsml, und die Verwendung von TextFragment, , SpeechEventInfo, FragmentStateund TtsEventId.

Die Umsetzung der Speak

1. Empfängt ein Array von Instanzen und erstellt ein neues Array von TextFragmentTextFragment Instanzen, das an die Speak Methode für ein zugrunde liegendes Synthesemodul übergeben werden soll.

   Besondere Sorgfalt wird verwendet, um das TextOffsetTextLength Original TextFragment beim Erstellen der TextToSpeak neuen TextFragment Instanzen zu respektieren.

2. Wenn der TtsEngineAction Enumerationswert, der von der Action Eigenschaft für die FragmentState von der State Eigenschaft jeder TextFragment Instanz zurückgegeben wird, gefunden wird, lautet Speakdie Implementierung

   • Übersetzt den Amerikanischen Inserismus in den zu sprechenden Text.

   • Wenn die Eigenschaft für die EventInterestITtsEngineSite Schnittstellen, die der Implementierung bereitgestellt werden, den WordBoundary Ereignistyp unterstützen, wird eine SpeechEventInfo Instanz verwendet, um ein Ereignis zu erstellen, um eine Synthesizer-Statusanzeige zu steuern.

3. Anschließend wird ein Sprachrenderingmodul mit dem geänderten TextFragment Array aufgerufen.

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 Sprachplattforminfrastruktur entpackt die XML-basierte Struktur der SSML-Eingabe und erstellt TextFragment Objekte.

Sprachinhalte sind über die TextLengthEigenschaften TextOffsetTextToSpeak und Eigenschaften einer TextFragment Instanz verfügbar.

Sprachattributinformationen, z. B. Hervorhebung, Neigung und Rate, werden aus dem FragmentState von der TextFragmentState Eigenschaft zurückgegebenen Objekt abgerufen.

Konstruktoren

Name	Beschreibung
TextFragment()	Erstellt eine neue Instanz von TextFragment.

Eigenschaften

Name	Beschreibung
State	Dient zum Abrufen oder Festlegen von Sprachattributinformationen für ein TextFragment.
TextLength	Ruft die Länge des Sprachtexts im Fragment ab oder legt sie fest.
TextOffset	Dient zum Abrufen oder Festlegen der Anfangsposition des Texts im Fragment.
TextToSpeak	Dient zum Abrufen oder Festlegen des Sprachtexts des Fragments.