SemanticValue Klasa

Definicja

Przestrzeń nazw:

System.Speech.Recognition

Zestaw:

System.Speech.dll

Pakiet:

System.Speech v8.0.0

Source:

SemanticValue.cs

Reprezentuje semantyczną organizację rozpoznanej frazy.

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))

Dziedziczenie

Object

SemanticValue

Atrybuty

SerializableAttribute

Implementuje

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

Przykłady

W poniższym przykładzie przedstawiono procedurę obsługi zdarzenia przeznaczonego SpeechRecognized do obsługi poleceń w celu zmiany koloru pierwszego planu i tła.

Program obsługi identyfikuje rozpoznane frazy, które nie mają bazowej struktury semantycznej, wykrywając Count zero i wartość .Valuenull Dane wyjściowe rozpoznawania są następnie przetwarzane bezpośrednio przez analizowanie nieprzetworzonego tekstu.

W innych przypadkach program obsługi używa kluczy do uzyskania składników RGB nazwy koloru, aby określić, czy polecenie zmieni pierwszy plan lub tło, lub wskazać, że nie znaleziono prawidłowego klucza.

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

Uwagi

SemanticValue jest obiektem podstawowym, który implementuje technologię semantyczną w systemie System.Speech. Interpretacja semantyczna umożliwia gramatykom definiowanie reguł do użycia przez aparat rozpoznawania w celu poprawnego interpretowania danych wejściowych dźwięku. Interpretacja semantyczna umożliwia również aparatom rozpoznawania organizowanie wyników, dzięki czemu można je łatwiej przetworzyć, a nie zwracać tylko rozpoznanych słów i sekwencji słów.

Na przykład dane wyjściowe aparatu rozpoznawania "Zmień tło na czerwony" musiałyby zostać przeanalizowane i zinterpretowane przez aplikację, zanim będzie można ją wykonać. Grammar Obiekt może określić semantyczną interpretację w celu wyczyszczenia przetwarzania, określając, że fraza ma dwie semantyczne podstruktury, jedną do wybierania tła lub pierwszego planu (reprezentowanego przez tekst "tło"), a drugą do wybierania koloru (reprezentowanego przez tekst "czerwony").

System.Speech reprezentuje semantyka operacji rozpoznawania w drzewie SemanticValue obiektów.

Każde SemanticValue wystąpienie obejmuje następujące elementy:

• Obiekt Object, do którego uzyskuje dostęp za pomocą Value właściwości , używanej do klucza wystąpienia obiektu SemanticValue.

• Miara dokładności analizowania semantycznego zwrócona przez Confidence właściwość .

• Kolekcja par nazw/wartości (KeyValuePair<TKey,TValue>) obiektów podrzędnych, które są również SemanticValue wystąpieniami. Węzły podrzędne są dostępne za pośrednictwem SemanticValue implementacji IDictionary<TKey,TValue> klucza wyszukiwania ciągów i SemanticValue wystąpienia, jak w poniższym przykładzie.

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

Aparaty SemanticValue rozpoznawania oparte na systemie.Speech zapewniają prawidłowe wystąpienia wszystkich danych wyjściowych z rozpoznawania, nawet w przypadku fraz bez jawnej struktury semantycznej.

Wystąpienie SemanticValue frazy jest uzyskiwane przy użyciu Semantics właściwości obiektu RecognizedPhrase (lub obiektów dziedziczyjących z niego, takich jak RecognitionResult).

SemanticValue obiekty uzyskane dla rozpoznanych fraz bez struktury semantycznej charakteryzują się:

• Brak dzieci (Count to 0).

• Właściwość Value to null.

• Sztuczny poziom ufności semantycznej 1.0 (zwrócony przez Confidencewartość ).

Zazwyczaj aplikacje tworzą SemanticValue wystąpienia pośrednio, dodając je do Grammar obiektów przy użyciu wystąpień SemanticResultValue i w połączeniu z obiektami Choices i SemanticResultKeyGrammarBuilder.

Bezpośrednia konstrukcja SemanticValue wystąpienia jest przydatna podczas tworzenia silnie typiowanych gramatyk.

SemanticValue implementuje IDictionary<TKey,TValue>interfejsy , ICollection<T>i IEnumerable<T> .

Konstruktory

SemanticValue(Object)	Inicjuje SemanticValue nowe wystąpienie klasy i określa wartość semantyczną.
SemanticValue(String, Object, Single)	Inicjuje SemanticValue nowe wystąpienie klasy i określa wartość semantyczną, nazwę klucza i poziom ufności.

Właściwości

Confidence	Zwraca względną miarę pewności co do poprawności semantycznej analizy, która zwróciła bieżące wystąpienie klasy SemanticValue.
Count	Zwraca liczbę obiektów podrzędnych SemanticValue w bieżącym SemanticValue wystąpieniu.
Item[String]	Zwraca wystąpienia podrzędne SemanticValue należące do bieżącego SemanticValueelementu .
Value	Właściwość tylko do odczytu zwracająca informacje zawarte w bieżącym elemencie SemanticValue.

Metody

Contains(KeyValuePair<String,SemanticValue>)	Wskazuje, czy bieżąca SemanticValue kolekcja wystąpień zawiera określony klucz i określone wystąpienie SemanticValue wyrażone jako para klucz/wartość.
ContainsKey(String)	Wskazuje, czy bieżąca SemanticValue kolekcja wystąpień zawiera wystąpienie podrzędne SemanticValue z danym ciągiem klucza.
Equals(Object)	Określa, czy określony obiekt jest wystąpieniem SemanticValue i jest równe bieżącemu wystąpieniu obiektu SemanticValue.
GetHashCode()	Zawiera kod skrótu SemanticValue dla obiektu.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection<KeyValuePair<String,SemanticValue>>.Add(KeyValuePair<String,SemanticValue>)	Dodaje określony klucz i SemanticValue do kolekcji.
ICollection<KeyValuePair<String,SemanticValue>>.Clear()	Usuwa wszystkie pary klucz/wartość z kolekcji.
ICollection<KeyValuePair<String,SemanticValue>>.CopyTo(KeyValuePair<String,SemanticValue>[], Int32)	Kopiuje parę klucz/wartość do określonej lokalizacji w tablicy docelowej.
ICollection<KeyValuePair<String,SemanticValue>>.IsReadOnly	Pobiera wartość wskazującą, czy kolekcja jest tylko do odczytu.
ICollection<KeyValuePair<String,SemanticValue>>.Remove(KeyValuePair<String,SemanticValue>)	Usuwa określony klucz i SemanticValue z kolekcji.
IDictionary<String,SemanticValue>.Add(String, SemanticValue)	Dodaje określony klucz i SemanticValue do słownika.
IDictionary<String,SemanticValue>.Keys	Pobiera kolekcję zawierającą klucze ze słownika par klucz/wartość.
IDictionary<String,SemanticValue>.Remove(String)	Usuwa określony klucz i SemanticValue ze słownika.
IDictionary<String,SemanticValue>.TryGetValue(String, SemanticValue)	SemanticValue Pobiera skojarzony z określonym kluczem.
IDictionary<String,SemanticValue>.Values	Pobiera kolekcję zawierającą wartości ze słownika par klucz/wartość.
IEnumerable.GetEnumerator()	Zwraca moduł wyliczający, który iteruje po kolekcji.
IEnumerable<KeyValuePair<String,SemanticValue>>.GetEnumerator()	Zwraca moduł wyliczający, który iteruje po kolekcji.

Metody rozszerzania

Zobacz też

• SemanticResultValue
• SemanticResultKey