SpeechRecognitionEngine.QueryRecognizerSetting(String) Метод

Определение

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

System.Speech.Recognition

Сборка:

System.Speech.dll

Пакет:

System.Speech v11.0.0-preview.2.26159.112

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

SpeechRecognitionEngine.cs

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

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

Параметры

settingName

String

Имя возвращаемого параметра.

Возвращаемое значение

Object

Значение параметра.

Исключения

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

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

Комментарии

Параметры распознавателя могут содержать строки, 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).

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

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

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous