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

IntPtr, указывающий на структуру, содержащую формат аудиовыхода.An 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 экземпляров и создает новый TextFragment массив экземпляров Speak для передачи в метод базового механизма синтеза.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. TextFragment FragmentState Action State SpeakЕсли значение TtsEngineAction перечисления, найденное в свойстве, возвращаемом свойством каждого экземпляра, равно, то реализацияIf 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

    • Преобразует Американский регион в Бритишисмс текст.Translates Americanism to Britishisms in the text to be spoken.

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

Если один из доступных модулей рендеринга речи не используется, объект, наследующий от TtsEngineSsml , должен создать собственный модуль рендеринга речи.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необходимо переопределить следующие члены: TtsEngineSsml(String), AddLexicon(Uri, String, ITtsEngineSite), RemoveLexicon(Uri, ITtsEngineSite), GetOutputFormat(SpeakOutputFormat, IntPtr)и Speak(TextFragment[], IntPtr, 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).

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