SpeechRecognitionEngine.UpdateRecognizerSetting Método

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v9.0.0-rc.2.24473.5

Actualiza el valor de una configuración para el reconocedor.

Sobrecargas

UpdateRecognizerSetting(String, Int32)	Actualiza el valor especificado para SpeechRecognitionEngine con el valor entero especificado.
UpdateRecognizerSetting(String, String)	Actualiza el valor especificado del motor de reconocimiento de voz con el valor de cadena especificado.

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 en milisegundos (ms) 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 devolver una de las opciones de configuración del reconocedor, use el QueryRecognizerSetting método .

Con la excepción de , los valores de PersistedBackgroundAdaptationpropiedad establecidos con los UpdateRecognizerSetting métodos permanecen en vigor solo para la instancia actual de SpeechRecognitionEngine, después de lo cual revierten a su configuración predeterminada.

Puede modificar cómo responde el reconocimiento de voz a la entrada que no es de voz mediante las BabbleTimeoutpropiedades , InitialSilenceTimeout, EndSilenceTimeouty EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Source:

SpeechRecognitionEngine.cs

Actualiza el valor especificado para SpeechRecognitionEngine con el valor entero especificado.

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)

Parámetros

settingName

String

Nombre del la configuración que va a actualizarse.

updatedValue

Int32

Nuevo 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. En el ejemplo se actualiza la configuración del nivel de confianza y, a continuación, se consulta al reconocedor para comprobar los valores actualizados. 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  

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();  
    }  
  }  
}  

Comentarios

Con la excepción de , los valores de PersistedBackgroundAdaptationpropiedad establecidos con el UpdateRecognizerSetting método permanecen en vigor solo para la instancia actual de SpeechRecognitionEngine, después de lo cual revierten a su configuración predeterminada. Consulte UpdateRecognizerSetting para obtener descripciones de la configuración admitida.

Consulte también

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Source:

SpeechRecognitionEngine.cs

Actualiza el valor especificado del motor de reconocimiento de voz con el valor de cadena especificado.

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)

Parámetros

settingName

String

Nombre del la configuración que va a actualizarse.

updatedValue

String

Nuevo 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.

Comentarios

Con la excepción de , los valores de PersistedBackgroundAdaptationpropiedad establecidos con el UpdateRecognizerSetting método permanecen en vigor solo para la instancia actual de SpeechRecognitionEngine, después de lo cual revierten a su configuración predeterminada. Consulte UpdateRecognizerSetting para obtener descripciones de la configuración admitida.

Consulte también

• QueryRecognizerSetting(String)