SpeechEventInfo(Int16, Int16, Int32, IntPtr) Konstruktor

Definition

Konstruiert ein entsprechendes SpeechEventInfo-Element.Constructs an appropriate SpeechEventInfo.

public:
 SpeechEventInfo(short eventId, short parameterType, int param1, IntPtr param2);
public SpeechEventInfo (short eventId, short parameterType, int param1, IntPtr param2);
new System.Speech.Synthesis.TtsEngine.SpeechEventInfo : int16 * int16 * int * nativeint -> System.Speech.Synthesis.TtsEngine.SpeechEventInfo
Public Sub New (eventId As Short, parameterType As Short, param1 As Integer, param2 As IntPtr)

Parameter

eventId
Int16

Eine Instanz von TtsEventId die die Sorte des Spracheplattformereignisses angibt, das das SpeechEventInfo Objekt behandeln kann.An instance of TtsEventId indicating the sort of Speech platform event the SpeechEventInfo object is to handle.

parameterType
Int16

Eine Instanz von EventParameterType, die angibt, wie der System.IntPtr Verweis von param2 interpretiert werden soll und, als natürliche Folge, die Verwendung von param1.An instance of EventParameterType indicating how the System.IntPtr reference of param2 is to be interpreted, and, by implication, the use of param1.

param1
Int32

Ein ganzzahliger Wert, der zur Spracheplattform übergebenden wird, wenn das Ereignis generiert wird, das von der Instanz der SpeechEventInfo aufgefordert wird, konstruiert zu werden.An integer value to be passed to the Speech platform when the event requested by the instance of SpeechEventInfo to be constructed is generated.

Die genaue Bedeutung dieser ganzen Zahl wird implizit durch den Wert von parameterType bestimmt.The exact meaning of this integer is implicitly determined by the value of parameterType.

param2
IntPtr

Eine System.IntPtr-Instanz, die ein Objekt verweist.A System.IntPtr instance referencing an object. der zur Spracheplattform übergebenden wird, wenn das Ereignis generiert wird, das von der Instanz der SpeechEventInfo aufgefordert wird, konstruiert zu werden.to be passed to the Speech platform when the event requested by the instance of SpeechEventInfo to be constructed is generated.

Der Typ, der referenziert werden muss, wird explizit durch den Wert parameterType definiert.The type which must be referenced is explicitly defined by the value parameterType. Der Wert System.IntPtr.Zero.The value System.IntPtr.Zero.

Beispiele

Das folgende Beispiel ist Teil einer benutzerdefinierten Sprachsynthese Implementierung TtsEngineSsml , die von verwendet wird, und verwendet die Verwendung von TextFragment , SpeechEventInfo , FragmentState und. TtsEventIdThe 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.

  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

Zulässige Werte parameterType , die für, param1 und param2 und ihre Bedeutung verwendet werden, werden durch den Typ des angeforderten Ereignisses vorgegeben, wie vom Member von angegeben, der TtsEventId für verwendet wird eventId .Permitted values used for parameterType, param1, and param2 and their meaning is dictated by the type of event being requested, as specified by the member of TtsEventId used for eventId.

Ausführliche Informationen zu den entsprechenden Werten für parameterType , param1 und finden Sie in der param2 Dokumentation zu. EventIdFor detailed information on appropriate values for parameterType, param1, and param2, see documentation for EventId

Der Typ der Ereignisse, die von der sprach Platt Form Infrastruktur behandelt werden können, kann über die- EventInterest Eigenschaft auf der Standort Implementierung der Synthesizer-Engine abgerufen werden ITtsEngineSite .The type of the events which can be handled by the Speech platform infrastructure can be obtained through the EventInterest property on the synthesizer engine site implementation of ITtsEngineSite.

Gilt für: