SpeechRecognitionEngine.QueryRecognizerSetting(String) 메서드

정의

네임스페이스:

System.Speech.Recognition

어셈블리:

System.Speech.dll

인식기에 대한 설정의 값을 반환합니다.

public:
 System::Object ^ QueryRecognizerSetting(System::String ^ settingName);

public object QueryRecognizerSetting (string settingName);

member this.QueryRecognizerSetting : string -> obj

Public Function QueryRecognizerSetting (settingName As String) As Object

매개 변수

settingName

String

반환할 설정의 이름입니다.

반환

Object

설정의 값입니다.

예외

ArgumentNullException

settingName이(가) null인 경우

ArgumentException

settingName가 빈 문자열("")입니다.

KeyNotFoundException

인식기에는 해당 이름의 설정이 없습니다.

예제

다음 예제는 다양 한 EN-US 로캘을 지 인식기에 대해 정의 된 설정에 대 한 값을 출력 하는 콘솔 애플리케이션의 일부입니다. 이 예에서는 다음과 같은 출력을 생성 합니다.

Settings for recognizer MS-1033-80-DESK:  

  ResourceUsage                  is not supported by this recognizer.  
  ResponseSpeed                  = 150  
  ComplexResponseSpeed           = 500  
  AdaptationOn                   = 1  
  PersistedBackgroundAdaptation  = 1  

Press any key to exit...  

using System;  
using System.Globalization;  
using System.Speech.Recognition;  

namespace RecognizerSettings  
{  
  class Program  
  {  
    static readonly string[] settings = new string[] {  
      "ResourceUsage",  
      "ResponseSpeed",  
      "ComplexResponseSpeed",  
      "AdaptationOn",  
      "PersistedBackgroundAdaptation"  
    };  

    static void Main(string[] args)  
    {  
      using (SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(new System.Globalization.CultureInfo("en-US")))  
      {  
        Console.WriteLine("Settings for recognizer {0}:",  
          recognizer.RecognizerInfo.Name);  
        Console.WriteLine();  

        foreach (string setting in settings)  
        {  
          try  
          {  
            object value = recognizer.QueryRecognizerSetting(setting);  
            Console.WriteLine("  {0,-30} = {1}", setting, value);  
          }  
          catch  
          {  
            Console.WriteLine("  {0,-30} is not supported by this recognizer.",  
              setting);  
          }  
        }  
      }  
      Console.WriteLine();  

      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

설명

인식기 설정에는 문자열, 64 비트 정수 또는 메모리 주소 데이터가 포함 될 수 있습니다. 다음 표에서는 SAPI (Microsoft Speech API) 규격 인식기에 대해 정의 된 설정을 설명 합니다. 다음 설정은 설정을 지 원하는 각 인식기에 대해 동일한 범위를 가져야 합니다. SAPI 규격 인식기는 이러한 설정을 지원 하기 위해 필요 하지 않으며 다른 설정을 지원할 수 있습니다.

Name	설명
ResourceUsage	인식기의 CPU 소비를 지정 합니다. 범위는 0에서 100 까지입니다. 기본값은 50입니다.
ResponseSpeed	음성 인식기가 인식 작업을 완료 하기 전에 명확 하지 않은 입력의 끝에 있는 침묵의 길이를 나타냅니다. 범위는 0에서 1만 밀리초 (밀리초)입니다. 이 설정은 인식기의 속성에 해당 EndSilenceTimeout 합니다. 기본값은 150ms입니다.
ComplexResponseSpeed	음성 인식기가 인식 작업을 완료 하기 전에 모호한 입력의 끝에 있는 침묵의 길이를 나타냅니다. 범위는 0에서 10, 000ms 사이입니다. 이 설정은 인식기의 속성에 해당 EndSilenceTimeoutAmbiguous 합니다. 기본값은 500ms입니다.
AdaptationOn	음향 모델의 적응 (값 = 1 ) 또는 꺼짐 (값 =)이 설정 되어 있는지 여부를 나타냅니다 0 . 기본값은 1 (설정)입니다.
PersistedBackgroundAdaptation	배경 적응의 설정 (값 = 1 ) 또는 해제 (값 =)가 설정 되어 있는지 여부를 나타내며 0 레지스트리에서 설정을 유지 합니다. 기본값은 1 (설정)입니다.

인식기에 대 한 설정을 업데이트 하려면 방법 중 하나를 사용 UpdateRecognizerSetting 합니다.

추가 정보

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous