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, SpeechEventInfoFragmentStateи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).