SpeechRecognitionEngine.UpdateRecognizerSetting Метод

Определение

Пространство имен:

System.Speech.Recognition

Сборка:

System.Speech.dll

Пакет:

System.Speech v9.0.0-rc.2.24473.5

Обновляет значение параметра для распознавателя.

Перегрузки

UpdateRecognizerSetting(String, Int32)	Обновляет заданный параметр для SpeechRecognitionEngine с указанным целым числом.
UpdateRecognizerSetting(String, String)	Обновляет указанный параметр механизма распознавания речи с заданным стоковым значением.

Комментарии

Параметры распознавателя могут содержать строковые, 64-разрядное целое число или данные адреса памяти. В следующей таблице описаны параметры, определенные для распознавателя, совместимого с МАЙКРОСОФТ API речи (SAPI). Следующие параметры должны иметь одинаковый диапазон для каждого распознавателя, поддерживающего этот параметр. Распознаватель, совместимый с SAPI, не требуется для поддержки этих параметров и может поддерживать другие параметры.

Имя	Описание:
ResourceUsage	Указывает потребление ЦП распознавателя. Диапазон — от 0 до 100. Значение по умолчанию — 50.
ResponseSpeed	Указывает продолжительность молчания в конце однозначных входных данных до завершения операции распознавания распознавателя речи. Диапазон — от 0 до 10 000 миллисекунда (мс). Этот параметр соответствует свойству распознавателя EndSilenceTimeout . По умолчанию = 150 мс.
ComplexResponseSpeed	Указывает продолжительность молчания в миллисекундах (мс) в конце неоднозначного ввода, прежде чем распознаватель речи завершит операцию распознавания. Диапазон — от 0 до 10 000 мс. Этот параметр соответствует свойству распознавателя EndSilenceTimeoutAmbiguous . По умолчанию = 500 мс.
AdaptationOn	Указывает, имеет ли адаптация акустической модели значение ON (значение = 1) или OFF (значение = 0). Значение по умолчанию — 1 (ON).
PersistedBackgroundAdaptation	Указывает, имеет ли фоновая адаптация значение ON (значение = 1) или OFF (значение = 0), и сохраняет параметр в реестре. Значение по умолчанию — 1 (ON).

Чтобы вернуть один из параметров распознавателя, используйте QueryRecognizerSetting метод .

За исключением PersistedBackgroundAdaptation, значения свойств, заданные с помощью UpdateRecognizerSetting методов , остаются в силе только для текущего экземпляра SpeechRecognitionEngine, после чего они возвращаются к своим параметрам по умолчанию.

Вы можете изменить реакцию распознавания речи на неречевые BabbleTimeoutвходные данные с помощью свойств , InitialSilenceTimeout, EndSilenceTimeoutи EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Исходный код:

SpeechRecognitionEngine.cs

Обновляет заданный параметр для SpeechRecognitionEngine с указанным целым числом.

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)

Параметры

settingName

String

Имя обновляемого параметра.

updatedValue

Int32

Новое значение для параметра.

Исключения

ArgumentNullException

settingName имеет значение null.

ArgumentException

settingName является пустой строкой ("").

KeyNotFoundException

Распознаватель не имеет параметра с указанным именем.

Примеры

Следующий пример является частью консольного приложения, которое выводит значения для ряда параметров, определенных для распознавателя, поддерживающего языковой стандарт en-US. В примере обновляются параметры уровня достоверности, а затем запрашивается распознаватель для проверки обновленных значений. В примере создаются следующие выходные данные.

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

Комментарии

За исключением PersistedBackgroundAdaptation, значения свойств, заданные с помощью UpdateRecognizerSetting метода , остаются в силе только для текущего экземпляра SpeechRecognitionEngine, после чего они возвращаются к своим параметрам по умолчанию. Описание поддерживаемых параметров см UpdateRecognizerSetting . в этой статье.

См. также раздел

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Исходный код:

SpeechRecognitionEngine.cs

Обновляет указанный параметр механизма распознавания речи с заданным стоковым значением.

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)

Параметры

settingName

String

Имя обновляемого параметра.

updatedValue

String

Новое значение для параметра.

Исключения

ArgumentNullException

settingName имеет значение null.

ArgumentException

settingName является пустой строкой ("").

KeyNotFoundException

Распознаватель не имеет параметра с указанным именем.

Комментарии

За исключением PersistedBackgroundAdaptation, значения свойств, заданные с помощью UpdateRecognizerSetting метода , остаются в силе только для текущего экземпляра SpeechRecognitionEngine, после чего они возвращаются к своим параметрам по умолчанию. Описание поддерживаемых параметров см UpdateRecognizerSetting . в этой статье.

См. также раздел

• QueryRecognizerSetting(String)