SpeechRecognitionEngine.QueryRecognizerSetting(String) Método

Definição

Espaço de Nomes:
System.Speech.Recognition
Assemblagem:
System.Speech.dll

Devolve os valores das definições do reconhecedor.

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

O nome do cenário a voltar.

Devoluções

Object

O valor da configuração.

Exceções

ArgumentNullException

settingName é null.

ArgumentException

settingName é a corda vazia ("").

KeyNotFoundException

O recognizer não tem uma definição com esse nome.

Exemplos

O exemplo seguinte faz parte de uma aplicação de consola que gera os valores de várias definições definidas para o reconhecor que suporta a localização en-US. O exemplo gera a seguinte saída.

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

Observações

As definições do recognizer podem conter dados de string, inteiros de 64 bits ou endereços de memória. A tabela seguinte descreve as definições definidas para um reconhecedor compatível com a API de Voz da Microsoft (SAPI). As seguintes definições devem ter o mesmo intervalo para cada reconhecedor que suporta a definição. Um reconhecedor compatível com SAPI não é obrigado a suportar estas definições e pode suportar outras.

Name Description
ResourceUsage Especifica o consumo de CPU do reconhecedor. O intervalo varia de 0 a 100. O valor predefinido é 50.
ResponseSpeed Indica a duração do silêncio no final da entrada inequívoca antes de o reconhecedor de fala concluir uma operação de reconhecimento. O intervalo varia entre 0 e 10.000 milissegundos (ms). Esta configuração corresponde à propriedade do EndSilenceTimeout reconhecedor. Padrão = 150ms.
ComplexResponseSpeed Indica a duração do silêncio no final da entrada ambígua antes de o reconhecedor de fala concluir uma operação de reconhecimento. O alcance varia entre 0 e 10.000 ms. Esta configuração corresponde à propriedade do EndSilenceTimeoutAmbiguous reconhecedor. Padrão = 500ms.
AdaptationOn Indica se a adaptação do modelo acústico é LIGADA (valor = 1) ou DESLIGADA (valor = 0). O valor padrão é 1 (ON).
PersistedBackgroundAdaptation Indica se a adaptação de fundo está LIGADA (valor = 1) ou DESLIGADA (valor = 0), e mantém a configuração no registo. O valor padrão é 1 (ON).

Para atualizar uma definição para o reconhecedor, use um dos UpdateRecognizerSetting métodos.

Aplica-se a

Ver também