SpeechUI Class

Definition

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Package:

System.Speech v11.0.0-preview.3.26207.106

Source:

SpeechUI.cs

Provides text and status information on recognition operations to be displayed in the Speech platform user interface.

public ref class SpeechUI

public class SpeechUI

type SpeechUI = class

Public Class SpeechUI

Inheritance

Object

SpeechUI

Examples

The following example is a handler for the SpeechRecognized event. This event is used by a Grammar that is designed to handle password input in the form "My password is …".

If a password is not present, or not valid, SendTextFeedback sends error information to the Speech platform user interface.

grammar.SpeechRecognized +=
delegate(object sender, SpeechRecognizedEventArgs eventArgs)
{
  SemanticValue semantics = eventArgs.Result.Semantics;
  RecognitionResult result=eventArgs.Result;

  if (!semantics.ContainsKey("Password"))
  {
    SpeechUI.SendTextFeedback(eventArgs.Result, "No Password Provided", false);
  }
  else
  {
    RecognizedAudio pwdAudio = result.GetAudioForWordRange(
                  result.Words[3],
                  result.Words[result.Words.Count - 1]);
    MemoryStream pwdMemoryStream = new MemoryStream();
    pwdAudio.WriteToAudioStream(pwdMemoryStream);
    if (!IsValidPwd(pwdMemoryStream))
    {
      string badPwd = System.IO.Path.GetTempPath() +
              "BadPwd" + (new Random()).Next().ToString() + ".wav";
      FileStream waveStream = new FileStream(badPwd, FileMode.Create);
      pwdAudio.WriteToWaveStream(waveStream);
      waveStream.Flush();
      waveStream.Close();
      SpeechUI.SendTextFeedback(eventArgs.Result, "Invalid Password", false);
    }
  }
};

Remarks

The members of the SpeechUI class can be used to indicate exact feedback to the end user through the speech recognition user interface. An application can return arbitrary text and success/failure information using this class.

Methods

Name	Description
SendTextFeedback(RecognitionResult, String, Boolean)	Sends status and descriptive text to the Speech platform user interface about the status of a recognition operation.