SemanticValue Třída

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Balíček:

System.Speech v8.0.0

Source:

SemanticValue.cs

Představuje sémantickou organizaci rozpoznané fráze.

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

Dědičnost

Object

SemanticValue

Atributy

SerializableAttribute

Implementuje

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

Příklady

Následující příklad ukazuje obslužnou rutinu pro událost určenou SpeechRecognized ke zpracování příkazů pro změnu barvy popředí a pozadí.

Obslužná rutina identifikuje rozpoznané fráze, které nemají žádnou základní sémantickou strukturu, pomocí Count detekce hodnot nula a Value a .null Tento výstup rozpoznávání se pak zpracuje přímo parsováním nezpracovaného textu.

V jiných případech obslužná rutina používá klíče k získání součástí RGB názvu barvy, k určení, zda příkaz změní popředí nebo pozadí, nebo k označení, že nebyl nalezen žádný platný klíč.

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

Poznámky

SemanticValue je primární objekt, který implementuje sémantickou technologii v System.Speech. Sémantická interpretace umožňuje gramatikám definovat pravidla, která mají modul rozpoznávání správně interpretovat zvukový vstup. Sémantická interpretace také umožňuje modulům rozpoznávání uspořádat výsledky tak, aby je bylo možné snadněji zpracovat, a nevrací pouze rozpoznaná slova a posloupnosti slov.

Například výstup modulu rozpoznávání "Změnit pozadí na červenou" by musel být analyzován a interpretován aplikací, aby bylo možné s ním pracovat. Objekt Grammar může určit sémantickou interpretaci, která zpřesní zpracování tím, že určí, že fráze má dvě sémantické podstruktury, jednu pro výběr pozadí nebo popředí (reprezentovanou textem "pozadí") a druhou pro výběr barvy (reprezentované textem "červená").

System.Speech představuje sémantiku operace rozpoznávání ve stromu SemanticValue objektů.

Každá SemanticValue instance obsahuje následující:

• Objekt Object, ke kterému se přistupuje pomocí Value vlastnosti, sloužící ke klíči instance objektu SemanticValue.

• Míra přesnosti sémantické analýzy vrácená Confidence vlastností.

• Kolekce dvojic název/hodnota (KeyValuePair<TKey,TValue>) podřízených objektů, které jsou také SemanticValue instancemi. Podřízené uzly jsou přístupné prostřednictvím SemanticValue implementace řetězce vyhledávacího IDictionary<TKey,TValue> klíče a SemanticValue instance, jak je uvedeno v následujícím příkladu.

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

Moduly rozpoznávání založené na System.Speech poskytují platné instance pro všechny výstupy SemanticValue z rozpoznávání, a to i pro fráze bez explicitní sémantické struktury.

Instance SemanticValue fráze se získá pomocí Semantics vlastnosti objektu RecognizedPhrase (nebo objektů, které z ní dědí, například RecognitionResult).

SemanticValue objekty získané pro rozpoznané fráze bez sémantické struktury jsou charakterizovány:

• Nedostatek dětí (Count je 0).

• Vlastnost Value je null.

• Umělá sémantická úroveň spolehlivosti 1,0 (vrácená uživatelem Confidence).

Aplikace obvykle vytvářejí SemanticValue instance nepřímo a přidávají je do Grammar objektů pomocí SemanticResultValue instancí a SemanticResultKey ve spojení s Choices objekty a GrammarBuilder .

Přímá konstrukce SemanticValue instance je užitečná při vytváření gramatických typů se silnými typy.

SemanticValue implementuje IDictionary<TKey,TValue>rozhraní , ICollection<T>a IEnumerable<T> .

Konstruktory

SemanticValue(Object)	Inicializuje novou instanci SemanticValue třídy a určuje sémantickou hodnotu.
SemanticValue(String, Object, Single)	Inicializuje novou instanci SemanticValue třídy a určuje sémantickou hodnotu, název klíče a úroveň spolehlivosti.

Vlastnosti

Confidence	Vrátí relativní míru jistoty o správnosti sémantické parsování, která vrátila aktuální instanci objektu SemanticValue.
Count	Vrátí počet podřízených SemanticValue objektů v aktuální SemanticValue instanci.
Item[String]	Vrátí podřízené SemanticValue instance, které patří k aktuálnímu SemanticValueobjektu .
Value	Vlastnost jen pro čtení, která vrací informace obsažené v aktuálním SemanticValueobjektu .

Metody

Contains(KeyValuePair<String,SemanticValue>)	Určuje, jestli aktuální SemanticValue kolekce instancí obsahuje konkrétní klíč a konkrétní instanci vyjádřenou SemanticValue jako pár klíč/hodnota.
ContainsKey(String)	Určuje, jestli aktuální SemanticValue kolekce instancí obsahuje podřízenou SemanticValue instanci s daným řetězcem klíče.
Equals(Object)	Určuje, zda je zadaný objekt instancí SemanticValue a je rovna aktuální instanci objektu SemanticValue.
GetHashCode()	Poskytuje kód hash pro SemanticValue objekt.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

ICollection<KeyValuePair<String,SemanticValue>>.Add(KeyValuePair<String,SemanticValue>)	Přidá zadaný klíč a SemanticValue do kolekce.
ICollection<KeyValuePair<String,SemanticValue>>.Clear()	Odebere z kolekce všechny páry klíč/hodnota.
ICollection<KeyValuePair<String,SemanticValue>>.CopyTo(KeyValuePair<String,SemanticValue>[], Int32)	Zkopíruje dvojici klíč/hodnota do konkrétního umístění v cílovém poli.
ICollection<KeyValuePair<String,SemanticValue>>.IsReadOnly	Získá hodnotu, která označuje, zda je kolekce jen pro čtení.
ICollection<KeyValuePair<String,SemanticValue>>.Remove(KeyValuePair<String,SemanticValue>)	Odebere zadaný klíč a SemanticValue z kolekce.
IDictionary<String,SemanticValue>.Add(String, SemanticValue)	Přidá zadaný klíč a SemanticValue do slovníku.
IDictionary<String,SemanticValue>.Keys	Získá kolekci, která obsahuje klíče ze slovníku párů klíč/hodnota.
IDictionary<String,SemanticValue>.Remove(String)	Odebere zadaný klíč a SemanticValue ze slovníku.
IDictionary<String,SemanticValue>.TryGetValue(String, SemanticValue)	SemanticValue Získá přidružený k zadanému klíči.
IDictionary<String,SemanticValue>.Values	Získá kolekci, která obsahuje hodnoty ze slovníku párů klíč/hodnota.
IEnumerable.GetEnumerator()	Vrací enumerátor procházející kolekci.
IEnumerable<KeyValuePair<String,SemanticValue>>.GetEnumerator()	Vrací enumerátor procházející kolekci.

Metody rozšíření

Viz také

• SemanticResultValue
• SemanticResultKey