SpeechRecognitionEngine.QueryRecognizerSetting(String) Metod

Definition

Returnerar värdena för inställningarna för identifieraren.

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

Parametrar

settingName
String

Namnet på inställningen som ska returneras.

Returer

Värdet för inställningen.

Undantag

settingName är null.

settingName är den tomma strängen ("").

Identifieraren har ingen inställning med det namnet.

Exempel

Följande exempel är en del av ett konsolprogram som matar ut värdena för ett antal av de inställningar som definierats för den identifierare som stöder en-US nationella inställningar. Exemplet genererar följande utdata.

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

Kommentarer

Inställningar för identifierare kan innehålla sträng-, 64-bitars heltals- eller minnesadressdata. I följande tabell beskrivs de inställningar som har definierats för en sapi-kompatibel identifierare (Microsoft Speech API). Följande inställningar måste ha samma intervall för varje identifierare som stöder inställningen. En SAPI-kompatibel identifierare krävs inte för att stödja dessa inställningar och kan stödja andra inställningar.

Name Description
ResourceUsage Anger identifierarens CPU-förbrukning. Intervallet är mellan 0 och 100. Standardvärdet är 50.
ResponseSpeed Anger längden på tystnaden i slutet av tvetydiga indata innan taligenkänningen slutför en igenkänningsåtgärd. Intervallet är mellan 0 och 10 000 millisekunder (ms). Den här inställningen motsvarar identifierarens EndSilenceTimeout egenskap. Standard = 150 ms.
ComplexResponseSpeed Anger längden på tystnaden i slutet av tvetydiga indata innan taligenkänningen slutför en igenkänningsåtgärd. Intervallet är mellan 0 och 10 000 ms. Den här inställningen motsvarar identifierarens EndSilenceTimeoutAmbiguous egenskap. Standard = 500 ms.
AdaptationOn Anger om anpassningen av den akustiska modellen är PÅ (värde = 1) eller OFF (värde = 0). Standardvärdet är 1 (ON).
PersistedBackgroundAdaptation Anger om bakgrundsanpassningen är PÅ (värde = 1) eller OFF (värde = 0) och bevarar inställningen i registret. Standardvärdet är 1 (ON).

Om du vill uppdatera en inställning för identifieraren använder du någon av UpdateRecognizerSetting metoderna.

Gäller för

Se även