Compartilhar via


SpeechRecognitionEngine.UpdateRecognizerSetting Método

Definição

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

Sobrecargas

Nome Description
UpdateRecognizerSetting(String, Int32)

Atualiza a configuração especificada para o SpeechRecognitionEngine valor inteiro especificado.

UpdateRecognizerSetting(String, String)

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

Comentários

As configurações do reconhecedor podem conter cadeia de caracteres, 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 SAPI (API de Fala da Microsoft). 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 do silêncio no final da entrada inequívoca 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 EndSilenceTimeout reconhecedor. Padrão = 150 ms.
ComplexResponseSpeed Indica o comprimento do 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.000ms. Essa configuração corresponde à propriedade do EndSilenceTimeoutAmbiguous reconhecedor. Padrão = 500ms.
AdaptationOn Indica se a adaptação do modelo acústico é ON (valor = 1) ou OFF (valor = 0). O valor padrão é 1 (ON).
PersistedBackgroundAdaptation Indica se a adaptação em segundo plano é ON (valor = 1) ou OFF (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 , os valores de PersistedBackgroundAdaptationpropriedade definidos usando os UpdateRecognizerSetting métodos permanecem em vigor apenas para a instância atual de SpeechRecognitionEngine, após a qual eles revertem para suas configurações padrão.

Você pode modificar como o reconhecimento de fala responde a entradas que não são de fala usando as propriedades e InitialSilenceTimeoutEndSilenceTimeoutEndSilenceTimeoutAmbiguous as BabbleTimeoutpropriedades.

UpdateRecognizerSetting(String, Int32)

Origem:
SpeechRecognitionEngine.cs
Origem:
SpeechRecognitionEngine.cs
Origem:
SpeechRecognitionEngine.cs
Origem:
SpeechRecognitionEngine.cs

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

settingName é null.

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

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 de uma série 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 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 , os valores de PersistedBackgroundAdaptationpropriedade definidos usando o UpdateRecognizerSetting método permanecem em vigor apenas para a instância atual de SpeechRecognitionEngine, após a qual eles revertem para suas configurações padrão. Confira UpdateRecognizerSetting as descrições das configurações com suporte.

Confira também

Aplica-se a

UpdateRecognizerSetting(String, String)

Origem:
SpeechRecognitionEngine.cs
Origem:
SpeechRecognitionEngine.cs
Origem:
SpeechRecognitionEngine.cs
Origem:
SpeechRecognitionEngine.cs

Atualiza a configuração do mecanismo de reconhecimento de fala especificada com o valor de cadeia de caracteres 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

O nome da configuração a ser atualizada.

updatedValue
String

O novo valor da configuração.

Exceções

settingName é null.

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

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

Comentários

Com exceção de , os valores de PersistedBackgroundAdaptationpropriedade definidos usando o UpdateRecognizerSetting método permanecem em vigor apenas para a instância atual de SpeechRecognitionEngine, após a qual eles revertem para suas configurações padrão. Confira UpdateRecognizerSetting as descrições das configurações com suporte.

Confira também

Aplica-se a