TtsEngineSsml.Speak(TextFragment[], IntPtr, ITtsEngineSite) メソッド

定義

指定した出力形式で、指定した TextFragment 配列をレンダリングします。Renders specified TextFragment array in the specified output format.

public:
 abstract void Speak(cli::array <System::Speech::Synthesis::TtsEngine::TextFragment ^> ^ fragment, IntPtr waveHeader, System::Speech::Synthesis::TtsEngine::ITtsEngineSite ^ site);
public abstract void Speak (System.Speech.Synthesis.TtsEngine.TextFragment[] fragment, IntPtr waveHeader, System.Speech.Synthesis.TtsEngine.ITtsEngineSite site);
abstract member Speak : System.Speech.Synthesis.TtsEngine.TextFragment[] * nativeint * System.Speech.Synthesis.TtsEngine.ITtsEngineSite -> unit
Public MustOverride Sub Speak (fragment As TextFragment(), waveHeader As IntPtr, site As ITtsEngineSite)

パラメーター

fragment
TextFragment[]

音声にレンダリングされるテキストを含む TextFragment インスタンスの配列。An array of TextFragment instances containing the text to be rendered into speech.

waveHeader
IntPtr

オーディオ出力の形式を含む構造体を指している IntPtrAn IntPtr pointing to a structure containing audio output format.

site
ITtsEngineSite

インフラストラクチャのリソースにアクセスできるようにするために、プラットフォームのインフラストラクチャによって渡される ITtsEngineSite インターフェイスへの参照。A reference to an ITtsEngineSite interface passed in by the platform infrastructure to allow access to the infrastructure resources.

次の例TtsEngineSsmlは、を継承し、、 TextFragment SpeechEventInfo FragmentState、、およびの使用を使用しているカスタム音声合成実装の一部です。TtsEventIdThe example below is part of a custom speech synthesis implementation inheriting from TtsEngineSsml, and using the use of TextFragment, SpeechEventInfo, FragmentState, and TtsEventId

の実装SpeakThe implementation of Speak

  1. インスタンスのTextFragment配列を受け取り、基になる合成エンジンTextFragmentSpeakメソッドに渡されるインスタンスの新しい配列を作成します。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. Action State FragmentState Speak TtsEngineAction各インスタンスのプロパティによって返されるのプロパティによって検出された列挙値がの場合、実装TextFragmentIf 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

    • 読み上げられるテキストの Americanism を Britishisms に変換します。Translates Americanism to Britishisms in the text to be spoken.

    • 実装EventInterest ITtsEngineSite に提供SpeechEventInfoされるインターフェイスのプロパティがイベントの種類をサポートしている場合は、のインスタンスを使用して、シンセサイザーの進行状況メーターを作成するためのイベントを作成します。WordBoundaryIf 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. その後、変更TextFragmentされた配列を使用して音声レンダリングエンジンが呼び出されます。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);  
  
}  

注釈

メソッドによってwaveHeader返され、メソッドによって返されるWAVEFORMATEX構造体は、SAPI で使用可能なと互換性がある必要があります。The structure used as waveHeader and returned by the method should compatible with the WAVEFORMATEX available under SAPI.

struct 、と同等の機能を提供する必要があります。The struct must provide functionality equivalent to:

internal struct WaveFormat  
{  
    public Int16 FormatTag;  
    public Int16 Channels;  
    public int SamplesPerSec;  
    public int AvgBytesPerSec;  
    public Int16 BlockAlign;  
    public Int16 BitsPerSample;  
    public Int16 Size;  
}  

注意 (継承者)

カスタム音声シンセサイザーは、 TtsEngineSsml System.Speech.Synthesis名前Speak(TextFragment[], IntPtr, ITtsEngineSite)空間のメンバーを通じてプラットフォームインフラストラクチャを使用して構築されたシンセサイザーアプリケーション間で、およびの機能を使用して動作を実装します。基になるシステム音声合成エンジン。Custom speech synthesizer implements using TtsEngineSsml and Speak(TextFragment[], IntPtr, ITtsEngineSite) work as filters or intermediaries between synthesizer applications constructed using the platform infrastructure through the members of the System.Speech.Synthesis namespace and underlying system speech synthesis engines.

Speak(TextFragment[], IntPtr, ITtsEngineSite)実装:A Speak(TextFragment[], IntPtr, ITtsEngineSite) implementation: 1.1. 受信TextFragmentオブジェクトの特徴をトラップまたは変更します。Traps or modify aspects of the incoming TextFragment objects 2.2. ITtsEngineSiteインスタンスへのサイト参照を使用して、必要なイベントを生成します。Generates any necessary events using the site reference to a ITtsEngineSite instance 3.3. 実際に合成された音声を生成します。Generates the actual synthesized speech.

音声の生成は、通常、オペレーティングシステムによって提供される音声レンダリングエンジンのいずれかで読み上げを呼び出すことによって行われます。Generation of speech is most typically done by calling Speak on one of the speech rendering engines provided by the operating system.

使用可能な音声描画エンジンの1つが使用されていない場合TtsEngineSsml 、を継承するオブジェクトは独自の speech レンダリングエンジンを作成する必要があります。If one of the available speech rendering engines is not used, a object inheriting from TtsEngineSsml must create its own speech rendering engine.

レジストリとリフレクションを使用して取得された、読み上げメソッドにアクセスします。Access to the Speak method on obtained using the registry and reflection. ..

TtsEngineSsmlから継承Speak(TextFragment[], IntPtr, ITtsEngineSite)する場合TtsEngineSsml(String)は、 AddLexicon(Uri, String, ITtsEngineSite) GetOutputFormat(SpeakOutputFormat, IntPtr)、、、、およびの各メンバーをオーバーライドする必要があります。 RemoveLexicon(Uri, ITtsEngineSite)When you inherit from TtsEngineSsml, you must override the following members: TtsEngineSsml(String), AddLexicon(Uri, String, ITtsEngineSite), RemoveLexicon(Uri, ITtsEngineSite), GetOutputFormat(SpeakOutputFormat, IntPtr), and Speak(TextFragment[], IntPtr, ITtsEngineSite).

適用対象