SpeechRecognitionEngine.UpdateRecognizerSetting Metoda

Definicja

Przestrzeń nazw:

System.Speech.Recognition

Zestaw:

System.Speech.dll

Pakiet:

System.Speech v9.0.0-preview.3.24172.9

Aktualizacje wartość ustawienia dla rozpoznawania.

Przeciążenia

UpdateRecognizerSetting(String, Int32)	Aktualizacje określone ustawienie dla SpeechRecognitionEngine elementu z określoną wartością całkowitą.
UpdateRecognizerSetting(String, String)	Aktualizacje określone ustawienie aparatu rozpoznawania mowy z określoną wartością ciągu.

Uwagi

Ustawienia rozpoznawania mogą zawierać dane dotyczące ciągów, 64-bitowych liczb całkowitych lub adresów pamięci. W poniższej tabeli opisano ustawienia zdefiniowane dla rozpoznawania zgodnego z interfejsem API rozpoznawania mowy (SAPI) Microsoft. Następujące ustawienia muszą mieć ten sam zakres dla każdego rozpoznawania, który obsługuje to ustawienie. Rozpoznawanie zgodne z oprogramowaniem SAPI nie jest wymagane do obsługi tych ustawień i może obsługiwać inne ustawienia.

Nazwa	Opis
ResourceUsage	Określa użycie procesora przez aparat rozpoznawania. Zakres wynosi od 0 do 100. Wartość domyślna to 50.
ResponseSpeed	Wskazuje długość ciszy na końcu jednoznacznych danych wejściowych przed ukończeniem operacji rozpoznawania mowy. Zakres wynosi od 0 do 10 000 milisekund (ms). To ustawienie odpowiada właściwości rozpoznawania EndSilenceTimeout . Wartość domyślna : 150 ms.
ComplexResponseSpeed	Wskazuje długość ciszy w milisekundach (ms) na końcu niejednoznacznych danych wejściowych przed ukończeniem operacji rozpoznawania mowy. Zakres wynosi od 0 do 10 000 ms. To ustawienie odpowiada właściwości rozpoznawania EndSilenceTimeoutAmbiguous . Wartość domyślna : 500 ms.
AdaptationOn	Wskazuje, czy dostosowanie modelu akustycznego jest WŁĄCZONE (wartość = 1) lub OFF (wartość = 0). Wartość domyślna to 1 (ON).
PersistedBackgroundAdaptation	Wskazuje, czy dostosowanie tła jest WŁĄCZONE (wartość = 1) lub OFF (wartość = 0), i utrwala ustawienie w rejestrze. Wartość domyślna to 1 (ON).

Aby zwrócić jedno z ustawień rozpoznawania, użyj QueryRecognizerSetting metody .

Z wyjątkiem PersistedBackgroundAdaptation, wartości właściwości ustawione przy użyciu UpdateRecognizerSetting metod pozostają w mocy tylko dla bieżącego wystąpienia klasy SpeechRecognitionEngine, po którym przywracają ustawienia domyślne.

Możesz zmodyfikować sposób reagowania rozpoznawania mowy na dane wejściowe inne niż mowa przy użyciu BabbleTimeoutwłaściwości , InitialSilenceTimeout, EndSilenceTimeouti EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Źródło:

SpeechRecognitionEngine.cs

Aktualizacje określone ustawienie dla SpeechRecognitionEngine elementu z określoną wartością całkowitą.

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

Nazwa ustawienia do zaktualizowania.

updatedValue

Int32

Nowa wartość ustawienia.

Wyjątki

ArgumentNullException

settingName to null.

ArgumentException

settingName jest pustym ciągiem ("").

KeyNotFoundException

Rozpoznawanie nie ma ustawienia o tej nazwie.

Przykłady

Poniższy przykład jest częścią aplikacji konsolowej, która generuje wartości dla wielu ustawień zdefiniowanych dla aparatu rozpoznawania, który obsługuje ustawienia regionalne en-US. Przykład aktualizuje ustawienia poziomu ufności, a następnie wysyła zapytanie do aparatu rozpoznawania w celu sprawdzenia zaktualizowanych wartości. W przykładzie są generowane następujące dane wyjściowe.

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

Uwagi

Z wyjątkiem PersistedBackgroundAdaptation, wartości właściwości ustawione przy użyciu UpdateRecognizerSetting metody pozostają w mocy tylko dla bieżącego wystąpienia klasy SpeechRecognitionEngine, po którym przywracają ustawienia domyślne. Zobacz UpdateRecognizerSetting opisy obsługiwanych ustawień.

Zobacz też

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Źródło:

SpeechRecognitionEngine.cs

Aktualizacje określone ustawienie aparatu rozpoznawania mowy z określoną wartością ciągu.

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

Nazwa ustawienia do zaktualizowania.

updatedValue

String

Nowa wartość ustawienia.

Wyjątki

ArgumentNullException

settingName to null.

ArgumentException

settingName jest pustym ciągiem ("").

KeyNotFoundException

Rozpoznawanie nie ma ustawienia o tej nazwie.

Uwagi

Z wyjątkiem PersistedBackgroundAdaptation, wartości właściwości ustawione przy użyciu UpdateRecognizerSetting metody pozostają w mocy tylko dla bieżącego wystąpienia klasy SpeechRecognitionEngine, po którym przywracają ustawienia domyślne. Zobacz UpdateRecognizerSetting opisy obsługiwanych ustawień.

Zobacz też

• QueryRecognizerSetting(String)