RecognitionResult Класс

Определение

Пространство имен:

System.Speech.Recognition

Сборка:

System.Speech.dll

Пакет:

System.Speech v9.0.0-preview.3.24172.9

Исходный код:

RecognitionResult.cs

Содержит подробные сведения о входных данных, распознаваемых экземплярами SpeechRecognitionEngine или SpeechRecognizer.

public ref class RecognitionResult sealed : System::Speech::Recognition::RecognizedPhrase, System::Runtime::Serialization::ISerializable

[System.Serializable]
public sealed class RecognitionResult : System.Speech.Recognition.RecognizedPhrase, System.Runtime.Serialization.ISerializable

[<System.Serializable>]
type RecognitionResult = class
    inherit RecognizedPhrase
    interface ISerializable

Public NotInheritable Class RecognitionResult
Inherits RecognizedPhrase
Implements ISerializable

Наследование

Object

RecognizedPhrase

RecognitionResult

Атрибуты

SerializableAttribute

Реализации

ISerializable

Примеры

В следующем примере показан обработчик для SpeechRecognized события объекта или SpeechRecognizer и некоторые сведения о связанном RecognitionResultобъекте SpeechRecognitionEngine .

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

Комментарии

Этот класс является производным от RecognizedPhrase и предоставляет подробные сведения о распознавании речи, в том числе следующие:

• Свойство Grammar ссылается на объект Grammar , который распознаватель использовал для идентификации речи.

• Свойство Text содержит нормализованный текст фразы. Дополнительные сведения о нормализации текста см. в разделе ReplacementText.

• Свойство Semantics ссылается на семантические сведения, содержащиеся в результате. Семантические сведения — это словарь имен ключей и связанных с ними семантических данных.

• Свойство Alternates содержит коллекцию RecognizedPhrase объектов, представляющих другие потенциальные интерпретации аудиовхода. Дополнительные сведения см. в статье Alternates.

• Свойство Words содержит упорядоченную коллекцию RecognizedWordUnit объектов, представляющих каждое распознанное слово во входных данных. Каждый из них RecognizedWordUnit содержит формат отображения, лексический формат и сведения о произношении для соответствующего слова.

Некоторые SpeechRecognitionEngineчлены классов , SpeechRecognizerи Grammar могут создавать .RecognitionResult Дополнительные сведения см. в следующих методах и событиях.

• Методы и события SpeechRecognitionEngine класса :

  • EmulateRecognize

  • EmulateRecognizeAsync

  • SpeechHypothesized

  • SpeechRecognitionRejected

  • SpeechRecognized

• Методы и события SpeechRecognizer класса :

  • EmulateRecognize

  • EmulateRecognizeAsync

  • SpeechHypothesized

  • SpeechRecognitionRejected

  • SpeechRecognized

• Событие SpeechRecognizedGrammar класса .

Дополнительные сведения о событиях распознавания см. в разделе Использование событий распознавания речи.

Свойства

Alternates	Получает коллекцию возможных соответствий для ввода в распознаватель речи.
Audio	Получает аудио, связанное с результатом распознавания.
Confidence	Возвращает присвоенное распознавателем значение, которое представляет вероятность того, что RecognizedPhrase соответствует заданным входным данным. (Унаследовано от RecognizedPhrase)
Grammar	Получает объект Grammar, используемый распознавателем речи для возврата RecognizedPhrase. (Унаследовано от RecognizedPhrase)
HomophoneGroupId	Возвращает идентификатор группы омофонов для фразы. (Унаследовано от RecognizedPhrase)
Homophones	Получает коллекцию альтернативных результатов распознавания, имеющих то же произношение, что и данная распознанная фраза. (Унаследовано от RecognizedPhrase)
ReplacementWordUnits	Получает сведения о тексте, который распознаватель речи изменил в ходе нормализации преобразования речи в текст. (Унаследовано от RecognizedPhrase)
Semantics	Получает семантическую информацию, связанную с распознанной фразой. (Унаследовано от RecognizedPhrase)
Text	Получает нормализованный текст, созданный распознавателем речи на основе распознанных входных данных. (Унаследовано от RecognizedPhrase)
Words	Получает слова, созданные распознавателем речи на основе распознанных входных данных. (Унаследовано от RecognizedPhrase)

Методы

ConstructSmlFromSemantics()	Возвращает документ на языке разметки семантики (SML) для семантической информации в объекте RecognizedPhrase. (Унаследовано от RecognizedPhrase)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetAudioForWordRange(RecognizedWordUnit, RecognizedWordUnit)	Получает раздел звукового файла, связанный с конкретным диапазоном слов в результате распознавания.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет экземпляр SerializationInfo данными, необходимыми для сериализации целевого объекта.

См. также раздел

• RecognitionEventArgs
• RecognizedPhrase
• SpeechHypothesized
• SpeechRecognized
• SpeechRecognitionRejected
• SpeechHypothesized
• SpeechRecognized
• SpeechRecognitionRejected
• SpeechRecognized