SpeechRecognitionEngine.QueryRecognizerSetting(String) Метод

Определение

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

System.Speech.Recognition

Сборка:

System.Speech.dll

Пакет:

System.Speech v9.0.0-preview.3.24172.9

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

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-разрядное целое число или данные адреса памяти. В следующей таблице описаны параметры, определенные для распознавателя, совместимого с МАЙКРОСОФТ 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).

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

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

• UpdateRecognizerSetting(String, Int32)
• EndSilenceTimeout
• EndSilenceTimeoutAmbiguous