Freigeben über


SpeechRecognitionEngine.QueryRecognizerSetting(String) Methode

Definition

Gibt die Werte von Einstellungen für das Erkennungsmodul zurück.

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

Parameter

settingName
String

Der Name der Einstellung, die zurückgegeben werden soll.

Gibt zurück

Object

Der Wert der Einstellung.

Ausnahmen

settingName ist null.

settingName ist die leere Zeichenfolge ("").

Die Erkennung verfügt über keine Einstellung mit diesem Namen.

Beispiele

Das folgende Beispiel ist Teil einer Konsolenanwendung, die die Werte für eine Reihe von Einstellungen ausgibt, die für die Erkennung definiert sind, die das Gebiets Schema "en-US" unterstützt. Im Beispiel wird die folgende Ausgabe generiert.

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

Hinweise

Die Erkennungseinstellungen können Zeichen folgen-, 64-Bit-ganzzahlige oder Speicher Adressdaten enthalten. In der folgenden Tabelle werden die Einstellungen beschrieben, die für eine SAPI-kompatible Erkennung (Microsoft Speech API) definiert sind. Die folgenden Einstellungen müssen für jede Erkennung, die die-Einstellung unterstützt, denselben Bereich aufweisen. Ein SAPI-kompatibles Erkennungs Modul ist nicht erforderlich, um diese Einstellungen zu unterstützen, und kann andere Einstellungen unterstützen.

Name Beschreibung
ResourceUsage Gibt die CPU-Auslastung des Erkennungs Moduls an. Der Bereich liegt zwischen 0 und 100. Der Standardwert ist 50.
ResponseSpeed Gibt die Länge der Stille am Ende der eindeutigen Eingabe an, bevor die Spracherkennung einen Erkennungs Vorgang abschließt. Der Bereich liegt zwischen 0 und 10.000 Millisekunden (MS). Diese Einstellung entspricht der-Eigenschaft des Erkennungs Moduls EndSilenceTimeout . Standardwert: 150 ms.
ComplexResponseSpeed Gibt die Länge der Stille am Ende der mehrdeutigen Eingabe an, bevor die Spracherkennung einen Erkennungs Vorgang abschließt. Der Bereich liegt zwischen 0 und 10.000 ms. Diese Einstellung entspricht der-Eigenschaft des Erkennungs Moduls EndSilenceTimeoutAmbiguous . Standardwert = 500 ms.
AdaptationOn Gibt an, ob die Anpassung des Akustik Modells on (Value = 1 ) oder Off (Value = 0 ) ist. Der Standardwert ist 1 (on).
PersistedBackgroundAdaptation Gibt an, ob die Hintergrund Anpassung on (Value = 1 ) oder Off (Value = 0 ) ist, und speichert die Einstellung in der Registrierung. Der Standardwert ist 1 (on).

Um eine Einstellung für die Erkennung zu aktualisieren, verwenden Sie eine der- UpdateRecognizerSetting Methoden.

Gilt für

Siehe auch