SpeechRecognitionEngine.QueryRecognizerSetting(String) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Speech.Recognition
Assembly:
System.Speech.dll

Restituisce i valori delle impostazioni per il riconoscimento.

public:
 System::Object ^ QueryRecognizerSetting(System::String ^ settingName);
public object QueryRecognizerSetting (string settingName);
member this.QueryRecognizerSetting : string -> obj
Public Function QueryRecognizerSetting (settingName As String) As Object

Parametri

settingName
String

Nome dell'impostazione da restituire.

Restituisce

Object

Valore dell'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. Nell'esempio viene generato 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  

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

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

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

Commenti

Le impostazioni del sistema di riconoscimento possono contenere dati stringa, interi a 64 bit o indirizzi di memoria. Nella tabella seguente vengono descritte le impostazioni definite per un riconoscimento conforme a Microsoft Speech API (SAPI). Le impostazioni seguenti devono avere lo stesso intervallo per ogni riconoscimento che supporta l'impostazione. Non è necessario un riconoscimento conforme a SAPI 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 di un 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 riconoscitore EndSilenceTimeout . Impostazione predefinita = 150ms.
ComplexResponseSpeed Indica la lunghezza del silenzio alla fine dell'input ambiguo prima che il riconoscimento vocale completi un'operazione di riconoscimento. L'intervallo è compreso tra 0 e 10, 1.000 ms. Questa impostazione corrisponde alla proprietà del riconoscitore EndSilenceTimeoutAmbiguous . Impostazione predefinita = 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 (value = 1 ) o off (value = 0 ) e rende permanente l'impostazione nel registro di sistema. Il valore predefinito è 1 (on).

Per aggiornare un'impostazione per il riconoscimento, usare uno dei UpdateRecognizerSetting metodi.

Si applica a

Vedi anche