SpeechRecognitionEngine.UpdateRecognizerSetting Metoda

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Balíček:

System.Speech v9.0.0-preview.3.24172.9

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

Přetížení

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

Poznámky

Nastavení rozpoznávání může obsahovat řetězcová, 64bitová celočíselná data nebo data adresy paměti. Následující tabulka popisuje nastavení, která jsou definovaná pro rozpoznávání kompatibilní s rozhraním MICROSOFT Speech API (SAPI). Následující nastavení musí mít stejný rozsah pro každý rozpoznávatel, který toto nastavení podporuje. Pro podporu těchto nastavení se nevyžaduje rozpoznávání kompatibilní se systémem SAPI a může podporovat další nastavení.

Název	Description
ResourceUsage	Určuje spotřebu procesoru rozpoznávatele. Rozsah je od 0 do 100. Výchozí hodnota je 50.
ResponseSpeed	Označuje délku ticha na konci jednoznač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 milisekund (ms). Toto nastavení odpovídá vlastnosti rozpoznávání EndSilenceTimeout . Výchozí hodnota = 150ms.
ComplexResponseSpeed	Označ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 000ms. Toto nastavení odpovídá vlastnosti rozpoznávání EndSilenceTimeoutAmbiguous . Výchozí hodnota = 500ms.
AdaptationOn	Označuje, jestli je přizpůsobení akustického modelu ZAPNUTO (hodnota = 1) nebo OFF (hodnota = 0). Výchozí hodnota je 1 (ZAPNUTO).
PersistedBackgroundAdaptation	Určuje, jestli je přizpůsobení pozadí ZAPNUTO (hodnota = 1) nebo VYPNUTO (hodnota = 0), a zachová nastavení v registru. Výchozí hodnota je 1 (ZAPNUTO).

Pokud chcete vrátit nastavení některého z rozpoznávatelů, použijte metodu QueryRecognizerSetting .

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

Pomocí vlastností , InitialSilenceTimeout, EndSilenceTimeouta EndSilenceTimeoutAmbiguous můžete upravit, jak rozpoznávání řeči reaguje na vstupBabbleTimeout, který není řečový vstup.

UpdateRecognizerSetting(String, Int32)

Zdroj:

SpeechRecognitionEngine.cs

Aktualizace zadané nastavení pro SpeechRecognitionEngine hodnotu se zadanou celočíselnou hodnotou.

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ávatel nemá nastavení podle daného 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 národní prostředí en-US. V příkladu se aktualizuje nastavení úrovně spolehlivosti a pak se dotazuje rozpoznávatele, 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 , SpeechRecognitionEnginepo které se vrátí do výchozího nastavení. Projděte si UpdateRecognizerSetting popis podporovaných nastavení.

Viz také

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Zdroj:

SpeechRecognitionEngine.cs

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

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ávatel nemá nastavení podle daného názvu.

Poznámky

S výjimkou PersistedBackgroundAdaptation, hodnoty vlastností nastavené pomocí UpdateRecognizerSetting metody zůstávají v platnosti pouze pro aktuální instanci , SpeechRecognitionEnginepo které se vrátí do výchozího nastavení. Projděte si UpdateRecognizerSetting popis podporovaných nastavení.

Viz také

• QueryRecognizerSetting(String)