TtsEngineAction Enumeração

Definição

Especifica a ação da Linguagem de Marcação de Síntese de Voz (SSML) a ser tomada na renderização de um dado TextFragment.

public enum class TtsEngineAction
public enum TtsEngineAction
type TtsEngineAction = 
Public Enum TtsEngineAction
Herança
TtsEngineAction

Campos

Name Valor Description
Speak 0

Pedidos para que os associados TextFragment sejam processados e falados. Este é o valor padrão para um TextFragment. Corresponde à <speak> etiqueta XML na especificação SSML.

Silence 1

Indica que a TextFragment não contém texto a ser apresentado como fala. A duração do silêncio é especificada pela Duration propriedade do FragmentState objeto devolvida pela State propriedade nas TextFragment instâncias. Corresponde à <Silence> etiqueta XML na especificação SSML.

Pronounce 2

Pedidos para que o texto de entrada TextFragment seja interpretado como fonemas. A pronúncia exata é especificada pelo Phoneme elemento do FragmentState objeto devolvido pela State propriedade nas TextFragment instâncias. Corresponde à <Phoneme> etiqueta XML na especificação SSML.

Bookmark 3

Indica que TextFragment deve ser usado como o conteúdo de um favorito. Corresponde à <mark> etiqueta XML na especificação SSML.

SpellOut 4

Indica que os valores de texto fornecidos por a TextFragment através da sua TextToSpeak propriedade devem ser sintetizados como caracteres individuais. Esta renderização inclui pontuação, exceto espaços em branco, bem como texto alfanumérico. Por exemplo, o fragmento de texto associado "word!" deve ser sintetizado em "w o r d exclamation point".

StartSentence 5

Indica o início da frase. Corresponde à <s> etiqueta XML na especificação SSML.

StartParagraph 6

Indica o estado do parágrafo. Corresponde à <p> etiqueta XML na especificação SSML.

ParseUnknownTag 7

Indica que nenhuma ação foi determinada a partir da entrada SSML. Esta entrada pode ser interpretada ou ignorada a critério de um motor de síntese. A etiqueta associada TextFragment é uma etiqueta XML desconhecida que não faz parte do padrão SSML.

Exemplos

O exemplo seguinte faz parte de uma implementação personalizada de síntese de voz que herda de TtsEngineSsml, e utiliza o uso de TextFragment, FragmentState, e TtsEventId

A implementação de Speak

  1. Recebe um array de TextFragment instâncias e cria um novo array de TextFragment instâncias para serem passados ao Speak método num motor de síntese subjacente.

  2. Se o TtsEngineAction valor de enumeração por encontrado a partir da Action propriedade em o FragmentState devolvido por a State propriedade de cada TextFragment instância for Speak, a implementação

    • Traduz o americanismo para os britishismos no texto a ser falado.

    • Se a EventInterest propriedade na ITtsEngineSite interface fornecida à implementação suportar o TtsEventId.WordBoundary tipo de evento, é criado um evento para gerar um medidor de progresso do sintetizador.

  3. É então chamado um motor de renderização de fala com o array modificado 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);

}

Observações

TtsEngineAction representa pedidos de serviço a um TextFragment. As ações correspondem de perto a elementos da especificação SSML e são implementadas no texto devolvido pela TextToSpeak propriedade num TextFragment.

O TtsEngineAction valor associado a TextFragment a é devolvido pela State propriedade.

O processamento do TtsEngineAction valor devolvido pela State propriedade é tratado por uma implementação de síntese de fala do Speak método numa classe derivada de TtsEngineSsml.

Aplica-se a