SpeechRecognitionEngine.UpdateRecognizerSetting Méthode

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paquet:

System.Speech v9.0.0-preview.3.24172.9

Met à jour la valeur d'un paramètre du module de reconnaissance.

Surcharges

UpdateRecognizerSetting(String, Int32)	Met à jour le paramètre spécifié pour SpeechRecognitionEngine avec la valeur entière spécifiée.
UpdateRecognizerSetting(String, String)	Met à jour le paramètre du moteur de reconnaissance vocale spécifié avec la valeur de chaîne spécifiée.

Remarques

Les paramètres du module de reconnaissance peuvent contenir des données de chaîne, d’entier 64 bits ou d’adresse mémoire. Le tableau suivant décrit les paramètres définis pour un module de reconnaissance conforme à l’API Speech (SAPI) Microsoft. Les paramètres suivants doivent avoir la même plage pour chaque module de reconnaissance qui prend en charge le paramètre. Un module de reconnaissance conforme SAPI n’est pas nécessaire pour prendre en charge ces paramètres et peut prendre en charge d’autres paramètres.

Nom	Description
ResourceUsage	Spécifie la consommation du processeur du module de reconnaissance. La plage est comprise entre 0 et 100. La valeur par défaut est 50.
ResponseSpeed	Indique la longueur du silence à la fin d’une entrée non ambiguë avant que le module de reconnaissance vocale ne termine une opération de reconnaissance. La plage est comprise entre 0 et 10 000 millisecondes (ms). Ce paramètre correspond à la propriété du module de EndSilenceTimeout reconnaissance. Valeur par défaut = 150 ms.
ComplexResponseSpeed	Indique la longueur du silence en millisecondes (ms) à la fin d’une entrée ambiguë avant que le module de reconnaissance vocale ne termine une opération de reconnaissance. La plage est comprise entre 0 et 10 000 ms. Ce paramètre correspond à la propriété du module de EndSilenceTimeoutAmbiguous reconnaissance. Valeur par défaut = 500 ms.
AdaptationOn	Indique si l’adaptation du modèle acoustique est ON (value = 1) ou OFF (value = 0). La valeur par défaut est 1 (ON).
PersistedBackgroundAdaptation	Indique si l’adaptation en arrière-plan est ACTIVÉE (valeur = 1) ou OFF (valeur = 0) et conserve le paramètre dans le Registre. La valeur par défaut est 1 (ON).

Pour retourner l’un des paramètres du module de reconnaissance, utilisez la QueryRecognizerSetting méthode .

À l’exception de , les valeurs de PersistedBackgroundAdaptationpropriété définies à l’aide des UpdateRecognizerSetting méthodes restent en vigueur uniquement pour l’instance actuelle de SpeechRecognitionEngine, après quoi elles reviennent à leurs paramètres par défaut.

Vous pouvez modifier la façon dont la reconnaissance vocale répond aux entrées non vocales à l’aide des BabbleTimeoutpropriétés , InitialSilenceTimeout, EndSilenceTimeoutet EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Source:

SpeechRecognitionEngine.cs

Met à jour le paramètre spécifié pour SpeechRecognitionEngine avec la valeur entière spécifiée.

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)

Paramètres

settingName

String

Nom du paramètre à mettre à jour.

updatedValue

Int32

Nouvelle valeur du paramètre.

Exceptions

ArgumentNullException

settingName a la valeur null.

ArgumentException

settingName est la chaîne vide ("").

KeyNotFoundException

Le module de reconnaissance n'a pas de paramètre correspondant à ce nom.

Exemples

L’exemple suivant fait partie d’une application console qui génère les valeurs d’un certain nombre de paramètres définis pour le module de reconnaissance qui prend en charge les paramètres régionaux en-US. L’exemple met à jour les paramètres de niveau de confiance, puis interroge le module de reconnaissance pour vérifier les valeurs mises à jour. L’exemple génère la sortie suivante.

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

Remarques

À l’exception de , les valeurs de propriété définies à l’aide de PersistedBackgroundAdaptationla UpdateRecognizerSetting méthode restent en vigueur uniquement pour l’instance actuelle de SpeechRecognitionEngine, après quoi elles reviennent à leurs paramètres par défaut. Consultez UpdateRecognizerSetting pour obtenir une description des paramètres pris en charge.

Voir aussi

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Source:

SpeechRecognitionEngine.cs

Met à jour le paramètre du moteur de reconnaissance vocale spécifié avec la valeur de chaîne spécifiée.

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)

Paramètres

settingName

String

Nom du paramètre à mettre à jour.

updatedValue

String

Nouvelle valeur du paramètre.

Exceptions

ArgumentNullException

settingName a la valeur null.

ArgumentException

settingName est la chaîne vide ("").

KeyNotFoundException

Le module de reconnaissance n'a pas de paramètre correspondant à ce nom.

Remarques

À l’exception de , les valeurs de propriété définies à l’aide de PersistedBackgroundAdaptationla UpdateRecognizerSetting méthode restent en vigueur uniquement pour l’instance actuelle de SpeechRecognitionEngine, après quoi elles reviennent à leurs paramètres par défaut. Consultez UpdateRecognizerSetting pour obtenir une description des paramètres pris en charge.

Voir aussi

• QueryRecognizerSetting(String)