SpeechRecognitionEngine.QueryRecognizerSetting(String) Metoda

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Balíček:

System.Speech v11.0.0-preview.2.26159.112

Zdroj:

SpeechRecognitionEngine.cs

Vrátí hodnoty nastavení pro rozpoznávání.

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

Název nastavení, které se má vrátit.

Návraty

Object

Hodnota nastavení.

Výjimky

ArgumentNullException

settingName je null.

ArgumentException

settingName je prázdný řetězec ("").

KeyNotFoundException

Rozpoznávání nemá nastavení podle názvu.

Příklady

Následující příklad je součástí konzolové aplikace, která vypíše hodnoty pro řadu nastavení definovaných pro rozpoznávání, které podporuje en-US národní prostředí. Příklad vygeneruje následující výstup.

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

Poznámky

Nastavení rozpoznávání může obsahovat řetězec, 64bitové celé číslo nebo data adresy paměti. Následující tabulka popisuje nastavení definovaná pro rozpoznávání kompatibilní s rozhraním SAPI (Microsoft Speech API). Pro každý rozpoznávatel, který podporuje toto nastavení, musí mít následující nastavení stejný rozsah. Pro podporu těchto nastavení není vyžadováno rozpoznávání kompatibilní se SAPI a může podporovat další nastavení.

název	Description
ResourceUsage	Určuje spotřebu procesoru nástroje pro rozpoznávání. Rozsah je od 0 do 100. Výchozí hodnota je 50.
ResponseSpeed	Určuje délku ticha na konci jednoznačného vstupu, než rozpoznávání řeči dokončí operaci rozpoznávání. Rozsah je od 0 do 10 000 milisekund (ms). Toto nastavení odpovídá vlastnosti rozpoznávání EndSilenceTimeout . Výchozí hodnota = 150 ms.
ComplexResponseSpeed	Určuje délku ticha na konci nejednoznačného vstupu před tím, než rozpoznávání řeči dokončí operaci rozpoznávání. Rozsah je od 0 do 10 000 m. Toto nastavení odpovídá vlastnosti rozpoznávání EndSilenceTimeoutAmbiguous . Výchozí hodnota = 500 ms.
AdaptationOn	Určuje, zda je přizpůsobení akustického modelu ZAPNUTO (hodnota = 1) nebo OFF (hodnota = 0). Výchozí hodnota je 1 (ZAPNUTO).
PersistedBackgroundAdaptation	Určuje, zda je přizpůsobení pozadí ZAPNUTO (hodnota = 1) nebo OFF (hodnota = 0) a zachová nastavení v registru. Výchozí hodnota je 1 (ZAPNUTO).

Pokud chcete aktualizovat nastavení pro rozpoznávání, použijte jednu z UpdateRecognizerSetting metod.

Viz také

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous