SpeechRecognitionEngine.UpdateRecognizerSetting Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Met à jour la valeur d’un paramètre pour le module de reconnaissance.
Surcharges
| Nom | Description |
|---|---|
| UpdateRecognizerSetting(String, Int32) |
Met à jour le paramètre spécifié pour la SpeechRecognitionEngine 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 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 en millisecondes (ms) à 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 renvoyer 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 à une entrée non vocale à l’aide des propriétés, et InitialSilenceTimeoutEndSilenceTimeoutEndSilenceTimeoutAmbiguous des BabbleTimeoutpropriétés.
UpdateRecognizerSetting(String, Int32)
- Source:
- SpeechRecognitionEngine.cs
- Source:
- SpeechRecognitionEngine.cs
- Source:
- SpeechRecognitionEngine.cs
- Source:
- SpeechRecognitionEngine.cs
Met à jour le paramètre spécifié pour la SpeechRecognitionEngine 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 -> unitPublic 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
settingName a la valeur null.
settingName est la chaîne vide (« »).
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 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 les descriptions des paramètres pris en charge.
Voir aussi
S’applique à
UpdateRecognizerSetting(String, String)
- Source:
- SpeechRecognitionEngine.cs
- Source:
- SpeechRecognitionEngine.cs
- Source:
- SpeechRecognitionEngine.cs
- 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 -> unitPublic 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
settingName a la valeur null.
settingName est la chaîne vide (« »).
Le module de reconnaissance n’a pas de paramètre par 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 les descriptions des paramètres pris en charge.
