TextFragment.TextToSpeak Proprietà

Definizione

Spazio dei nomi:

System.Speech.Synthesis.TtsEngine

Assembly:

System.Speech.dll

Pacchetto:

System.Speech v9.0.0-preview.3.24172.9

Origine:

TTSEngineTypes.cs

Ottiene o imposta il testo pronunciato del frammento.

public:
 property System::String ^ TextToSpeak { System::String ^ get(); void set(System::String ^ value); };

public string TextToSpeak { get; set; }

member this.TextToSpeak : string with get, set

Public Property TextToSpeak As String

Valore della proprietà

String

System.String viene restituito o può essere utilizzato per impostare il testo pronunciato da utilizzare nel motore di sintesi vocale per generare l'output audio.

Esempio

L'esempio seguente fa parte di un'implementazione di sintesi vocale personalizzata che eredita da TtsEngineSsmle usando l'uso di TextFragment, SpeechEventInfo, FragmentStatee TtsEventId.

Implementazione di Speak

1. Riceve una matrice di TextFragment istanze e crea una nuova matrice di istanze da passare al Speak metodo su un motore di TextFragment sintesi sottostante.

   Particolare attenzione viene usata per rispettare , TextLengthTextOffsetsull'oggetto originale TextFragment durante la creazione di nelle TextToSpeak nuove TextFragment istanze.

2. Se il TtsEngineAction valore di enumerazione trovato dalla Action proprietà nell'oggetto FragmentState restituito dalla State proprietà di ogni TextFragment istanza è Speak, l'implementazione

   • Traduce l'americanismo in britishismi nel testo da pronunciare.

   • Se la EventInterest proprietà nelle ITtsEngineSite interfacce fornite all'implementazione supporta il WordBoundary tipo di evento, viene usata un'istanza SpeechEventInfo di per creare un evento per guidare un indicatore di stato del sintetizzatore.

3. Viene quindi chiamato un motore di rendering vocale con la matrice modificata 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);  

}  

Commenti

Il valore predefinito di questa proprietà è System.String.Empty.

Le applicazioni sono libere di modificare completamente il valore di TextToSpeak.

La reimpostazione del valore di TextToSpeak non modificherà il valore di TextOffset e TextLength.