Partager via

SpeechRecognitionEngine.QueryRecognizerSetting(String) Méthode

Définition

Espace de noms:
System.Speech.Recognition
Assembly:
System.Speech.dll
Paquet:
System.Speech v11.0.0-preview.2.26159.112
Source:
SpeechRecognitionEngine.cs
Source:
SpeechRecognitionEngine.cs
Source:
SpeechRecognitionEngine.cs
Source:
SpeechRecognitionEngine.cs

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

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 par 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 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 du module de reconnaissance peuvent contenir des données d’adresse de chaîne, d’entier 64 bits ou de mémoire. Le tableau suivant décrit les paramètres définis pour un module de reconnaissance conforme à 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 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 de l’entrée non ambiguë avant que le module de reconnaissance vocale 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 à la fin de l’entrée ambiguë avant que le module de reconnaissance vocale 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 (valeur = 1) ou OFF (valeur = 0). La valeur par défaut est 1 (ON).
PersistedBackgroundAdaptation Indique si l’adaptation en arrière-plan est ON (valeur = 1) ou OFF (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 UpdateRecognizerSetting des méthodes.

S’applique à

Voir aussi