SpeechRecognitionEngine.QueryRecognizerSetting(String) Método

Definición

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

Object

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.

Se aplica a

Consulte también