SpeechRecognitionEngine.UpdateRecognizerSetting Метод

Определение

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

System.Speech.Recognition

Сборка:

System.Speech.dll

Пакет:

System.Speech v11.0.0-preview.2.26159.112

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

Перегрузки

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

Комментарии

Параметры распознавателя могут содержать строки, 64-разрядное целое число или данные адреса памяти. В следующей таблице описываются параметры, определенные для распознавателя распознавания речи Майкрософт (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	Указывает, является ли фоновая адаптация включенной (значение = 1) или OFF (значение = 0) и сохраняет параметр в реестре. Значением по умолчанию является 1 (ON).

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

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

Вы можете изменить способ реагирования распознавания речи на входные данные, отличные от речи, с помощью BabbleTimeoutсвойств , InitialSilenceTimeoutEndSilenceTimeoutи 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)