SpeechRecognitionEngine.QueryRecognizerSetting(String) Metoda

Definicja

Namespace:

System.Speech.Recognition

Montaż:

System.Speech.dll

Pakiet:

System.Speech v10.0.1

Źródło:

SpeechRecognitionEngine.cs

Zwraca wartości ustawień dla rozpoznawania.

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

Parametry

settingName

String

Nazwa ustawienia do zwrócenia.

Zwraca

Object

Wartość ustawienia.

Wyjątki

ArgumentNullException

settingName to null.

ArgumentException

settingName jest pustym ciągiem ("").

KeyNotFoundException

Rozpoznawanie nie ma ustawienia o tej nazwie.

Przykłady

Poniższy przykład jest częścią aplikacji konsolowej, która generuje wartości dla wielu ustawień zdefiniowanych dla aparatu rozpoznawania, który obsługuje ustawienia regionalne en-US. W przykładzie są generowane następujące dane wyjściowe.

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

Uwagi

Ustawienia rozpoznawania mogą zawierać dane dotyczące ciągów, 64-bitowych liczb całkowitych lub adresów pamięci. W poniższej tabeli opisano ustawienia zdefiniowane dla rozpoznawania zgodnego z interfejsem API rozpoznawania mowy (SAPI) Microsoft. Następujące ustawienia muszą mieć ten sam zakres dla każdego rozpoznawania, który obsługuje to ustawienie. Rozpoznawanie zgodne z oprogramowaniem SAPI nie jest wymagane do obsługi tych ustawień i może obsługiwać inne ustawienia.

Nazwa	Opis
ResourceUsage	Określa użycie procesora przez aparat rozpoznawania. Zakres wynosi od 0 do 100. Wartość domyślna to 50.
ResponseSpeed	Wskazuje długość ciszy na końcu jednoznacznych danych wejściowych przed ukończeniem operacji rozpoznawania mowy. Zakres wynosi od 0 do 10 000 milisekund (ms). To ustawienie odpowiada właściwości rozpoznawania EndSilenceTimeout . Wartość domyślna : 150 ms.
ComplexResponseSpeed	Wskazuje długość ciszy na końcu niejednoznacznych danych wejściowych przed ukończeniem operacji rozpoznawania mowy. Zakres wynosi od 0 do 10 000 ms. To ustawienie odpowiada właściwości rozpoznawania EndSilenceTimeoutAmbiguous . Wartość domyślna : 500 ms.
AdaptationOn	Wskazuje, czy dostosowanie modelu akustycznego jest WŁĄCZONE (wartość = 1) lub OFF (wartość = 0). Wartość domyślna to 1 (ON).
PersistedBackgroundAdaptation	Wskazuje, czy dostosowanie tła jest WŁĄCZONE (wartość = 1) lub OFF (wartość = 0), i utrwala ustawienie w rejestrze. Wartość domyślna to 1 (ON).

Aby zaktualizować ustawienie dla rozpoznawania, użyj jednej z UpdateRecognizerSetting metod.

Zobacz także

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous