SpeechRecognitionEngine.QueryRecognizerSetting(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значения параметров для распознавателя.
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
Имя возвращаемого параметра.
Возвращаемое значение
Значение параметра.
Исключения
settingName
имеет значение null
.
settingName
является пустой строкой ("").
Распознаватель не имеет параметра с указанным именем.
Примеры
Следующий пример является частью консольного приложения, которое выводит значения для ряда параметров, определенных для распознавателя, поддерживающего языковой стандарт 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 методов .