SpeechRecognitionEngine.QueryRecognizerSetting(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce i valori delle impostazioni per lo strumento di riconoscimento.
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
Parametri
- settingName
- String
Nome dell'impostazione da restituire.
Restituisce
Valore dell'impostazione.
Eccezioni
settingName è null.
settingName è la stringa vuota ("").
Il riconoscitore non dispone di un'impostazione in base a tale nome.
Esempio
L'esempio seguente fa parte di un'applicazione console che restituisce i valori per una serie di impostazioni definite per il riconoscitore che supporta le impostazioni locali en-US. L'esempio genera l'output seguente.
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();
}
}
}
Commenti
Le impostazioni di Riconoscimento possono contenere dati stringa, integer a 64 bit o indirizzo di memoria. Nella tabella seguente vengono descritte le impostazioni definite per un sistema di riconoscimento conforme a SAPI (Microsoft Speech API). Le impostazioni seguenti devono avere lo stesso intervallo per ogni riconoscitore che supporta l'impostazione. Un riconoscitore conforme a SAPI non è necessario per supportare queste impostazioni e può supportare altre impostazioni.
| Nome | Descrizione |
|---|---|
ResourceUsage |
Specifica il consumo della CPU del riconoscitore. L'intervallo è compreso tra 0 e 100. Il valore predefinito è 50. |
ResponseSpeed |
Indica la lunghezza del silenzio alla fine dell'input non ambiguo prima che il riconoscimento vocale completi un'operazione di riconoscimento. L'intervallo è compreso tra 0 e 10.000 millisecondi (ms). Questa impostazione corrisponde alla proprietà del EndSilenceTimeout riconoscitore. Valore predefinito = 150 ms. |
ComplexResponseSpeed |
Indica la lunghezza del silenzio alla fine dell'input ambiguo prima che il riconoscimento vocale completi un'operazione di riconoscimento. L'intervallo è compreso tra 0 e 10.000 ms. Questa impostazione corrisponde alla proprietà del EndSilenceTimeoutAmbiguous riconoscitore. Valore predefinito = 500 ms. |
AdaptationOn |
Indica se l'adattamento del modello acustico è ON (value = 1) o OFF (value = 0). Il valore predefinito è 1 (ON). |
PersistedBackgroundAdaptation |
Indica se l'adattamento in background è ON (valore = 1) o OFF (valore = 0) e mantiene l'impostazione nel Registro di sistema. Il valore predefinito è 1 (ON). |
Per aggiornare un'impostazione per il riconoscitore, usare uno dei UpdateRecognizerSetting metodi .