SpeechRecognitionEngine.UpdateRecognizerSetting Methode

Definition

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paket:

System.Speech v11.0.0-preview.2.26159.112

Aktualisiert den Wert einer Einstellung für die Erkennung.

Überlädt

Name	Beschreibung
UpdateRecognizerSetting(String, Int32)	Aktualisiert die angegebene Einstellung für die SpeechRecognitionEngine mit dem angegebenen ganzzahligen Wert.
UpdateRecognizerSetting(String, String)	Aktualisiert die angegebene Einstellung des Spracherkennungsmoduls mit dem angegebenen Zeichenfolgenwert.

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 in Millisekunden (ms) 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 die QueryRecognizerSetting Methode, um eine der Einstellungen der Erkennung zurückzugeben.

Mit Ausnahme von PersistedBackgroundAdaptationEigenschaftenwerten, die mit den UpdateRecognizerSetting Methoden festgelegt wurden, bleiben nur für die aktuelle Instanz von SpeechRecognitionEngine, nach der sie auf ihre Standardeinstellungen zurückgesetzt werden.

Sie können ändern, wie die Spracherkennung auf Nicht-Spracheingaben reagiert, indem Sie die BabbleTimeoutEigenschaften , InitialSilenceTimeout, und EndSilenceTimeoutEndSilenceTimeoutAmbiguous dies verwenden.

UpdateRecognizerSetting(String, Int32)

Quelle:

SpeechRecognitionEngine.cs

Aktualisiert die angegebene Einstellung für die SpeechRecognitionEngine mit dem angegebenen ganzzahligen Wert.

public:
 void UpdateRecognizerSetting(System::String ^ settingName, int updatedValue);

public void UpdateRecognizerSetting(string settingName, int updatedValue);

member this.UpdateRecognizerSetting : string * int -> unit

Public Sub UpdateRecognizerSetting (settingName As String, updatedValue As Integer)

Parameter

settingName

String

Der Name der zu aktualisierenden Einstellung.

updatedValue

Int32

Der neue Wert für die 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 werden die Einstellungen für das Konfidenzniveau aktualisiert, und anschließend wird die Erkennung abfragen, um die aktualisierten Werte zu überprüfen. 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

Updated settings:

  ResourceUsage                  is not supported by this recognizer.
  ResponseSpeed                  = 200
  ComplexResponseSpeed           = 300
  AdaptationOn                   = 0
  PersistedBackgroundAdaptation  = 0

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

        // List the current settings.
        ListSettings(recognizer);

        // Change some of the settings.
        recognizer.UpdateRecognizerSetting("ResponseSpeed", 200);
        recognizer.UpdateRecognizerSetting("ComplexResponseSpeed", 300);
        recognizer.UpdateRecognizerSetting("AdaptationOn", 1);
        recognizer.UpdateRecognizerSetting("PersistedBackgroundAdaptation", 0);

        Console.WriteLine("Updated settings:");
        Console.WriteLine();

        // List the updated settings.
        ListSettings(recognizer);
      }

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

    private static void ListSettings(SpeechRecognitionEngine recognizer)
    {
      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();
    }
  }
}

Hinweise

Mit Ausnahme von PersistedBackgroundAdaptationEigenschaftenwerten, die mit der UpdateRecognizerSetting Methode festgelegt werden, bleiben nur für die aktuelle Instanz von SpeechRecognitionEngine, nach der sie auf ihre Standardeinstellungen zurückgesetzt werden. Beschreibungen der unterstützten Einstellungen finden Sie UpdateRecognizerSetting unter.

Weitere Informationen

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Quelle:

SpeechRecognitionEngine.cs

Aktualisiert die angegebene Einstellung des Spracherkennungsmoduls mit dem angegebenen Zeichenfolgenwert.

public:
 void UpdateRecognizerSetting(System::String ^ settingName, System::String ^ updatedValue);

public void UpdateRecognizerSetting(string settingName, string updatedValue);

member this.UpdateRecognizerSetting : string * string -> unit

Public Sub UpdateRecognizerSetting (settingName As String, updatedValue As String)

Parameter

settingName

String

Der Name der zu aktualisierenden Einstellung.

updatedValue

String

Der neue Wert für die Einstellung.

Ausnahmen

ArgumentNullException

settingName ist null.

ArgumentException

settingName ist die leere Zeichenfolge ("").

KeyNotFoundException

Die Erkennung hat keine Einstellung mit diesem Namen.

Hinweise

Mit Ausnahme von PersistedBackgroundAdaptationEigenschaftenwerten, die mit der UpdateRecognizerSetting Methode festgelegt werden, bleiben nur für die aktuelle Instanz von SpeechRecognitionEngine, nach der sie auf ihre Standardeinstellungen zurückgesetzt werden. Beschreibungen der unterstützten Einstellungen finden Sie UpdateRecognizerSetting unter.

Weitere Informationen

• QueryRecognizerSetting(String)