SpeechRecognitionEngine.QueryRecognizerSetting(String) Metoda

Definice

Vrátí hodnoty nastavení pro nástroj pro rozpoznávání.

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

Parametry

settingName
String

Název nastavení, které se má vrátit

Návraty

Object

Hodnota nastavení

Výjimky

settingName je null.

settingName je prázdný řetězec ("").

Nástroj pro rozpoznávání nemá nastavení s tímto názvem.

Příklady

Následující příklad je součástí konzolové aplikace, která vrací hodnoty pro určitý počet nastavení definovaných pro nástroj pro rozpoznávání, který podporuje národní prostředí en-US. Tento příklad generuje následující výstup.

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

Poznámky

Nastavení nástroje pro rozpoznávání může obsahovat řetězec, 64 celé číslo nebo data o adrese paměti. Následující tabulka popisuje nastavení, která jsou definována pro nástroj pro rozpoznávání kompatibilního se standardem Microsoft Speech API (SAPI). Následující nastavení musí mít stejný rozsah pro každý nástroj pro rozpoznávání, který podporuje nastavení. Nástroj pro rozpoznávání kompatibilní s rozhraním SAPI není potřebný k podpoře těchto nastavení a může podporovat jiné nastavení.

Název Description
ResourceUsage Určuje spotřebu procesoru pro rozpoznávání. Rozsah je od 0 do 100. Výchozí hodnota je 50.
ResponseSpeed Určuje délku Tichy na konci nejednoznačného vstupu před tím, než Nástroj pro rozpoznávání řeči dokončí operaci rozpoznávání. Rozsah je od 0 do 10 000 milisekund (MS). Toto nastavení odpovídá vlastnosti nástroje pro rozpoznávání EndSilenceTimeout . Výchozí nastavení = 150MS.
ComplexResponseSpeed Určuje délku tichého vstupu na konci dvojznačného vstupu před tím, než Nástroj pro rozpoznávání řeči dokončí operaci rozpoznávání. Rozsah je od 0 do 10, 000ms. Toto nastavení odpovídá vlastnosti nástroje pro rozpoznávání EndSilenceTimeoutAmbiguous . Výchozí nastavení = 500 ms.
AdaptationOn Určuje, zda je přizpůsobení akustického modelu ZAPNUTo (hodnota = 1 ) nebo vypnuto (hodnota = 0 ). Výchozí hodnota je 1 (zapnuto).
PersistedBackgroundAdaptation Označuje, zda je přizpůsobení pozadí ZAPNUTé (hodnota = 1 ) nebo vypnuto (hodnota = 0 ), a uchovává nastavení v registru. Výchozí hodnota je 1 (zapnuto).

Chcete-li aktualizovat nastavení pro nástroj pro rozpoznávání, použijte jednu z UpdateRecognizerSetting metod.

Platí pro

Viz také