TtsEngineAction TtsEngineAction TtsEngineAction TtsEngineAction Enum

Definition

Bezeichnet den Vorgang der Speech Synthesis Markup Language (SSML), der erfolgen muss, um eine angegebene TextFragment zu rendern.Specifies the Speech Synthesis Markup Language (SSML) action to be taken in rendering a given TextFragment.

public enum class TtsEngineAction
public enum TtsEngineAction
type TtsEngineAction = 
Public Enum TtsEngineAction
Vererbung
TtsEngineActionTtsEngineActionTtsEngineActionTtsEngineAction

Felder

Bookmark Bookmark Bookmark Bookmark 3

Gibt an, dass TextFragment als Inhalt eines Lesezeichens verwendet werden soll.Indicates that TextFragment is to be used as the contents of a bookmark. Es entspricht dem XML-Tag <mark> in der SSML-Spezifikation.It corresponds to the <mark> XML tag in the SSML specification.

ParseUnknownTag ParseUnknownTag ParseUnknownTag ParseUnknownTag 7

Gibt an, dass keine Aktion von der SSML-Eingabe bestimmt wurde.Indicates that no action has been determined from SSML input. Diese Eingabe kann nach Ermessen einer Synthese-Engine interpretiert oder ignoriert werden.This input that may be interpreted or ignored by at the discretion of a synthesis engine. Das zugeordnete TextFragment ist ein unbekanntes XML-Tag, das nicht Bestandteil des SSML-Standards ist.The associated TextFragment is an unknown XML tag not part of the SSML standard.

Pronounce Pronounce Pronounce Pronounce 2

Fordert an, dass eingegebener TextFragment-Text als Phoneme interpretiert wird.Requests that input TextFragment text be interpreted as phonemes. Die genaue Aussprache wird vom Element Phoneme des FragmentState-Objekts angegeben, das in der State-Eigenschaft von TextFragment-Instanzen zurückgegeben wird.Exact pronunciation is specified by the Phoneme member of the FragmentState object returned by the State property on TextFragment instances. Es entspricht dem XML-Tag <phoneme> in der SSML-Spezifikation.It corresponds to the <Phoneme> XML tag in the SSML specification.

Silence Silence Silence Silence 1

Gibt an, dass ein TextFragment keinen Text enthält, der als Sprache gerendert werden soll.Indicates that a TextFragment contains no text to be rendered as speech. Die Dauer des Schweigens wird durch die Duration-Eigenschaft des FragmentState-Objekts angegeben, das von der State-Eigenschaft von TextFragment-Instanzen zurückgegeben wird.Duration of the silence is specified by the Duration property of the the FragmentState object returned by the State property on TextFragment instances. Es entspricht dem XML-Tag <Silence> in der SSML-Spezifikation.It corresponds to the <Silence> XML tag in the SSML specification.

Speak Speak Speak Speak 0

Fordert an, dass zugeordnete TextFragment verarbeitet und gesprochen werden sollen.Requests that the associated TextFragment should be processed and spoken. Dies ist der Standardwert für ein TextFragment.This is the default value for a TextFragment. Es entspricht dem XML-Tag <speak> in der SSML-Spezifikation.It corresponds to the <speak> XML tag in the SSML specification.

SpellOut SpellOut SpellOut SpellOut 4

Gibt an, dass die Textwerte, die von TextFragment durch seine Eigenschaft TextToSpeak bereitgestellt werden, als einzelne Zeichen synthetisiert werden sollen.Indicates that text values provided by a TextFragment through its TextToSpeak property are to be synthesize as individual characters. Dieses Rendering umfasst auch Zeichensetzung mit Ausnahme von Leerzeichen, sowie alphanumerischen Text.This rendering includes punctuation, other than white space, as well as alphanumeric text. Beispielsweise sollte das zugeordnete Textfragment „Wort!“For example, the associated text fragment "word!" als „W o r t Ausrufezeichen“ synthetisiert werden.should be synthesized into "w o r d exclamation point".

StartParagraph StartParagraph StartParagraph StartParagraph 6

Gibt den Zustand eines Absatzes an.Indicates state of paragraph. Es entspricht dem XML-Tag <p> in der SSML-Spezifikation.It corresponds to the <p> XML tag in the SSML specification.

StartSentence StartSentence StartSentence StartSentence 5

Gibt den Anfang des Satzes an.Indicates start of sentence. Es entspricht dem XML-Tag <s> in der SSML-Spezifikation.It corresponds to the <s> XML tag in the SSML specification.

Beispiele

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

Die Implementierung vonSpeakThe implementation of Speak

  1. Empfängt ein Array von TextFragment -Instanzen und erstellt ein neues Array TextFragment von-Instanzen, die an Speak die-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.

  2. Wenn der TtsEngineAction Enumerationswert Action FragmentState , der von der-Eigenschaft des zurückgegeben State wird, der TextFragment von der-Eigenschaft der einzelnen Instanzen zurückgegeben wurde, gesprochen wird, wirdIf 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 EventInterest der Schnittstellen, die für die- TtsEventId Implementierung bereitgestellt werden, den Ereignistyp unterstützt, wird ein Ereignis zum Steuern einer Synthesizer-Status Messung erstelltIf the EventInterest property on the EventInterest interfaces provided to the implementation support the TtsEventId event type, an event to drive a synthesizer progress meter is created.

  3. Anschließend wird ein sprachrenderingmodul mit dem TextFragment geänderten 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

TtsEngineActionstellt Anforderungen für die Wartung TextFragmenteines dar.TtsEngineAction represents requests for servicing a TextFragment. Die Aktionen entsprechen den Elementen in der SSML-Spezifikation und werden auf dem Text implementiert, der von TextToSpeak der-Eigenschaft TextFragmentin einem-Objekt zurückgegeben wird.The actions correspond closely to elements in the SSML specification and are implemented on the text returned by the TextToSpeak property on a TextFragment.

Der TtsEngineAction Wert, der einem TextFragment zugeordnet ist, wird State von der-Eigenschaft zurückgegeben.The TtsEngineAction value associated with a TextFragment is returned by the State property.

Die Verarbeitung des TtsEngineAction Werts, der von State der-Eigenschaft zurückgegeben wird, wird von einer sprach Speak Synthese Implementierung der-Methode für TtsEngineSsmleine von abgeleitete Klasse behandelt.Processing of the TtsEngineAction value returned by the State property is handled by a speech synthesizes implementation of the Speak method on a class derived from TtsEngineSsml.

Gilt für: