TtsEngineAction TtsEngineAction TtsEngineAction TtsEngineAction Enum

Определение

Указывает действие языка разметки синтеза речи (SSML), выполняемое при отрисовке данного TextFragment.Specifies the Speech Synthesis Markup Language (SSML) action to be taken in rendering a given TextFragment.

public enum class TtsEngineAction
public enum TtsEngineAction
type TtsEngineAction = 
Public Enum TtsEngineAction
Наследование
TtsEngineActionTtsEngineActionTtsEngineActionTtsEngineAction

Поля

Bookmark Bookmark Bookmark Bookmark 3

Указывает, что TextFragment необходимо использовать в качестве содержимого закладки.Indicates that TextFragment is to be used as the contents of a bookmark. Соответствует XML-тегу <mark> в спецификации SSML.It corresponds to the <mark> XML tag in the SSML specification.

ParseUnknownTag ParseUnknownTag ParseUnknownTag ParseUnknownTag 7

Указывает, что никакие действия не определены из SSML-ввода.Indicates that no action has been determined from SSML input. Эти входные данные могут интерпретироваться или игнорироваться на усмотрение механизма синтеза.This input that may be interpreted or ignored by at the discretion of a synthesis engine. Связанный TextFragment является неизвестным тегом XML, не входящим в стандарт SSML.The associated TextFragment is an unknown XML tag not part of the SSML standard.

Pronounce Pronounce Pronounce Pronounce 2

Запрашивает, чтобы входной текст TextFragment интерпретировался как фонемы.Requests that input TextFragment text be interpreted as phonemes. Точное произношение задается членом Phoneme объекта FragmentState, возвращаемого свойством State для экземпляров TextFragment.Exact pronunciation is specified by the Phoneme member of the FragmentState object returned by the State property on TextFragment instances. Соответствует XML-тегу <Phoneme> в спецификации SSML.It corresponds to the <Phoneme> XML tag in the SSML specification.

Silence Silence Silence Silence 1

Указывает, что TextFragment не содержит текста для воспроизведения в виде речи.Indicates that a TextFragment contains no text to be rendered as speech. Длительность тишины задается свойством Duration объекта FragmentState, возвращаемого свойством State для экземпляров TextFragment.Duration of the silence is specified by the Duration property of the the FragmentState object returned by the State property on TextFragment instances. Соответствует XML-тегу <Silence> в спецификации SSML.It corresponds to the <Silence> XML tag in the SSML specification.

Speak Speak Speak Speak 0

Запрашивает, чтобы связанное TextFragment должно обрабатываться и произноситься.Requests that the associated TextFragment should be processed and spoken. Это значение по умолчанию для TextFragment.This is the default value for a TextFragment. Соответствует XML-тегу <speak> в спецификации SSML.It corresponds to the <speak> XML tag in the SSML specification.

SpellOut SpellOut SpellOut SpellOut 4

Указывает, что текстовые значения, предоставленные TextFragment через его свойство TextToSpeak, должны синтезироваться как отдельные символы.Indicates that text values provided by a TextFragment through its TextToSpeak property are to be synthesize as individual characters. Это включает знаки препинания, отличные от пробелов, а также алфавитно-цифровой текст.This rendering includes punctuation, other than white space, as well as alphanumeric text. Например, связанный текстовый фрагмент "word!"For example, the associated text fragment "word!" должен быть синтезирован в "w o r d восклицательный знак".should be synthesized into "w o r d exclamation point".

StartParagraph StartParagraph StartParagraph StartParagraph 6

Указывает состояние параграфа.Indicates state of paragraph. Соответствует XML-тегу <p> в спецификации SSML.It corresponds to the <p> XML tag in the SSML specification.

StartSentence StartSentence StartSentence StartSentence 5

Обозначает начало предложения.Indicates start of sentence. Соответствует XML-тегу <s> в спецификации SSML.It corresponds to the <s> XML tag in the SSML specification.

Примеры

Следующий пример является частью пользовательской реализации синтеза речи, наследуемой от TtsEngineSsml, и TextFragmentиспользования функций, FragmentStateи.TtsEventIdThe following example is part of a custom speech synthesis implementation inheriting from TtsEngineSsml, and using the use of TextFragment, 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 State FragmentState Action Если значение перечисления,найденноевсвойстве,возвращаемомсвойствомкаждогоэкземпляра,говорит,реализацияTtsEngineActionIf 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.

    • Если свойство в интерфейсе, предоставленном TtsEventId.WordBoundary для реализации, поддерживает тип события, то создается событие для обработки индикатора выполнения синтезатора. ITtsEngineSite EventInterestIf the EventInterest property on the ITtsEngineSite interface provided to the implementation support the TtsEventId.WordBoundary event type, 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);

}

Комментарии

TtsEngineActionпредставляет запросы для обслуживания TextFragment.TtsEngineAction represents requests for servicing a TextFragment. Действия тесно соответствуют элементам в спецификации SSML и реализуются в тексте, TextToSpeak возвращаемом свойством TextFragmentв.The actions correspond closely to elements in the SSML specification and are implemented on the text returned by the TextToSpeak property on a TextFragment.

Значение, связанное с TextFragment , возвращается State свойством. TtsEngineActionThe TtsEngineAction value associated with a TextFragment is returned by the State property.

Обработка значения, возвращаемого State свойством, обрабатывается речевым Speak синтезатором реализации метода класса, производного от TtsEngineSsml. TtsEngineActionProcessing of the TtsEngineAction value returned by the State property is handled by a speech synthesizes implementation of the Speak method on a class derived from TtsEngineSsml.

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