EventParameterType Enumeração

Definição

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
EventParameterType

Campos

Name 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, pode ser gerado um evento de medidor de progresso. param1 deve ser um inteiro contendo o comprimento da palavra atual, e param2 uma IntPtr referência a um inteiro contendo o deslocamento da palavra atual.

Token 1

Indica que o argumento param2 ao SpeechEventInfo é um IntPtr criado usando PtrToStructure que faz referência a um token Windows Desktop Speech Technology, que é um objeto Windows Desktop Speech Technology representando um recurso, como uma voz (VoiceInfo). param1 pode assumir qualquer valor.

Object 2

Neste momento não é suportado.

Pointer 3

Neste momento não é suportado.

String 4

Indica que o param2 argumento para o SpeechEventInfo é um System.IntPtr criado usando System.Runtime.InteropServices.Marshal.StringToCoTaskMemUni referência a um System.String objeto; param1 pode assumir qualquer valor.

Exemplos

O exemplo seguinte faz parte de uma implementação personalizada de síntese de voz que herda de TtsEngineSsml, e que utiliza o uso de TextFragment, SpeechEventInfo, 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 pela 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 nas ITtsEngineSite interfaces fornecidas à implementação suportar o WordBoundary tipo de evento, uma SpeechEventInfo instância é usada para criar um evento que impulsione um medidor de progresso do sintetizador.

      Os parâmetros em SpeechEventInfo, incluindo o EventParameterType valor do membro devolvido por ParameterType, são usados para registar o evento gerado através do LogSpeechEvent método.

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

}

Observações

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

A escolha de EventParameterType é ditada pelo tipo de evento solicitado, conforme especificado por um membro de System.Speech.Synthesis.TtsEngine.TtsEventId.

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

Note

Atualmente, instâncias de motores de fala sintéticos geridos escritos usando os membros do System.Speech.Synthesis namespace não podem alterar recursos após a construção.

Aplica-se a

Ver também