SpeechRecognitionEngine.UpdateRecognizerSetting Methode

Definition

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paket:

System.Speech v9.0.0-preview.3.24172.9

Aktualisiert den Wert einer Einstellung für das Erkennungsmodul.

Überlädt

UpdateRecognizerSetting(String, Int32)	Aktualisiert die angegebene Einstellung für die SpeechRecognitionEngine mit dem angegebenen ganzzahligen Wert.
UpdateRecognizerSetting(String, String)	Aktualisiert die angegebene Spracherkennungs-Engine-Einstellung 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-konforme Erkennung (Microsoft Speech API) definiert sind. Die folgenden Einstellungen müssen für jede Erkennung, die die Einstellung unterstützt, den gleichen Bereich aufweisen. Eine SAPI-konforme Erkennung ist nicht erforderlich, um diese Einstellungen zu unterstützen, und kann andere Einstellungen unterstützen.

Name	Beschreibung
ResourceUsage	Gibt den CPU-Verbrauch der Erkennung an. Der Bereich reicht von 0 bis 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 reicht von 0 bis 10.000 Millisekunden (ms). Diese Einstellung entspricht der Eigenschaft der EndSilenceTimeout Erkennung. 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 reicht von 0 bis 10.000 ms. Diese Einstellung entspricht der Eigenschaft der EndSilenceTimeoutAmbiguous Erkennung. Standard = 500 ms.
AdaptationOn	Gibt an, ob die Anpassung des Akustikmodells on (value = 1) oder OFF (value = 0) lautet. Der Standardwert ist 1 (ON).
PersistedBackgroundAdaptation	Gibt an, ob die Hintergrundanpassung ON (value = 1) oder OFF (value = 0) ist und die Einstellung in der Registrierung beibehalten wird. Der Standardwert ist 1 (ON).

Verwenden Sie QueryRecognizerSetting die -Methode, um eine der Einstellungen der Erkennung zurückzugeben.

Mit Ausnahme von PersistedBackgroundAdaptationbleiben mit den UpdateRecognizerSetting -Methoden festgelegte Eigenschaftswerte nur für die aktuelle Instanz von SpeechRecognitionEnginein Kraft, nach der sie zu ihren Standardeinstellungen zurückgesetzt werden.

Sie können ändern, wie die Spracherkennung auf Nicht-Spracheingaben reagiert, indem Sie die BabbleTimeoutEigenschaften , InitialSilenceTimeout, EndSilenceTimeoutund EndSilenceTimeoutAmbiguous 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 der Einstellung.

Ausnahmen

ArgumentNullException

settingName ist null.

ArgumentException

settingName ist die leere Zeichenfolge ("").

KeyNotFoundException

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 der Für die Erkennung definierten Einstellungen ausgibt, die das Gebietsschema en-US unterstützt. Das Beispiel aktualisiert die Einstellungen für das Konfidenzniveau und fragt dann die Erkennung ab, 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 PersistedBackgroundAdaptationbleiben mit der UpdateRecognizerSetting -Methode festgelegte Eigenschaftswerte nur für die aktuelle Instanz von SpeechRecognitionEnginein Kraft, nach der sie zu ihren 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 Spracherkennungs-Engine-Einstellung 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 der Einstellung.

Ausnahmen

ArgumentNullException

settingName ist null.

ArgumentException

settingName ist die leere Zeichenfolge ("").

KeyNotFoundException

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

Hinweise

Mit Ausnahme von PersistedBackgroundAdaptationbleiben mit der UpdateRecognizerSetting -Methode festgelegte Eigenschaftswerte nur für die aktuelle Instanz von SpeechRecognitionEnginein Kraft, nach der sie zu ihren Standardeinstellungen zurückgesetzt werden. Beschreibungen der unterstützten Einstellungen finden Sie UpdateRecognizerSetting unter.

Weitere Informationen

• QueryRecognizerSetting(String)