Udostępnij za pośrednictwem


SpeechRecognitionEngine.QueryRecognizerSetting(String) Metoda

Definicja

Zwraca wartości ustawień dla rozpoznawania.

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

Nazwa ustawienia do zwrócenia.

Zwraca

Wartość ustawienia.

Wyjątki

settingName to null.

settingName jest pustym ciągiem ("").

Rozpoznawanie nie ma ustawienia o tej nazwie.

Przykłady

Poniższy przykład jest częścią aplikacji konsolowej, która generuje wartości dla wielu ustawień zdefiniowanych dla aparatu rozpoznawania, który obsługuje ustawienia regionalne en-US. W przykładzie są generowane następujące dane wyjściowe.

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

Uwagi

Ustawienia rozpoznawania mogą zawierać dane dotyczące ciągów, 64-bitowych liczb całkowitych lub adresów pamięci. W poniższej tabeli opisano ustawienia zdefiniowane dla rozpoznawania zgodnego z interfejsem API rozpoznawania mowy (SAPI) Microsoft. Następujące ustawienia muszą mieć ten sam zakres dla każdego rozpoznawania, który obsługuje to ustawienie. Rozpoznawanie zgodne z oprogramowaniem SAPI nie jest wymagane do obsługi tych ustawień i może obsługiwać inne ustawienia.

Nazwa Opis
ResourceUsage Określa użycie procesora przez aparat rozpoznawania. Zakres wynosi od 0 do 100. Wartość domyślna to 50.
ResponseSpeed Wskazuje długość ciszy na końcu jednoznacznych danych wejściowych przed ukończeniem operacji rozpoznawania mowy. Zakres wynosi od 0 do 10 000 milisekund (ms). To ustawienie odpowiada właściwości rozpoznawania EndSilenceTimeout . Wartość domyślna : 150 ms.
ComplexResponseSpeed Wskazuje długość ciszy na końcu niejednoznacznych danych wejściowych przed ukończeniem operacji rozpoznawania mowy. Zakres wynosi od 0 do 10 000 ms. To ustawienie odpowiada właściwości rozpoznawania EndSilenceTimeoutAmbiguous . Wartość domyślna : 500 ms.
AdaptationOn Wskazuje, czy dostosowanie modelu akustycznego jest WŁĄCZONE (wartość = 1) lub OFF (wartość = 0). Wartość domyślna to 1 (ON).
PersistedBackgroundAdaptation Wskazuje, czy dostosowanie tła jest WŁĄCZONE (wartość = 1) lub OFF (wartość = 0), i utrwala ustawienie w rejestrze. Wartość domyślna to 1 (ON).

Aby zaktualizować ustawienie dla rozpoznawania, użyj jednej z UpdateRecognizerSetting metod.

Dotyczy

Zobacz też