SpeechRecognitionEngine.UpdateRecognizerSetting Metodo

Definizione

Spazio dei nomi:

System.Speech.Recognition

Assembly:

System.Speech.dll

Pacchetto:

System.Speech v11.0.0-preview.2.26159.112

Aggiorna il valore di un'impostazione per lo strumento di riconoscimento.

Overload

Nome	Descrizione
UpdateRecognizerSetting(String, Int32)	Aggiorna l'impostazione specificata per con SpeechRecognitionEngine il valore intero specificato.
UpdateRecognizerSetting(String, String)	Aggiorna l'impostazione del motore di riconoscimento vocale specificato con il valore stringa specificato.

Commenti

Le impostazioni di Riconoscimento possono contenere dati stringa, integer a 64 bit o indirizzo di memoria. Nella tabella seguente vengono descritte le impostazioni definite per un sistema di riconoscimento conforme a SAPI (Microsoft Speech API). Le impostazioni seguenti devono avere lo stesso intervallo per ogni riconoscitore che supporta l'impostazione. Un riconoscitore conforme a SAPI non è necessario per supportare queste impostazioni e può supportare altre impostazioni.

Nome	Descrizione
ResourceUsage	Specifica il consumo della CPU del riconoscitore. L'intervallo è compreso tra 0 e 100. Il valore predefinito è 50.
ResponseSpeed	Indica la lunghezza del silenzio alla fine dell'input non ambiguo prima che il riconoscimento vocale completi un'operazione di riconoscimento. L'intervallo è compreso tra 0 e 10.000 millisecondi (ms). Questa impostazione corrisponde alla proprietà del EndSilenceTimeout riconoscitore. Valore predefinito = 150 ms.
ComplexResponseSpeed	Indica la lunghezza del silenzio in millisecondi (ms) alla fine dell'input ambiguo prima che il riconoscimento vocale completi un'operazione di riconoscimento. L'intervallo è compreso tra 0 e 10.000 ms. Questa impostazione corrisponde alla proprietà del EndSilenceTimeoutAmbiguous riconoscitore. Valore predefinito = 500 ms.
AdaptationOn	Indica se l'adattamento del modello acustico è ON (value = 1) o OFF (value = 0). Il valore predefinito è 1 (ON).
PersistedBackgroundAdaptation	Indica se l'adattamento in background è ON (valore = 1) o OFF (valore = 0) e mantiene l'impostazione nel Registro di sistema. Il valore predefinito è 1 (ON).

Per restituire una delle impostazioni del riconoscitore, usare il QueryRecognizerSetting metodo .

Ad eccezione di , i valori delle PersistedBackgroundAdaptationproprietà impostati usando i UpdateRecognizerSetting metodi rimangono attivi solo per l'istanza corrente di SpeechRecognitionEngine, dopo il quale ripristinano le impostazioni predefinite.

È possibile modificare il modo in cui il riconoscimento vocale risponde all'input non vocale usando le BabbleTimeoutproprietà , InitialSilenceTimeoutEndSilenceTimeout, e EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Origine:

SpeechRecognitionEngine.cs

Aggiorna l'impostazione specificata per con SpeechRecognitionEngine il valore intero specificato.

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)

Parametri

settingName

String

Nome dell'impostazione da aggiornare.

updatedValue

Int32

Nuovo valore per l'impostazione.

Eccezioni

ArgumentNullException

settingName è null.

ArgumentException

settingName è la stringa vuota ("").

KeyNotFoundException

Il riconoscitore non dispone di un'impostazione in base a tale nome.

Esempio

L'esempio seguente fa parte di un'applicazione console che restituisce i valori per una serie di impostazioni definite per il riconoscitore che supporta le impostazioni locali en-US. L'esempio aggiorna le impostazioni del livello di confidenza e quindi esegue una query sul riconoscitore per controllare i valori aggiornati. L'esempio genera l'output seguente.

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

Commenti

Ad eccezione di , i valori delle PersistedBackgroundAdaptationproprietà impostati usando il UpdateRecognizerSetting metodo rimangono attivi solo per l'istanza corrente di SpeechRecognitionEngine, dopo il quale ripristinano le impostazioni predefinite. Vedere UpdateRecognizerSetting per le descrizioni delle impostazioni supportate.

Vedi anche

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Origine:

SpeechRecognitionEngine.cs

Aggiorna l'impostazione del motore di riconoscimento vocale specificato con il valore stringa specificato.

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)

Parametri

settingName

String

Nome dell'impostazione da aggiornare.

updatedValue

String

Nuovo valore per l'impostazione.

Eccezioni

ArgumentNullException

settingName è null.

ArgumentException

settingName è la stringa vuota ("").

KeyNotFoundException

Il riconoscitore non dispone di un'impostazione in base a tale nome.

Commenti

Ad eccezione di , i valori delle PersistedBackgroundAdaptationproprietà impostati usando il UpdateRecognizerSetting metodo rimangono attivi solo per l'istanza corrente di SpeechRecognitionEngine, dopo il quale ripristinano le impostazioni predefinite. Vedere UpdateRecognizerSetting per le descrizioni delle impostazioni supportate.

Vedi anche

• QueryRecognizerSetting(String)