SpeechRecognitionEngine.QueryRecognizerSetting(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve los valores de configuración para el reconocedor.
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
Parámetros
- settingName
- String
Nombre de la configuración que se devolverá.
Devoluciones
El valor de la configuración.
Excepciones
settingName es null.
settingName es la cadena vacía ("").
El reconocedor no tiene un valor con ese nombre.
Ejemplos
El siguiente ejemplo forma parte de una aplicación de consola que genera los valores de una serie de valores definidos para el reconocedor que admite la configuración regional en-US. En el ejemplo se genera el siguiente resultado.
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();
}
}
}
Comentarios
La configuración del reconocedor puede contener datos de cadena, enteros de 64 bits o direcciones de memoria. En la tabla siguiente se describe la configuración definida para un reconocedor compatible con Microsoft Speech API (SAPI). La configuración siguiente debe tener el mismo intervalo para cada reconocedor que admita la configuración. No es necesario que un reconocedor compatible con SAPI admita estas opciones de configuración y admita otras opciones de configuración.
| Nombre | Descripción |
|---|---|
ResourceUsage |
Especifica el consumo de CPU del reconocedor. El intervalo está comprendido entre 0 y 100. El valor predeterminado es 50. |
ResponseSpeed |
Indica la longitud del silencio al final de la entrada no ambigua antes de que el reconocedor de voz complete una operación de reconocimiento. El intervalo está comprendido entre 0 y 10.000 milisegundos (MS). Este valor corresponde a la propiedad del reconocedor EndSilenceTimeout . Valor predeterminado = 150MS. |
ComplexResponseSpeed |
Indica la longitud del silencio al final de la entrada ambigua antes de que el reconocedor de voz complete una operación de reconocimiento. El intervalo está comprendido entre 0 y 10, 000 MS. Este valor corresponde a la propiedad del reconocedor EndSilenceTimeoutAmbiguous . Valor predeterminado = 500 ms. |
AdaptationOn |
Indica si la adaptación del modelo acústico está activada (valor = 1 ) o DESactivado (valor = 0 ). El valor predeterminado es 1 (ON). |
PersistedBackgroundAdaptation |
Indica si la adaptación del fondo está activada (valor = 1 ) o DESactivado (valor = 0 ) y conserva la configuración en el registro. El valor predeterminado es 1 (ON). |
Para actualizar un valor de configuración para el reconocedor, use uno de los UpdateRecognizerSetting métodos.