EventParameterType Enumeração

Definição

Namespace:

System.Speech.Synthesis.TtsEngine

Assembly:

System.Speech.dll

Pacote:

System.Speech v11.0.0-preview.2.26159.112

Origem:

TTSEngineTypes.cs

Enumera os tipos de ponteiros de dados passados para eventos de síntese de fala.

public enum class EventParameterType

public enum EventParameterType

type EventParameterType = 

Public Enum EventParameterType

Herança

Object

ValueType

Enum

EventParameterType

Campos

Nome	Valor	Description
Undefined	0	Indica que o param2 argumento para o SpeechEventInfo é indefinido. Geralmente, param1 e param2 depois são ignorados. No entanto, se EventId for WordBoundary, um evento de medidor de progresso pode ser gerado. param1 deve ser um inteiro que contém o comprimento da palavra atual e param2 uma IntPtr referência a um inteiro que contém o deslocamento da palavra atual.
Token	1	Indica que o param2 argumento para o SpeechEventInfo é IntPtr criado usando PtrToStructure que faz referência a um token da Tecnologia de Fala da Área de Trabalho do Windows, que é um objeto da Tecnologia de Fala da Área de Trabalho do Windows que representa um recurso, como uma voz (VoiceInfo). param1 pode assumir qualquer valor.
Object	2	No momento, não há suporte.
Pointer	3	No momento, não há suporte.
String	4	Indica que o param2 argumento para o SpeechEventInfo é System.IntPtr criado usando System.Runtime.InteropServices.Marshal.StringToCoTaskMemUni a referência a um System.String objeto; param1 pode assumir qualquer valor.

Exemplos

O exemplo a seguir faz parte de uma implementação de síntese de fala personalizada herdando e TtsEngineSsmlusando o uso de TextFragment, SpeechEventInfoe FragmentStateTtsEventId.

A implementação de Speak

1. Recebe uma matriz de TextFragment instâncias e cria uma nova matriz de TextFragment instâncias a serem passadas para o Speak método em um mecanismo de síntese subjacente.

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

   • Traduz o americanismo para os britânicos no texto a ser falado.

   • Se a EventInterest propriedade nas ITtsEngineSite interfaces fornecidas à implementação der suporte ao WordBoundary tipo de evento, uma SpeechEventInfo instância será usada para criar um evento para gerar um medidor de progresso do sintetizador.

     Os parâmetros em SpeechEventInfo, incluindo o valor de EventParameterType membro retornado por ParameterType, são usados para registrar o evento gerado por meio do LogSpeechEvent método.

3. Um mecanismo de renderização de fala é chamado com a matriz modificada 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));
         LogSpeechEvent(spEvent.EventId,
                        spEvent.ParameterType,
                        spEvent.Param1,
                        spEvent.Param2);
        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);

}

Comentários

A EventParameterType enumeração é usada ao construir um SpeechEventInfo objeto. Um EventParameterType membro de enumeração passado como o parameterType argumento para o construtor especifica SpeechEventInfo como o param2 argumento do construtor (que deve ser um IntPtr) é interpretado.

A escolha é EventParameterType determinada pelo tipo de evento que está sendo solicitado, conforme especificado por um membro de System.Speech.Synthesis.TtsEngine.TtsEventId.

Para obter informações detalhadas sobre como usar EventParameterType, consulte a documentação para EventId

Observação

Atualmente, instâncias de mecanismos de fala sintética gerenciados gravados usando os membros do namespace não podem alterar recursos após a System.Speech.Synthesis construção.

Confira também

• SpeechEventInfo