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

Определение

Пространство имен:

System.Speech.Synthesis.TtsEngine

Сборка:

System.Speech.dll

Пакет:

System.Speech v9.0.0-preview.3.24172.9

Исходный код:

TTSEngineTypes.cs

Отрисовывает указанный массив TextFragment в указанном формате вывода.

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, содержащих текст для преобразования в речь.

waveHeader

IntPtr

nativeint

IntPtr, указывающий на структуру, содержащую формат аудиовыхода.

site

ITtsEngineSite

Ссылка на интерфейс 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).