SemanticValue Класс

Определение

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

System.Speech.Recognition

Сборка:

System.Speech.dll

Пакет:

System.Speech v8.0.0

Представляет семантическую организацию распознанной фразы.

public ref class SemanticValue sealed : System::Collections::Generic::ICollection<System::Collections::Generic::KeyValuePair<System::String ^, System::Speech::Recognition::SemanticValue ^>>, System::Collections::Generic::IDictionary<System::String ^, System::Speech::Recognition::SemanticValue ^>, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Speech::Recognition::SemanticValue ^>>

[System.Serializable]
public sealed class SemanticValue : System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,System.Speech.Recognition.SemanticValue>>, System.Collections.Generic.IDictionary<string,System.Speech.Recognition.SemanticValue>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,System.Speech.Recognition.SemanticValue>>

[<System.Serializable>]
type SemanticValue = class
    interface IDictionary<string, SemanticValue>
    interface ICollection<KeyValuePair<string, SemanticValue>>
    interface seq<KeyValuePair<string, SemanticValue>>
    interface IEnumerable

Public NotInheritable Class SemanticValue
Implements ICollection(Of KeyValuePair(Of String, SemanticValue)), IDictionary(Of String, SemanticValue), IEnumerable(Of KeyValuePair(Of String, SemanticValue))

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

Object

SemanticValue

Атрибуты

SerializableAttribute

Реализации

ICollection<KeyValuePair<String,SemanticValue>> ICollection<KeyValuePair<TKey,TValue>> IDictionary<String,SemanticValue> IEnumerable<KeyValuePair<String,SemanticValue>> IEnumerable<KeyValuePair<TKey,TValue>> IEnumerable<T> IEnumerable

Примеры

В следующем примере показан обработчик для события, SpeechRecognized предназначенного для обработки команд для изменения цвета переднего плана и фона.

Обработчик идентифицирует распознанные фразы, не имеющие базовой Count семантической структуры, путем обнаружения нулевых и Value .null Затем эти выходные данные распознавания обрабатываются напрямую путем анализа необработанного текста.

В других случаях обработчик использует ключи для получения rgb-компонентов имени цвета, определения того, изменит ли команда передний план или фон, или чтобы указать, что допустимый ключ не найден.

newGrammar.SpeechRecognized +=  
  delegate(object sender, SpeechRecognizedEventArgs eventArgs)   
  {  

    // Retrieve the value of the semantic property.  
    bool changeBackGround = true;  
    string errorString = "";  
    SemanticValue semantics = eventArgs.Result.Semantics;  

    Color newColor = Color.Empty;  

    try   
    {  
      if (semantics.Count == 0 && semantics.Value==null)  
      {  
        // Signifies recognition by a grammar with no semantics.  
        // Parse the string, assuming that the last word is color,  
        // and search for "background" or "foreground" in the input.  
        if (eventArgs.Result.Text.Contains("foreground"))   
        {  
          changeBackGround = false;  
        }  
        string cName = eventArgs.Result.Words[eventArgs.Result.Words.Count - 1].Text;  
        newColor = Color.FromName(cName);  

      }  
      else if (semantics.ContainsKey("colorStringList") ^ semantics.ContainsKey("colorRGBValueList"))   
      {  

        // Determine whether to change background or foreground.  
        if (semantics.ContainsKey("applyChgToBackground"))   
        {  
          changeBackGround = semantics["applyChgToBackground"].Value is bool;  
        }  

        // Get the RGB color value.  
        if (semantics.ContainsKey("colorStringList"))   
        {  
          newColor = Color.FromName((string)semantics["colorStringList"].Value);  
        }  
        if (semantics.ContainsKey("colorRGBValueList"))   
        {  
          newColor = System.Drawing.Color.FromArgb((int)semantics["colorRGBValueList"].Value);  
        }  
      }  
      else   
      {  

        // Throw an exception if the semantics do not contain the keys we  
        // support.  
        throw(new Exception("Unsupported semantics keys found."));  
      }  
    }  

    catch (Exception exp)   
    {  
      MessageBox.Show(String.Format("Unable to process color semantics.:\n{0}\n", exp.Message));  
      return;  
    }  

    // Change colors, either foreground or background.  
    if (changeBackGround)   
    {  
      BackColor = newColor;  
      float Bright = BackColor.GetBrightness();  
      float Hue = BackColor.GetHue();  
      float Sat = BackColor.GetSaturation();  

      // Make sure that text is readable regardless of the background.  
      if (BackColor.GetBrightness() <= .50)   
      {  
        ForeColor = Color.White;  
      }  
      else   
      {  
        ForeColor = Color.Black;  
      }  
    }  
    else   
    {  
      ForeColor = newColor;  
      float Bright = ForeColor.GetBrightness();  
      float Hue = ForeColor.GetHue();  
      float Sat = ForeColor.GetSaturation();  

      // Make sure that text is readable regardless of Foreground.  
      if (ForeColor.GetBrightness() <= .50)   
      {  
        BackColor = Color.White;  
      }  
      else   
      {  
        BackColor = Color.Black;  
      }  
    }  
    return;  
  };  

Комментарии

SemanticValue — это основной объект, реализующий семантику в System.Speech. Семантическая интерпретация позволяет грамматикам определять правила, используемые подсистемой распознавания для правильной интерпретации входных аудиоданных. Семантическая интерпретация также позволяет механизмам распознавания упорядочивать свои результаты таким образом, чтобы их было проще обрабатывать, а не возвращать только распознанные слова и последовательности слов.

Например, выходные данные подсистемы распознавания "Изменить фон на красный" должны быть проанализированы и интерпретированы приложением, прежде чем с ним можно будет действовать. Объект Grammar может указать семантику интерпретации, чтобы сделать обработку более четкой, указав, что фраза имеет две семантические подструктуры: одну для выбора фона или переднего плана (представленного текстом "фон"), а другая — для выбора цвета (представлена текстом "красный").

System.Speech представляет семантику операции распознавания в дереве SemanticValue объектов.

Каждый SemanticValue экземпляр включает в себя следующее:

• Объект Object, к которым обращается с помощью Value свойства , используемого для ключа экземпляра SemanticValue.

• Мера точности семантического анализа, возвращаемая свойством Confidence .

• Коллекция пар "имя-значение" (KeyValuePair<TKey,TValue>) дочерних объектов, которые также SemanticValue являются экземплярами. Дочерние узлы доступны через реализацию SemanticValue использования ключа подстановки IDictionary<TKey,TValue> строки и экземпляра SemanticValue , как показано в следующем примере.

  foreach (KeyValuePair<String, SemanticValue> child in semantics)   
  {  
    Utils.CreateSemanticsTreeNodes(semanticsNode.Nodes, child.Value, child.Key);  
  }  
  

Механизмы распознавания на основе System.Speech предоставляют допустимые экземпляры для всех выходных SemanticValue данных распознавания, даже для фраз без явной семантической структуры.

Экземпляр SemanticValue фразы получается с помощью Semantics свойства объекта RecognizedPhrase (или объектов, наследующих от него, например RecognitionResult).

SemanticValue Объекты, полученные для распознаваемых фраз без семантической структуры, характеризуются следующими:

• Отсутствие детей (Count равно 0).

• Значение свойства Value — null.

• Искусственный семантический уровень достоверности 1,0 (возвращается Confidence).

Как правило, приложения создают SemanticValue экземпляры косвенно, добавляя их в Grammar объекты с помощью SemanticResultValue экземпляров и SemanticResultKey в сочетании с Choices объектами и GrammarBuilder .

Прямое построение экземпляра SemanticValue полезно при создании строго типизированных грамматик.

SemanticValue реализует интерфейсы IDictionary<TKey,TValue>, ICollection<T>и IEnumerable<T> .

Конструкторы

SemanticValue(Object)	Инициализирует новый экземпляр класса SemanticValue и указывает семантическое значение.
SemanticValue(String, Object, Single)	Инициализирует новый экземпляр класса SemanticValue и определяет семантическое значение, имя ключа и уровень доверия.

Свойства

Confidence	Возвращает относительную меры точности смыслового анализа, который вернул текущий экземпляр SemanticValue.
Count	Возвращает количество дочерних объектов SemanticValue под текущим экземпляром SemanticValue.
Item[String]	Возвращает дочерние SemanticValue экземпляры, принадлежащие текущему SemanticValueобъекту .
Value	Свойство, доступное только для чтения, которое возвращает сведения, содержащихся в текущем SemanticValue.

Методы

Contains(KeyValuePair<String,SemanticValue>)	Указывает, содержит ли текущая коллекция экземпляров SemanticValue конкретный ключ и конкретный экземпляр SemanticValue, представленный в виде пары "ключ-значение".
ContainsKey(String)	Указывает, содержит ли текущая коллекция экземпляров SemanticValue дочерний экземпляр SemanticValue с заданной строкой ключа.
Equals(Object)	Определяет, является ли указанный объект экземпляром SemanticValue и равен ли он текущему экземпляру SemanticValue.
GetHashCode()	Предоставляет хэш-код для SemanticValue объекта .
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

ICollection<KeyValuePair<String,SemanticValue>>.Add(KeyValuePair<String,SemanticValue>)	Добавляет указанный ключ и SemanticValue в коллекцию.
ICollection<KeyValuePair<String,SemanticValue>>.Clear()	Удаляет все пары "ключ-значение" из коллекции.
ICollection<KeyValuePair<String,SemanticValue>>.CopyTo(KeyValuePair<String,SemanticValue>[], Int32)	Копирует пару "ключ-значение" в определенное расположение в целевом массиве.
ICollection<KeyValuePair<String,SemanticValue>>.IsReadOnly	Возвращает значение, указывающее на то, доступна ли коллекция только для чтения.
ICollection<KeyValuePair<String,SemanticValue>>.Remove(KeyValuePair<String,SemanticValue>)	Удаляет указанный ключ и SemanticValue из коллекции.
IDictionary<String,SemanticValue>.Add(String, SemanticValue)	Добавляет указанный ключ и SemanticValue в словарь.
IDictionary<String,SemanticValue>.Keys	Получает коллекцию, содержащую ключи из словаря пар "ключ-значение".
IDictionary<String,SemanticValue>.Remove(String)	Удаляет указанный ключ и SemanticValue из словаря.
IDictionary<String,SemanticValue>.TryGetValue(String, SemanticValue)	Возвращает значение SemanticValue, связанное с указанным ключом.
IDictionary<String,SemanticValue>.Values	Получает коллекцию, содержащую значения из словаря пар "ключ-значение".
IEnumerable.GetEnumerator()	Возвращает перечислитель, который осуществляет итерацию по коллекции.
IEnumerable<KeyValuePair<String,SemanticValue>>.GetEnumerator()	Возвращает перечислитель, который осуществляет итерацию по коллекции.

Методы расширения

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

• SemanticResultValue
• SemanticResultKey