SemanticValue 클래스

정의

네임스페이스:

System.Speech.Recognition

어셈블리:

System.Speech.dll

패키지:

System.Speech v8.0.0

Source:

SemanticValue.cs

인식된 구의 의미 체계 구성을 나타냅니다.

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 0으로 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 개체 자식과 구 백그라운드 또는 포그라운드 ("백그라운드" 텍스트로 표시 됨) 및 선택에 대 한 기타 선택에 대 한 두 가지 의미 체계 하위 구조체에 지정 하 여 처리 되도록 의미 해석을 지정할 수 있습니다 색 (텍스트 "red"로 표현 됨).

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

일반적으로 애플리케이션은 및 개체와 함께 ChoicesGrammarBuilder 및 SemanticResultKey 인스턴스를 Grammar 사용하여 SemanticResultValue 인스턴스를 개체에 추가하여 간접적으로 인스턴스를 만듭니 SemanticValue 다.

직접 생성 한 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)	지정된 개체가 의 instance 및 의 SemanticValue 현재 instance 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