SpeechRecognitionEngine.UpdateRecognizerSetting Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Uppdaterar värdet för en inställning för identifieraren.
Överlagringar
| Name | Description |
|---|---|
| UpdateRecognizerSetting(String, Int32) |
Uppdaterar den angivna inställningen för SpeechRecognitionEngine med det angivna heltalsvärdet. |
| UpdateRecognizerSetting(String, String) |
Uppdaterar den angivna inställningen för taligenkänningsmotorn med det angivna strängvärdet. |
Kommentarer
Inställningar för identifierare kan innehålla sträng-, 64-bitars heltals- eller minnesadressdata. I följande tabell beskrivs de inställningar som har definierats för en sapi-kompatibel identifierare (Microsoft Speech API). Följande inställningar måste ha samma intervall för varje identifierare som stöder inställningen. En SAPI-kompatibel identifierare krävs inte för att stödja dessa inställningar och kan stödja andra inställningar.
| Name | Description |
|---|---|
ResourceUsage |
Anger identifierarens CPU-förbrukning. Intervallet är mellan 0 och 100. Standardvärdet är 50. |
ResponseSpeed |
Anger längden på tystnaden i slutet av tvetydiga indata innan taligenkänningen slutför en igenkänningsåtgärd. Intervallet är mellan 0 och 10 000 millisekunder (ms). Den här inställningen motsvarar identifierarens EndSilenceTimeout egenskap. Standard = 150 ms. |
ComplexResponseSpeed |
Anger längden på tystnaden i millisekunder (ms) i slutet av tvetydiga indata innan taligenkänningen slutför en igenkänningsåtgärd. Intervallet är mellan 0 och 10 000 ms. Den här inställningen motsvarar identifierarens EndSilenceTimeoutAmbiguous egenskap. Standard = 500 ms. |
AdaptationOn |
Anger om anpassningen av den akustiska modellen är PÅ (värde = 1) eller OFF (värde = 0). Standardvärdet är 1 (ON). |
PersistedBackgroundAdaptation |
Anger om bakgrundsanpassningen är PÅ (värde = 1) eller OFF (värde = 0) och bevarar inställningen i registret. Standardvärdet är 1 (ON). |
Om du vill returnera en av identifierarens inställningar använder du QueryRecognizerSetting metoden .
Med undantag för gäller egenskapsvärden PersistedBackgroundAdaptationsom anges med metoderna UpdateRecognizerSetting endast för den aktuella instansen av SpeechRecognitionEngine, varefter de återgår till sina standardinställningar.
Du kan ändra hur taligenkänningen svarar på icke-talindata med hjälp av BabbleTimeoutegenskaperna , InitialSilenceTimeout, EndSilenceTimeoutoch EndSilenceTimeoutAmbiguous .
UpdateRecognizerSetting(String, Int32)
Uppdaterar den angivna inställningen för SpeechRecognitionEngine med det angivna heltalsvärdet.
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)
Parametrar
- settingName
- String
Namnet på den inställning som ska uppdateras.
- updatedValue
- Int32
Det nya värdet för inställningen.
Undantag
settingName är null.
settingName är den tomma strängen ("").
Identifieraren har ingen inställning med det namnet.
Exempel
Följande exempel är en del av ett konsolprogram som matar ut värdena för ett antal av de inställningar som definierats för den identifierare som stöder en-US nationella inställningar. Exemplet uppdaterar inställningarna för konfidensnivå och frågar sedan identifieraren om du vill kontrollera de uppdaterade värdena. Exemplet genererar följande utdata.
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();
}
}
}
Kommentarer
Med undantag för gäller egenskapsvärden PersistedBackgroundAdaptationsom anges med UpdateRecognizerSetting metoden endast för den aktuella instansen av SpeechRecognitionEngine, varefter de återgår till sina standardinställningar. Se UpdateRecognizerSetting beskrivningar av inställningar som stöds.
Se även
Gäller för
UpdateRecognizerSetting(String, String)
Uppdaterar den angivna inställningen för taligenkänningsmotorn med det angivna strängvärdet.
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)
Parametrar
- settingName
- String
Namnet på den inställning som ska uppdateras.
- updatedValue
- String
Det nya värdet för inställningen.
Undantag
settingName är null.
settingName är den tomma strängen ("").
Identifieraren har ingen inställning med det namnet.
Kommentarer
Med undantag för gäller egenskapsvärden PersistedBackgroundAdaptationsom anges med UpdateRecognizerSetting metoden endast för den aktuella instansen av SpeechRecognitionEngine, varefter de återgår till sina standardinställningar. Se UpdateRecognizerSetting beskrivningar av inställningar som stöds.