SpeechRecognitionEngine.QueryRecognizerSetting(String) Methode

Definition

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paket:

System.Speech v11.0.0-preview.2.26159.112

Quelle:

SpeechRecognitionEngine.cs

Gibt die Werte der Einstellungen für die Erkennung 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 zurückzugebenden Einstellung.

Gibt zurück

Object

Der Wert der Einstellung.

Ausnahmen

ArgumentNullException

settingName ist null.

ArgumentException

settingName ist die leere Zeichenfolge ("").

KeyNotFoundException

Die Erkennung hat keine Einstellung mit diesem Namen.

Beispiele

Das folgende Beispiel ist Teil einer Konsolenanwendung, die die Werte für eine Reihe der für die Erkennung definierten Einstellungen ausgibt, die das gebietsschema en-US unterstützen. 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

Erkennungseinstellungen können Zeichenfolgen-, 64-Bit-Ganzzahl- oder Speicheradressdaten 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. Eine SAPI-kompatible Erkennung ist nicht erforderlich, um diese Einstellungen zu unterstützen und andere Einstellungen zu unterstützen.

Name	Beschreibung
ResourceUsage	Gibt den CPU-Verbrauch der Erkennung 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 Erkennungsvorgang abschließt. Der Bereich liegt zwischen 0 und 10.000 Millisekunden (ms). Diese Einstellung entspricht der Eigenschaft der Erkennung EndSilenceTimeout . Standard = 150 ms.
ComplexResponseSpeed	Gibt die Länge der Stille am Ende der mehrdeutigen Eingabe an, bevor die Spracherkennung einen Erkennungsvorgang abschließt. Der Bereich liegt zwischen 0 und 10.000 ms. Diese Einstellung entspricht der Eigenschaft der Erkennung EndSilenceTimeoutAmbiguous . Standard = 500 ms.
AdaptationOn	Gibt an, ob die Anpassung des akustischen Modells EIN (Wert = 1) oder OFF (Wert = 0) ist. Der Standardwert ist 1 (ON).
PersistedBackgroundAdaptation	Gibt an, ob die Hintergrundanpassung EIN (Wert = 1) oder OFF (Wert = 0) ist und die Einstellung in der Registrierung beibehalten wird. Der Standardwert ist 1 (ON).

Verwenden Sie eine der UpdateRecognizerSetting Methoden, um eine Einstellung für die Erkennung zu aktualisieren.

Weitere Informationen

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous