SemanticValue Sınıf

Tanım

Ad Alanı:

System.Speech.Recognition

Bütünleştirilmiş Kod:

System.Speech.dll

Paket:

System.Speech v11.0.0-preview.2.26159.112

Kaynak:

SemanticValue.cs

Tanınan bir tümceciğin anlamsal organizasyonunu temsil eder.

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

Devralma

Object

SemanticValue

Uygulamalar

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

Örnekler

Aşağıdaki örnekte, ön plan ve arka plan rengini değiştirme komutlarını işlemek üzere tasarlanmış bir SpeechRecognized olaya yönelik işleyici gösterilmektedir.

İşleyici, sıfır ve Valuenullbir değerlerini algılayarak Count temel alınan anlam yapısı olmayan tanınan tümcecikleri tanımlar. Bu tanıma çıkışı, ham metin ayrıştırılarak doğrudan işlenir.

Diğer durumlarda işleyici, bir renk adının RGB bileşenlerini almak, komutun ön planı mı yoksa arka planı mı değiştireceğini belirlemek veya geçerli bir anahtar bulunamadığını belirtmek için anahtarları kullanır.

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

Açıklamalar

SemanticValue , System.Speech'da semantik teknolojiyi uygulayan birincil nesnedir. Anlamsal yorumlama, dil bilgisinin ses girişini doğru yorumlamak için bir tanıma altyapısı tarafından kullanılacak kuralları tanımlamasına olanak tanır. Anlamsal yorumlama, tanıma altyapılarının yalnızca tanınan sözcükleri ve sözcük dizilerini döndürmek yerine daha kolay işlenebilmeleri için sonuçlarını düzenlemesine de olanak tanır.

Örneğin, "Arka planı kırmızıya değiştir" tanıma altyapısı çıkışının üzerinde işlem yapılabilmesi için önce uygulama tarafından ayrıştırılması ve yorumlanması gerekir. Bir Grammar nesne, tümceciği arka plan veya ön plan ("arka plan" metniyle gösterilir) seçmek için diğeri ise renk seçmek için ("kırmızı" metniyle gösterilir) olmak üzere iki semantik alt yapıya sahip olduğunu belirterek işlemeyi daha net hale getirmek için anlamsal bir yorum belirtebilir.

System.Speech, nesne ağacındaki bir tanıma işleminin SemanticValue semantiğini temsil eder.

Her SemanticValue örnek aşağıdakileri içerir:

• Objectözelliğiyle Value erişilen ve örneğini SemanticValueanahtar olarak kullanmak için kullanılan bir .

• Özelliği tarafından döndürülen anlam ayrıştırma doğruluğunun Confidence ölçüsü.

• Aynı zamanda SemanticValue örnek olan alt nesnelerin ad/değer çiftleri (KeyValuePair<TKey,TValue>) koleksiyonu. Alt düğümlere, aşağıdaki örnekte olduğu gibi bir dize arama anahtarı ve örnek SemanticValue kullanarak erişilebilir.SemanticValueIDictionary<TKey,TValue>

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

System.Speech'ı temel alan tanıma altyapıları, açık semantik yapısı olmayan tümcecikler SemanticValue için bile tanımadan gelen tüm çıkışlar için geçerli örnekleri sağlar.

Bir SemanticValue tümcecik örneği, nesnedeki RecognizedPhrase (veya nesneden devralan nesneler gibiRecognitionResult) özelliği kullanılarak Semantics elde edilir.

SemanticValue semantik yapıya sahip olmayan tanınan tümcecikler için elde edilen nesneler şunlarla karakterize edilir:

• Çocuk eksikliği (Count 0).

• Value özelliği null.

• Yapay semantik güvenilirlik düzeyi 1,0 (tarafından Confidencedöndürülür).

Genellikle uygulamalar, ve nesneleriyle Choices birlikte ve SemanticResultKey örneklerini kullanarak SemanticResultValue nesnelere Grammar ekleyerek dolaylı olarak örnekler oluştururSemanticValue.GrammarBuilder

Bir örneğin doğrudan oluşturulması SemanticValue , kesin türdeki dil bilgisi oluşturma sırasında kullanışlıdır.

SemanticValue IDictionary<TKey,TValue>, ICollection<T>ve IEnumerable<T> arabirimlerini uygular.

Oluşturucular

Name	Description
SemanticValue(Object)	sınıfının yeni bir örneğini SemanticValue başlatır ve bir anlam değeri belirtir.
SemanticValue(String, Object, Single)	sınıfının yeni bir örneğini SemanticValue başlatır ve bir anlam değeri, bir anahtar adı ve güvenilirlik düzeyi belirtir.

Özellikler

Name	Description
Confidence	geçerli örneğini döndüren semantik ayrıştırmanın doğruluğuna ilişkin kesinliğin göreli bir ölçüsünü SemanticValuedöndürür.
Count	Geçerli SemanticValue örneğin altındaki alt SemanticValue nesnelerin sayısını döndürür.
Item[String]	Geçerli SemanticValueöğesine ait alt SemanticValue örnekleri döndürür.
Value	Geçerli SemanticValueiçinde yer alan bilgileri döndüren salt okunur bir özellik.

Yöntemler

Name	Description
Contains(KeyValuePair<String,SemanticValue>)	Geçerli SemanticValue örnek koleksiyonunun belirli bir anahtarı ve anahtar/değer çifti SemanticValue olarak ifade edilen belirli bir örneğini içerip içermediğini gösterir.
ContainsKey(String)	Geçerli SemanticValue örnek koleksiyonunun belirli bir anahtar dizesine sahip bir alt SemanticValue örnek içerip içermediğini gösterir.
Equals(Object)	Belirtilen nesnenin öğesinin SemanticValue bir örneği olup olmadığını ve geçerli örneğine SemanticValueeşit olup olmadığını belirler.
GetHashCode()	Bir nesne için SemanticValue karma kod sağlar.

Belirtik Arabirim Kullanımları

Name	Description
ICollection<KeyValuePair<String,SemanticValue>>.Add(KeyValuePair<String,SemanticValue>)	Belirtilen anahtarı ve SemanticValue koleksiyonunu ekler.
ICollection<KeyValuePair<String,SemanticValue>>.Clear()	Koleksiyondan tüm anahtar/değer çiftlerini kaldırır.
ICollection<KeyValuePair<String,SemanticValue>>.CopyTo(KeyValuePair<String,SemanticValue>[], Int32)	Bir anahtar/değer çifti hedeflenen dizideki belirli bir konuma kopyalar.
ICollection<KeyValuePair<String,SemanticValue>>.IsReadOnly	Koleksiyonun salt okunur olup olmadığını gösteren bir değer alır.
ICollection<KeyValuePair<String,SemanticValue>>.Remove(KeyValuePair<String,SemanticValue>)	Belirtilen anahtarı ve SemanticValue koleksiyondan kaldırır.
IDictionary<String,SemanticValue>.Add(String, SemanticValue)	Belirtilen anahtarı ve SemanticValue sözlüğüne ekler.
IDictionary<String,SemanticValue>.Keys	Anahtar/değer çiftleri sözlüğündeki anahtarları içeren bir koleksiyon alır.
IDictionary<String,SemanticValue>.Remove(String)	Belirtilen anahtarı ve SemanticValue sözlükten kaldırır.
IDictionary<String,SemanticValue>.TryGetValue(String, SemanticValue)	SemanticValue Belirtilen anahtarla ilişkili değerini alır.
IDictionary<String,SemanticValue>.Values	Anahtar/değer çiftleri sözlüğündeki değerleri içeren bir koleksiyon alır.
IEnumerable.GetEnumerator()	Bir koleksiyonda yineleyen bir numaralandırıcı döndürür.
IEnumerable<KeyValuePair<String,SemanticValue>>.GetEnumerator()	Bir koleksiyonda yineleyen bir numaralandırıcı döndürür.

Uzantı Metotları

Name	Description
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	aracılığıyla IAsyncEnumerable<T>yineleyen yeni source bir oluşturur.
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Belirtilen anahtar seçici ve öğe seçici işlevlerine göre öğesinden bir FrozenDictionary<TKey,TValue>IEnumerable<T> oluşturur.
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Belirtilen anahtar seçici işlevine göre işlevinden bir FrozenDictionary<TKey,TValue>IEnumerable<T> oluşturur.
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	Belirtilen değerlerle bir FrozenSet<T> oluşturur.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Belirtilen koleksiyondan sabit bir dizi oluşturur.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Bir diziyi numaralandırır ve dönüştürür ve belirtilen anahtar ve değer karşılaştırıcılarını kullanarak içeriğinin sabit bir sözlüğü oluşturur.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Bir diziyi numaralandırır ve dönüştürür ve belirtilen anahtar karşılaştırıcıyı kullanarak içeriğinin sabit bir sözlüğü oluşturur.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Bir diziyi numaralandırır ve dönüştürür ve içeriğinin sabit bir sözlüğü oluşturur.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Bir dizideki bazı dönüştürmeleri temel alan sabit bir sözlük oluşturur.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Var olan bir öğe koleksiyonundan sabit bir sözlük oluşturur ve kaynak anahtarlara bir dönüştürme işlevi uygular.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Bir diziyi numaralandırır, içeriğini sabit bir karma kümesi oluşturur ve küme türü için belirtilen eşitlik karşılaştırıcısını kullanır.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Bir diziyi numaralandırır ve içeriğinin sabit bir karma kümesini oluşturur.
ToImmutableList<TSource>(IEnumerable<TSource>)	Bir diziyi numaralandırır ve içeriğinin sabit bir listesini oluşturur.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Bir diziyi numaralandırır ve dönüştürür ve belirtilen anahtar ve değer karşılaştırıcılarını kullanarak içeriğinin sabit bir sıralanmış sözlüğü oluşturur.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Bir diziyi numaralandırır ve dönüştürür ve belirtilen anahtar karşılaştırıcıyı kullanarak içeriğinin sabit bir sıralanmış sözlüğü oluşturur.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Bir diziyi numaralandırır ve dönüştürür ve içeriğinin sabit sıralanabilir bir sözlüğü oluşturur.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Bir diziyi numaralandırır, içeriğinin sabit bir sıralanmış kümesini oluşturur ve belirtilen karşılaştırıcıyı kullanır.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Bir diziyi numaralandırır ve içindekilerin sabit sıralanabilir bir kümesini oluşturur.

Ayrıca bkz.

• SemanticResultValue
• SemanticResultKey