EventParameterType 列挙型

定義

名前空間:

System.Speech.Synthesis.TtsEngine

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v9.0.0-rc.2.24473.5

ソース:

TTSEngineTypes.cs

音声合成イベントに渡されるデータ ポインターの型を列挙します。

public enum class EventParameterType

public enum EventParameterType

type EventParameterType = 

Public Enum EventParameterType

継承

Object

ValueType

Enum

EventParameterType

フィールド

Object	2	現在サポートされていません。
Pointer	3	現在サポートされていません。
String	4	SpeechEventInfo に対する引数 param2 は、System.IntPtr オブジェクトを参照する System.Runtime.InteropServices.Marshal.StringToCoTaskMemUni を使用して作成された System.String であることを示します。param1 は任意の値を受け取ることができます。
Token	1	SpeechEventInfo の param2 引数が、音声 (VoiceInfo) など、リソースを表わす Windows Desktop Speech Technology オブジェクトである、Windows Desktop Speech Technology トークンを参照する PtrToStructure を使用して作成された IntPtr であることを示します。 param1 は任意の値を取ります。
Undefined	0	SpeechEventInfo に対する引数 param2 が未定義であることを示します。 通常、param1 と param2 は無視されます。 ただし、EventId が WordBoundary の場合、進行状況バー イベントを生成できます。 param1 は、現在の単語の長さが含まれる整数になります。param2 は、現在の単語のオフセットが含まれる整数を参照する IntPtr になります。

例

次の例は、 をTtsEngineSsml継承し、および TtsEventIdを使用するカスタム音声合成実装のTextFragmentSpeechEventInfoFragmentState一部です。

の実装 Speak

1. インスタンスの TextFragment 配列を受け取り、基になる合成エンジンの TextFragment メソッドに渡されるインスタンスの Speak 新しい配列を作成します。

2. 各インスタンスの TtsEngineAction プロパティによって返される State の プロパティFragmentStateから Action が見つかった列挙値が の場合、実装は ですSpeak。TextFragment

   • 話されるテキストの中でアメリカ主義を英国主義に翻訳します。

   • 実装に EventInterest 提供されるインターフェイスの ITtsEngineSite プロパティがイベントの種類を WordBoundary サポートしている場合、 SpeechEventInfo インスタンスを使用して、シンセサイザーの進行状況測定を駆動するイベントが作成されます。

     で返されるメンバー値を含む のSpeechEventInfoEventParameterTypeパラメーターは、 メソッドを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 の引数 (である必要があります) の解釈方法 param2 を IntPtr指定します。

の EventParameterType 選択は、 のメンバーによって指定された要求されるイベントの System.Speech.Synthesis.TtsEngine.TtsEventId種類によって決まります。

の使用方法 EventParameterTypeの詳細については、 のドキュメントを参照してください。 EventId

Note

現在、名前空間のメンバーを使用して記述されたマネージド合成音声エンジンのインスタンスは、構築後にリソースを System.Speech.Synthesis 変更できません。

こちらもご覧ください

• SpeechEventInfo