EventParameterType 枚举

定义

命名空间:

System.Speech.Synthesis.TtsEngine

程序集:

System.Speech.dll

包:

System.Speech v11.0.0-preview.2.26159.112

Source:

TTSEngineTypes.cs

枚举传递给语音合成事件的数据指针的类型。

public enum class EventParameterType

public enum EventParameterType

type EventParameterType = 

Public Enum EventParameterType

继承

Object

ValueType

Enum

EventParameterType

字段

名称	值	说明
Undefined	0	指示param2SpeechEventInfo参数未定义。 通常， param1 然后 param2 被忽略。 但是，如果是EventIdWordBoundary，则可以生成进度计量事件。 param1应为包含当前单词长度的整数，引用param2IntPtr包含当前单词偏移量的整数。
Token	1	指示param2SpeechEventInfo参数是IntPtr使用该PtrToStructure标记创建的，该令牌引用 Windows 桌面语音技术令牌，该令牌是表示资源（如语音）VoiceInfo的 Windows 桌面语音技术对象。 param1 可能会占用任何值。
Object	2	目前不支持。
Pointer	3	目前不支持。
String	4	指示param2使用System.IntPtr引用System.String对象创建的System.Runtime.InteropServices.Marshal.StringToCoTaskMemUni自变量SpeechEventInfo;param1可能采用任何值。

示例

下面的示例是继承自TtsEngineSsml并使用 FragmentStateTextFragmentSpeechEventInfoTtsEventId、和 ..

实现 Speak

1. 接收实例数组TextFragment，并创建要传递给Speak基础合成引擎上方法的新实例数组TextFragment。

2. TtsEngineAction如果从每个TextFragment实例的属性返回State的属性FragmentState中找到Action的枚举值，Speak则实现

   • 将美国主义翻译成文本中的英式主义。

   • EventInterest如果提供给实现的ITtsEngineSite接口上的属性支持WordBoundary事件类型，SpeechEventInfo则使用实例创建事件来驱动合成器进度表。

     其参数 SpeechEventInfo（包括 EventParameterType 返回 ParameterType的成员值）用于记录通过 LogSpeechEvent 该方法生成的事件。

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));
         LogSpeechEvent(spEvent.EventId,
                        spEvent.ParameterType,
                        spEvent.Param1,
                        spEvent.Param2);
        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);

}

注解

EventParameterType在构造SpeechEventInfo对象时使用枚举。 EventParameterType作为参数传递给构造函数的parameterType枚举成员，用于SpeechEventInfo指定构造函数（必须是一个IntPtr）的参数的解释param2方式。

选择 EventParameterType 取决于所请求的事件类型，由其成员 System.Speech.Synthesis.TtsEngine.TtsEventId指定。

有关如何使用 EventParameterType的详细信息，请参阅文档 EventId

注释

目前，使用命名空间成员 System.Speech.Synthesis 编写的托管合成语音引擎实例在构造后无法更改资源。

另请参阅

• SpeechEventInfo