SpeechRecognitionEngine.UpdateRecognizerSetting Metoda

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Balíček:

System.Speech v11.0.0-preview.2.26159.112

Aktualizuje hodnotu nastavení pro rozpoznávání.

Přetížení

Name	Description
UpdateRecognizerSetting(String, Int32)	Aktualizuje zadané nastavení pro SpeechRecognitionEngine zadanou celočíselnou hodnotu.
UpdateRecognizerSetting(String, String)	Aktualizuje zadané nastavení modulu rozpoznávání řeči se zadanou hodnotou řetězce.

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 v milisekundách (ms) 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 vrátit jedno z nastavení rozpoznávání, použijte metodu QueryRecognizerSetting .

S výjimkou PersistedBackgroundAdaptation, hodnoty vlastností nastavené pomocí UpdateRecognizerSetting metod zůstávají v platnosti pouze pro aktuální instanci SpeechRecognitionEngine, po které se vrátí k jejich výchozí nastavení.

Způsob, jakým rozpoznávání řeči reaguje na vstup bez řeči, můžete upravit pomocí parametru BabbleTimeout, InitialSilenceTimeoutEndSilenceTimeout, a EndSilenceTimeoutAmbiguous vlastností.

UpdateRecognizerSetting(String, Int32)

Zdroj:

SpeechRecognitionEngine.cs

Aktualizuje zadané nastavení pro SpeechRecognitionEngine zadanou celočíselnou hodnotu.

public:
 void UpdateRecognizerSetting(System::String ^ settingName, int updatedValue);

public void UpdateRecognizerSetting(string settingName, int updatedValue);

member this.UpdateRecognizerSetting : string * int -> unit

Public Sub UpdateRecognizerSetting (settingName As String, updatedValue As Integer)

Parametry

settingName

String

Název nastavení, které se má aktualizovat.

updatedValue

Int32

Nová hodnota pro 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 aktualizuje nastavení úrovně spolehlivosti a potom se dotazuje rozpoznávání, aby zkontroloval aktualizované hodnoty. 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

Updated settings:

  ResourceUsage                  is not supported by this recognizer.
  ResponseSpeed                  = 200
  ComplexResponseSpeed           = 300
  AdaptationOn                   = 0
  PersistedBackgroundAdaptation  = 0

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

        // List the current settings.
        ListSettings(recognizer);

        // Change some of the settings.
        recognizer.UpdateRecognizerSetting("ResponseSpeed", 200);
        recognizer.UpdateRecognizerSetting("ComplexResponseSpeed", 300);
        recognizer.UpdateRecognizerSetting("AdaptationOn", 1);
        recognizer.UpdateRecognizerSetting("PersistedBackgroundAdaptation", 0);

        Console.WriteLine("Updated settings:");
        Console.WriteLine();

        // List the updated settings.
        ListSettings(recognizer);
      }

      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }

    private static void ListSettings(SpeechRecognitionEngine recognizer)
    {
      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();
    }
  }
}

Poznámky

S výjimkou PersistedBackgroundAdaptation, hodnoty vlastností nastavené pomocí UpdateRecognizerSetting metody zůstávají v platnosti pouze pro aktuální instanci SpeechRecognitionEngine, po které se vrátí k jejich výchozí nastavení. Podívejte se UpdateRecognizerSetting na popis podporovaných nastavení.

Viz také

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Zdroj:

SpeechRecognitionEngine.cs

Aktualizuje zadané nastavení modulu rozpoznávání řeči se zadanou hodnotou řetězce.

public:
 void UpdateRecognizerSetting(System::String ^ settingName, System::String ^ updatedValue);

public void UpdateRecognizerSetting(string settingName, string updatedValue);

member this.UpdateRecognizerSetting : string * string -> unit

Public Sub UpdateRecognizerSetting (settingName As String, updatedValue As String)

Parametry

settingName

String

Název nastavení, které se má aktualizovat.

updatedValue

String

Nová hodnota pro nastavení.

Výjimky

ArgumentNullException

settingName je null.

ArgumentException

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

KeyNotFoundException

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

Poznámky

S výjimkou PersistedBackgroundAdaptation, hodnoty vlastností nastavené pomocí UpdateRecognizerSetting metody zůstávají v platnosti pouze pro aktuální instanci SpeechRecognitionEngine, po které se vrátí k jejich výchozí nastavení. Podívejte se UpdateRecognizerSetting na popis podporovaných nastavení.

Viz také

• QueryRecognizerSetting(String)