TtsEngineSsml.Speak(TextFragment[], IntPtr, ITtsEngineSite) Metodo

Definizione

Esegue il rendering della matrice TextFragment nel formato di output specificato.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)

Parametri

fragment
TextFragment[]

Matrice di istanze di TextFragment che contengono il testo di cui eseguire il rendering come input vocale.An array of TextFragment instances containing the text to be rendered into speech.

waveHeader
IntPtr

IntPtr che punta a una struttura contenente il formato di output audio.An IntPtr pointing to a structure containing audio output format.

site
ITtsEngineSite

Riferimento a un'interfaccia ITtsEngineSite passata dall'infrastruttura della piattaforma per consentire l'accesso alle risorse dell'infrastruttura.A reference to an ITtsEngineSite interface passed in by the platform infrastructure to allow access to the infrastructure resources.

Esempi

L'esempio seguente fa parte di un'implementazione di sintesi vocale personalizzata che eredita TtsEngineSsmlda e usando l'uso di TextFragment, SpeechEventInfo FragmentState, eTtsEventIdThe example below is part of a custom speech synthesis implementation inheriting from TtsEngineSsml, and using the use of TextFragment, SpeechEventInfo, FragmentState, and TtsEventId

Implementazione diSpeakThe implementation of Speak

  1. Riceve una matrice di TextFragment istanze e crea una nuova matrice di TextFragment istanze Speak da passare al metodo su un motore di sintesi sottostante.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. Se il TtsEngineAction valore di enumerazione trovato Action dalla proprietà nell'oggetto FragmentState restituito dalla State proprietà di ogni TextFragment istanza è Speak, l'implementazione diIf 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

    • Converte l'americano in Britishisms nel testo da pronunciare.Translates Americanism to Britishisms in the text to be spoken.

    • Se la EventInterest proprietà ITtsEngineSite nelle interfacce fornite all'implementazione di supporta il WordBoundary tipo di evento, viene SpeechEventInfo utilizzata un'istanza per creare un evento per la creazione di un indicatore di stato del sintetizzatore.If 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. Viene quindi chiamato un motore di rendering vocale con la TextFragment matrice modificata.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);  
  
}  

Commenti

La struttura utilizzata come waveHeader e restituita dal metodo deve essere compatibile con WAVEFORMATEX la disponibile in SAPI.The structure used as waveHeader and returned by the method should compatible with the WAVEFORMATEX available under SAPI.

Deve struct fornire la funzionalità equivalente a: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;  
}  

Note per gli eredi

Il sintetizzatore vocale personalizzato implementa TtsEngineSsml usando Speak(TextFragment[], IntPtr, ITtsEngineSite) e funzionano come filtri o intermediari tra le applicazioni del sintetizzatore costruite usando l'infrastruttura della piattaforma System.Speech.Synthesis tramite i membri dello spazio dei nomi e motori di sintesi vocale di sistema sottostanti.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.

Implementazione Speak(TextFragment[], IntPtr, ITtsEngineSite) di:A Speak(TextFragment[], IntPtr, ITtsEngineSite) implementation: 1.1. Trap o modifica degli aspetti degli oggetti in arrivo TextFragmentTraps or modify aspects of the incoming TextFragment objects 2.2. Genera gli eventi necessari usando il riferimento del sito a ITtsEngineSite un'istanzaGenerates any necessary events using the site reference to a ITtsEngineSite instance 3.3. Genera il discorso sintetizzato effettivo.Generates the actual synthesized speech.

La generazione di riconoscimento vocale viene in genere eseguita chiamando il comando Speak su uno dei motori di rendering vocale forniti dal sistema operativo.Generation of speech is most typically done by calling Speak on one of the speech rendering engines provided by the operating system.

Se uno dei motori di rendering vocale disponibili non viene utilizzato, un oggetto che eredita da TtsEngineSsml deve creare il proprio motore di rendering vocale.If one of the available speech rendering engines is not used, a object inheriting from TtsEngineSsml must create its own speech rendering engine.

Accesso al metodo Speak su ottenuto utilizzando il registro di sistema e la reflection.Access to the Speak method on obtained using the registry and reflection. ..

Quando si eredita da TtsEngineSsml, è necessario eseguire l'override dei membri TtsEngineSsml(String)seguenti AddLexicon(Uri, String, ITtsEngineSite): RemoveLexicon(Uri, ITtsEngineSite), GetOutputFormat(SpeakOutputFormat, IntPtr),, Speak(TextFragment[], IntPtr, ITtsEngineSite)e.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).

Si applica a