TtsEngineSsml.Speak(TextFragment[], IntPtr, ITtsEngineSite) Метод

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)

Параметры

Примеры

Приведенный ниже пример является частью пользовательской реализации синтеза речи, наследуемой от TtsEngineSsmlи использующими TextFragment, SpeechEventInfo, FragmentStateи . TtsEventId

Реализация Speak

1. Получает массив экземпляров TextFragment и создает новый массив экземпляров, передаваемых TextFragmentSpeak в метод в базовом механизме синтеза.

2. TtsEngineAction Если значение перечисления , найденное из Action свойства в объекте FragmentState , возвращаемом свойством State каждого TextFragment экземпляра , равно Speak, реализация

   • Переводит американизм в британизм в тексте, который будет говорить.

   • EventInterest Если свойство в ITtsEngineSite интерфейсах, предоставляемых реализации, поддерживает WordBoundary тип события, SpeechEventInfo то для создания события для управления индикатором хода выполнения синтезатора используется экземпляр .

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));  
        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.

Должен предоставлять функциональные struct возможности, эквивалентные следующим:

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 и Speak(TextFragment[], IntPtr, ITtsEngineSite) работает в качестве фильтров или посредников между приложениями синтезатора, созданными с помощью инфраструктуры платформы, через члены System.Speech.Synthesis пространства имен и базовые подсистемы синтеза речи системы.

Реализация Speak(TextFragment[], IntPtr, ITtsEngineSite) :

1. Перехват или изменение аспектов входящих TextFragment объектов

2. Создает все необходимые события, используя ссылку сайта на экземпляр.ITtsEngineSite

3. Создает фактическую синтезированную речь.

Создание речи обычно выполняется путем вызова Speak в одном из модулей рендеринга речи, предоставляемых операционной системой.

Если один из доступных модулей рендеринга речи не используется, объект, наследующий от TtsEngineSsml , должен создать собственный модуль рендеринга речи.

Доступ к методу , Speak полученному с помощью реестра и отражения. .

При наследовании от TtsEngineSsmlнеобходимо переопределить следующие элементы: TtsEngineSsml(String), AddLexicon(Uri, String, ITtsEngineSite), RemoveLexicon(Uri, ITtsEngineSite), GetOutputFormat(SpeakOutputFormat, IntPtr)и Speak(TextFragment[], IntPtr, ITtsEngineSite).

Применяется к