SemanticValue Třída

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Balíček:

System.Speech v11.0.0-preview.2.26159.112

Zdroj:

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

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

type SemanticValue = class
    interface ICollection<KeyValuePair<string, SemanticValue>>
    interface seq<KeyValuePair<string, SemanticValue>>
    interface IEnumerable
    interface IDictionary<string, SemanticValue>

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

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 navrženou SpeechRecognized pro zpracování příkazů pro změnu popředí a barvy pozadí.

Obslužná rutina identifikuje rozpoznané fráze, které nemají žádnou základní sémantickou strukturu rozpoznáním Count nuly a Value z 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 pro použití modulem pro rozpoznávání pro správnou interpretaci zvukového vstupu. Sémantická interpretace také umožňuje moduly pro rozpoznávání uspořádat výsledky tak, aby je bylo možné snadněji zpracovat, a ne vracet 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í dříve, než bude možné s ním jednat. Objekt Grammar může určit sémantickou interpretaci, aby bylo zpracování jasnější zadáním, že fráze má dvě sémantické podstruktury, jednu pro výběr pozadí nebo popředí (reprezentovaný 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 zahrnuje následující:

• Přístup Objectk objektu Value , který se používá k klíči instance objektu SemanticValue.

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

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

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

Moduly pro 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 pro frázi je získána pomocí Semantics vlastnosti objektu RecognizedPhrase (nebo objekty, které z něj 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á ).Confidence

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

Přímá konstrukce SemanticValue instance je užitečná při vytváření gramatiky silného typu.

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

Konstruktory

Name	Description
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

Name	Description
Confidence	Vrátí relativní míru jistoty, pokud jde o správnost sémantické analýzy, která vrátila aktuální instanci 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ří do aktuálního SemanticValue.
Value	Vlastnost jen pro čtení, která vrací informace obsažené v aktuálním SemanticValue.

Metody

Name	Description
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 zadaný objekt je instance SemanticValue a rovna aktuální instanci SemanticValue.
GetHashCode()	Poskytuje kód hash objektu SemanticValue .

Explicitní implementace rozhraní

Name	Description
ICollection<KeyValuePair<String,SemanticValue>>.Add(KeyValuePair<String,SemanticValue>)	Přidá zadaný klíč a SemanticValue do kolekce.
ICollection<KeyValuePair<String,SemanticValue>>.Clear()	Odebere všechny páry klíč/hodnota z kolekce.
ICollection<KeyValuePair<String,SemanticValue>>.CopyTo(KeyValuePair<String,SemanticValue>[], Int32)	Zkopíruje pár klíč/hodnota do konkrétního umístění v cílovém poli.
ICollection<KeyValuePair<String,SemanticValue>>.IsReadOnly	Získá hodnotu, která určuje, zda je kolekce určena 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 obsahující 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)	Získá přidružené k SemanticValue zadanému klíči.
IDictionary<String,SemanticValue>.Values	Získá kolekci, která obsahuje hodnoty ze slovníku párů klíč/hodnota.
IEnumerable.GetEnumerator()	Vrátí enumerátor, který iteruje kolekcí.
IEnumerable<KeyValuePair<String,SemanticValue>>.GetEnumerator()	Vrátí enumerátor, který iteruje kolekcí.

Metody rozšíření

Name	Description
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	Vytvoří novou IAsyncEnumerable<T> iterací .source
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Vytvoří FrozenDictionary<TKey,TValue> z IEnumerable<T> podle zadaných funkcí selektoru klíčů a selektoru prvků.
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	FrozenDictionary<TKey,TValue> Vytvoří z funkce selektoru klíčů podle zadané funkce selektoru IEnumerable<T> klíčů.
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	Vytvoří se FrozenSet<T> zadanými hodnotami.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Vytvoří neměnné pole ze zadané kolekce.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný slovník jeho obsahu pomocí zadaných porovnávacích klíčů a hodnot.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný slovník jeho obsahu pomocí zadaného porovnávače klíčů.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný slovník jeho obsahu.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Vytvoří neměnný slovník na základě určité transformace sekvence.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Vytvoří neměnný slovník z existující kolekce prvků a použije transformační funkci na zdrojové klíče.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Vytvoří výčet sekvence, vytvoří neměnnou sadu hodnot hash jejího obsahu a použije zadaný porovnávač rovnosti pro typ sady.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Vytvoří výčet sekvence a vytvoří neměnnou sadu hodnot hash jejího obsahu.
ToImmutableList<TSource>(IEnumerable<TSource>)	Vytvoří výčet sekvence a vytvoří neměnný seznam jeho obsahu.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný seřazený slovník jeho obsahu pomocí zadaných porovnávacích klíčů a hodnot.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný seřazený slovník jeho obsahu pomocí zadaného porovnávače klíčů.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný seřazený slovník jeho obsahu.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Vytvoří výčet sekvence, vytvoří neměnnou seřazenou sadu jejího obsahu a použije zadaný porovnávač.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Vytvoří výčet sekvence a vytvoří neměnnou seřazenou sadu jejího obsahu.

Viz také

• SemanticResultValue
• SemanticResultKey