TextFragment Класс

Определение

Содержит сведения об атрибуте текста и речи для использования обработчиком синтеза речи.Contains text and speech attribute information for consumption by a speech synthesizer engine.

public ref class TextFragment
public class TextFragment
type TextFragment = class
Public Class TextFragment
Наследование
TextFragment

Примеры

Приведенный ниже пример является частью пользовательской реализации TtsEngineSsmlсинтеза речи, наследуемой от, и TextFragmentиспользования функций, SpeechEventInfo, FragmentStateи TtsEventId.The 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.

    Конкретная осторожность используется для того TextOffset, чтобы учитывать, TextLength в TextFragment исходной при создании TextToSpeak новых TextFragment экземпляров.Particular care is used to respect the TextOffset, TextLength on the original TextFragment when creating the TextToSpeak on the new TextFragment instances.

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

Комментарии

Инфраструктура платформы обработки речи распаковать XML-структуру SSML входных и конструкций TextFragment объектов.The Speech platform infrastructure unpacks the XML based structure of the SSML input and constructs TextFragment objects.

Речевое содержимое доступно TextLengthчерез свойства TextOffset TextToSpeak , и TextFragment экземпляра.Speech content is available through the TextLength, TextOffset, and TextToSpeak properties of a TextFragment instance.

Сведения об атрибутах речи, такие как выделение, тон и скорость, получаются из FragmentState объекта TextFragment State , возвращаемого свойством.Speech attribute information, such as emphasis, pitch, and rate, are obtained from the FragmentState object returned by the TextFragmentState property.

Конструкторы

TextFragment()

Создает новый экземпляр класса TextFragment.Constructs a new instance of TextFragment.

Свойства

State

Получает или задает сведения об атрибутах речи для TextFragment.Gets or sets speech attribute information for a TextFragment.

TextLength

Получает или задает длину текста речи в фрагмента.Gets or sets the length of the speech text in the fragment.

TextOffset

Получает или задает начальное положение текста во фрагменте.Gets or sets the starting location of the text in the fragment.

TextToSpeak

Задает или получает текст речи фрагмента.Sets or gets the speech text of the fragment.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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