SpeechRecognitionEngine.UpdateRecognizerSetting Metodo

Definizione

Spazio dei nomi:

System.Speech.Recognition

Assembly:

System.Speech.dll

Pacchetto:

System.Speech v9.0.0-preview.3.24172.9

Aggiorna il valore di un'impostazione per il riconoscimento.

Overload

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

Commenti

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

Nome	Descrizione
ResourceUsage	Specifica il consumo della CPU del riconoscimento. 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 vocale. L'intervallo è compreso tra 0 e 10.000 millisecondi (ms). Questa impostazione corrisponde alla proprietà del EndSilenceTimeout riconoscimento. Default = 150ms.
ComplexResponseSpeed	Indica la lunghezza del silenzio in millisecondi (ms) alla fine dell'input ambiguo prima che il riconoscimento vocale completa un'operazione di riconoscimento. L'intervallo è compreso tra 0 e 10.000ms. Questa impostazione corrisponde alla proprietà del EndSilenceTimeoutAmbiguous riconoscimento. Default = 500ms.
AdaptationOn	Indica se l'adattamento del modello acustico è ON (value = ) o OFF (value = 10). Il valore predefinito è 1 (ON).
PersistedBackgroundAdaptation	Indica se l'adattamento in background è ON (value = ) o OFF (value = 10), e mantiene l'impostazione nel Registro di sistema. Il valore predefinito è 1 (ON).

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

Ad eccezione di , i valori delle PersistedBackgroundAdaptationproprietà impostati usando i UpdateRecognizerSetting metodi rimangono effettivi 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à , InitialSilenceTimeout, EndSilenceTimeoute EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Origine:

SpeechRecognitionEngine.cs

Aggiorna l'impostazione specificata per SpeechRecognitionEngine con il valore Integer 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

Il nuovo valore per l'impostazione.

Eccezioni

ArgumentNullException

settingName è null.

ArgumentException

settingName è la stringa vuota ("").

KeyNotFoundException

Il riconoscimento non ha un'impostazione con tale nome.

Esempio

L'esempio seguente fa parte di un'applicazione console che restituisce i valori per una serie di impostazioni definite per il riconoscimento che supporta le impostazioni locali en-US. L'esempio aggiorna le impostazioni del livello di attendibilità e quindi esegue una query sul riconoscimento 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 effettivi 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 specificata del motore di riconoscimento vocale con il valore di 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

Il nuovo valore per l'impostazione.

Eccezioni

ArgumentNullException

settingName è null.

ArgumentException

settingName è la stringa vuota ("").

KeyNotFoundException

Il riconoscimento non ha un'impostazione con tale nome.

Commenti

Ad eccezione di , i valori delle PersistedBackgroundAdaptationproprietà impostati usando il UpdateRecognizerSetting metodo rimangono effettivi 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)