Partager via


SpeechRecognitionEngine.QueryRecognizerSetting(String) Méthode

Définition

Retourne les valeurs des paramètres pour le module de reconnaissance.

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

Paramètres

settingName
String

Nom du paramètre à retourner.

Retours

Object

La valeur du paramètre.

Exceptions

settingName a la valeur null.

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

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 des paramètres définis pour le module de reconnaissance qui prend en charge les paramètres régionaux en-US. 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  

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

Remarques

Les paramètres de reconnaissance peuvent contenir une chaîne, un entier 64 bits ou des données d’adresse mémoire. Le tableau suivant décrit les paramètres définis pour un module de reconnaissance compatible avec l’API Microsoft Speech (SAPI). 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 compatible SAPI n’est pas requis pour prendre en charge ces paramètres et peut prendre en charge d’autres paramètres.

Nom Description
ResourceUsage Spécifie la consommation de l’UC 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 n’effectue 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 reconnaissance EndSilenceTimeout . Valeur par défaut : 150 m.
ComplexResponseSpeed Indique la longueur du silence à la fin de l’entrée ambiguë avant que le module de reconnaissance vocale n’effectue 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 reconnaissance EndSilenceTimeoutAmbiguous . Valeur par défaut = 500 ms.
AdaptationOn Indique si l’adaptation du modèle acoustique est activée (valeur = 1 ) ou DÉSactivée (valeur = 0 ). La valeur par défaut est 1 (on).
PersistedBackgroundAdaptation Indique si l’adaptation en arrière-plan est activée (valeur = 1 ) ou DÉSactivée (valeur = 0 ) et conserve le paramètre dans le registre. La valeur par défaut est 1 (on).

Pour mettre à jour un paramètre pour le module de reconnaissance, utilisez l’une des UpdateRecognizerSetting méthodes.

S’applique à

Voir aussi