SpeechRecognitionEngine.QueryRecognizerSetting(String) Methode

Definitie

Naamruimte:
System.Speech.Recognition
Assembly:
System.Speech.dll

Retourneert de waarden van instellingen voor de recognizer.

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

Parameters

settingName
String

De naam van de instelling die moet worden geretourneerd.

Retouren

Object

De waarde van de instelling.

Uitzonderingen

ArgumentNullException

settingName is null.

ArgumentException

settingName is de lege tekenreeks ("").

KeyNotFoundException

De recognizer heeft geen instelling met die naam.

Voorbeelden

Het volgende voorbeeld maakt deel uit van een consoletoepassing die de waarden uitvoert voor een aantal instellingen die zijn gedefinieerd voor de recognizer die ondersteuning biedt voor de en-US landinstelling. In het voorbeeld wordt de volgende uitvoer gegenereerd.

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

Opmerkingen

Recognizer-instellingen kunnen tekenreeks-, 64-bits geheel getal- of geheugenadresgegevens bevatten. In de volgende tabel worden de instellingen beschreven die zijn gedefinieerd voor een Microsoft SAPI-compatibele recognizer (Speech API). De volgende instellingen moeten hetzelfde bereik hebben voor elke recognizer die ondersteuning biedt voor de instelling. Een SAPI-compatibele recognizer is niet vereist om deze instellingen te ondersteunen en kan andere instellingen ondersteunen.

Name Description
ResourceUsage Hiermee geeft u het CPU-verbruik van de recognizer. Het bereik is van 0 tot 100. De standaardwaarde is 50.
ResponseSpeed Geeft de lengte van stilte aan het einde van ondubbelzinnige invoer aan voordat de spraakherkenning een herkenningsbewerking voltooit. Het bereik is van 0 tot 10.000 milliseconden (ms). Deze instelling komt overeen met de eigenschap van EndSilenceTimeout de recognizer. Standaard = 150 ms.
ComplexResponseSpeed Geeft de lengte van stilte aan het einde van dubbelzinnige invoer aan voordat de spraakherkenning een herkenningsbewerking voltooit. Het bereik is van 0 tot 10.000 ms. Deze instelling komt overeen met de eigenschap van EndSilenceTimeoutAmbiguous de recognizer. Standaard = 500 ms.
AdaptationOn Geeft aan of aanpassing van het akoestische model AAN (waarde = 1) of OFF (waarde = ) is 0. De standaardwaarde is 1 (AAN).
PersistedBackgroundAdaptation Geeft aan of achtergrondaanpassing is ingeschakeld (waarde = 1) of UIT (waarde = 0) en de instelling in het register persistent maakt. De standaardwaarde is 1 (AAN).

Als u een instelling voor de recognizer wilt bijwerken, gebruikt u een van de UpdateRecognizerSetting methoden.

Van toepassing op

Zie ook