Freigeben über


RecognitionResult.Alternates Eigenschaft

Definition

Ruft die Sammlung möglicher Übereinstimmungen für die Eingabe an die Spracherkennung ab.

public:
 property System::Collections::ObjectModel::ReadOnlyCollection<System::Speech::Recognition::RecognizedPhrase ^> ^ Alternates { System::Collections::ObjectModel::ReadOnlyCollection<System::Speech::Recognition::RecognizedPhrase ^> ^ get(); };
public System.Collections.ObjectModel.ReadOnlyCollection<System.Speech.Recognition.RecognizedPhrase> Alternates { get; }
member this.Alternates : System.Collections.ObjectModel.ReadOnlyCollection<System.Speech.Recognition.RecognizedPhrase>
Public ReadOnly Property Alternates As ReadOnlyCollection(Of RecognizedPhrase)

Eigenschaftswert

Eine schreibgeschützte Auflistung der Erkennungsvarianten.

Beispiele

Das folgende Beispiel zeigt einen Handler für das SpeechRecognized Ereignis und einige der Informationen zu dem zugeordneten RecognitionResultEreignis.

// Handle the SpeechRecognized event.
void SpeechRecognizedHandler(object sender, SpeechRecognizedEventArgs e)
{
  if (e.Result == null) return;

  // Add event handler code here.

  // The following code illustrates some of the information available
  // in the recognition result.
  Console.WriteLine("Grammar({0}), {1}: {2}",
    e.Result.Grammar.Name, e.Result.Audio.Duration, e.Result.Text);

  // Display the semantic values in the recognition result.
  foreach (KeyValuePair<String, SemanticValue> child in e.Result.Semantics)
  {
    Console.WriteLine(" {0} key: {1}",
      child.Key, child.Value.Value ?? "null");
  }
  Console.WriteLine();

  // Display information about the words in the recognition result.
  foreach (RecognizedWordUnit word in e.Result.Words)
  {
    RecognizedAudio audio = e.Result.GetAudioForWordRange(word, word);
    Console.WriteLine(" {0,-10} {1,-10} {2,-10} {3} ({4})",
      word.Text, word.LexicalForm, word.Pronunciation,
      audio.Duration, word.DisplayAttributes);
  }

  // Display the recognition alternates for the result.
  foreach (RecognizedPhrase phrase in e.Result.Alternates)
  {
    Console.WriteLine(" alt({0}) {1}", phrase.Confidence, phrase.Text);
  }
}

Hinweise

Die Erkennung Alternates wird nach den Werten ihrer Confidence Eigenschaften sortiert. Der Konfidenzwert eines bestimmten Ausdrucks gibt die Wahrscheinlichkeit an, dass der Ausdruck der Eingabe entspricht. Der Ausdruck mit dem höchsten Konfidenzwert ist der Ausdruck, der höchstwahrscheinlich mit der Eingabe übereinstimmt.

Jeder Confidence Wert sollte einzeln und ohne Verweis auf die Konfidenzwerte anderer Alternatesausgewertet werden. Die Eigenschaften, von denen die RecognitionResult Erben erben RecognizedPhrase , stellen detaillierte Informationen zum Ausdruck mit der höchsten Konfidenzbewertung bereit.

Eine Verwendung für die Alternates Sammlung ist die automatisierte Fehlerkorrektur. Beispielsweise könnte eine Anwendung beim Entwerfen eines Verzeichnisdialogfelds den Benutzer auffordern, zu überprüfen, ob die Anwendung über die richtigen Informationen aus einem Erkennungsereignis verfügt, wie in "Haben Sie "Anna" gesagt? Wenn der Benutzer "Nein" sagt, könnte die Anwendung den Benutzer nach alternativen Abfragen abfragen, die eine hohe Confidence Bewertung hatten.

Gilt für:

Weitere Informationen