SpeechRecognitionEngine.UpdateRecognizerSetting Método

  • Referência

Definição

Namespace:
System.Speech.Recognition
Assembly:
System.Speech.dll

Atualiza o valor de uma configuração do reconhecedor.

Sobrecargas

UpdateRecognizerSetting(String, Int32)

Atualiza a configuração especificada para o SpeechRecognitionEngine com o valor inteiro especificado.
UpdateRecognizerSetting(String, String)

Atualiza a configuração de mecanismo de reconhecimento de fala especificado com o valor de cadeia de caracteres especificada.

Comentários

As configurações do reconhecedor podem conter cadeia de caracteres, número inteiro de 64 bits ou dados de endereço de memória. A tabela a seguir descreve as configurações definidas para um reconhecedor compatível com o Microsoft Speech API (SAPI). As configurações a seguir devem ter o mesmo intervalo para cada reconhecedor que dá suporte à configuração. Um reconhecedor compatível com SAPI não é necessário para dar suporte a essas configurações e pode dar suporte a outras configurações.

Nome Descrição
ResourceUsage Especifica o consumo de CPU do reconhecedor. O intervalo é de 0 a 100. O valor padrão é 50.
ResponseSpeed Indica o comprimento de silêncio no final da entrada não ambígua antes que o reconhecedor de fala conclua uma operação de reconhecimento. O intervalo é de 0 a 10.000 milissegundos (MS). Essa configuração corresponde à propriedade do reconhecedor EndSilenceTimeout . Padrão = 150ms.
ComplexResponseSpeed Indica o comprimento de silêncio em milissegundos (MS) no final da entrada ambígua antes que o reconhecedor de fala conclua uma operação de reconhecimento. O intervalo é de 0 a 10, MS. Essa configuração corresponde à propriedade do reconhecedor EndSilenceTimeoutAmbiguous . Padrão = 500 ms.
AdaptationOn Indica se a adaptação do modelo acústico está ATIVAda (valor = 1 ) ou desativado (valor = 0 ). O valor padrão é 1 (on).
PersistedBackgroundAdaptation Indica se a adaptação do plano de fundo está ativada (valor = 1 ) ou desativado (valor = 0 ) e persiste a configuração no registro. O valor padrão é 1 (on).

Para retornar uma das configurações do reconhecedor, use o QueryRecognizerSetting método.

Com exceção de PersistedBackgroundAdaptation , os valores de propriedade definidos usando os UpdateRecognizerSetting métodos permanecem em vigor somente para a instância atual do SpeechRecognitionEngine , após o qual eles são revertidos para suas configurações padrão.

Você pode modificar como o reconhecimento de fala responde a uma entrada que não seja de fala usando as BabbleTimeout InitialSilenceTimeout Propriedades,, EndSilenceTimeout e EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Atualiza a configuração especificada para o SpeechRecognitionEngine com o valor inteiro 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

O nome da configuração a ser atualizada.

updatedValue
Int32

O novo valor da configuração.

Exceções

ArgumentNullException

settingName é null.

ArgumentException

settingName é a cadeia de caracteres vazia ("").

KeyNotFoundException

O reconhecedor não tem uma configuração com esse nome.

Exemplos

O exemplo a seguir faz parte de um aplicativo de console que gera os valores para um número de configurações definidas para o reconhecedor que dá suporte à localidade en-US. O exemplo atualiza as configurações de nível de confiança e, em seguida, consulta o reconhecedor para verificar os valores atualizados. O exemplo gera a saída a seguir.

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

Comentários

Com exceção de PersistedBackgroundAdaptation , os valores de propriedade definidos usando o UpdateRecognizerSetting método permanecem em vigor somente para a instância atual do SpeechRecognitionEngine , após o qual eles são revertidos para suas configurações padrão. Consulte UpdateRecognizerSetting para obter descrições das configurações com suporte.

Confira também

Aplica-se a

UpdateRecognizerSetting(String, String)

Atualiza a configuração de mecanismo de reconhecimento de fala especificado com o valor de cadeia de caracteres especificada.

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

O nome da configuração a ser atualizada.

updatedValue
String

O novo valor da configuração.

Exceções

ArgumentNullException

settingName é null.

ArgumentException

settingName é a cadeia de caracteres vazia ("").

KeyNotFoundException

O reconhecedor não tem uma configuração com esse nome.

Comentários

Com exceção de PersistedBackgroundAdaptation , os valores de propriedade definidos usando o UpdateRecognizerSetting método permanecem em vigor somente para a instância atual do SpeechRecognitionEngine , após o qual eles são revertidos para suas configurações padrão. Consulte UpdateRecognizerSetting para obter descrições das configurações com suporte.

Confira também

Aplica-se a