SpeechRecognitionEngine.QueryRecognizerSetting(String) Método

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v9.0.0-preview.3.24172.9

Source:

SpeechRecognitionEngine.cs

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

ArgumentNullException

settingName es null.

ArgumentException

settingName es la cadena vacía ("").

KeyNotFoundException

El reconocedor no tiene un valor con ese nombre.

Ejemplos

El ejemplo siguiente forma parte de una aplicación de consola que genera los valores de una serie de la configuración definida para el reconocedor que admite la configuración regional en-US. El ejemplo genera la siguiente salida.

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 describen las opciones definidas para un reconocedor compatible con Speech API (SAPI) de Microsoft. La siguiente configuración debe tener el mismo intervalo para cada reconocedor que admita la configuración. No se requiere un reconocedor compatible con SAPI para admitir esta configuración y puede admitir otras configuraciones.

Nombre	Descripción
ResourceUsage	Especifica el consumo de CPU del reconocedor. El intervalo es de 0 a 100. El valor predeterminado es 50.
ResponseSpeed	Indica la longitud del silencio al final de una entrada inequívoca antes de que el reconocedor de voz complete una operación de reconocimiento. El intervalo es de 0 a 10 000 milisegundos (ms). Este valor corresponde a la propiedad del EndSilenceTimeout reconocedor. Valor predeterminado = 150 ms.
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 es de 0 a 10 000 ms. Este valor corresponde a la propiedad del EndSilenceTimeoutAmbiguous reconocedor. Valor predeterminado = 500 ms.
AdaptationOn	Indica si la adaptación del modelo acústico es ON (valor = 1) o OFF (valor = 0). El valor predeterminado es 1 (ON).
PersistedBackgroundAdaptation	Indica si la adaptación en segundo plano es ON (valor = 1) o OFF (valor = 0) y conserva la configuración en el Registro. El valor predeterminado es 1 (ON).

Para actualizar una configuración para el reconocedor, use uno de los UpdateRecognizerSetting métodos .

Consulte también

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous