SpeechRecognizer.EmulateRecognize Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Эмулирует ввод в общий распознаватель речи, используя текст вместо аудио для синхронного распознавания речи.
Перегрузки
EmulateRecognize(String) |
Эмулирует ввод фразы в общий распознаватель речи, используя текст вместо аудио для синхронного распознавания речи. |
EmulateRecognize(RecognizedWordUnit[], CompareOptions) |
Эмулирует ввод конкретных слов в общий распознаватель речи, используя текст вместо аудио для синхронного распознавания речи, и указывает способ обработки распознавателем сравнения Юникода между словами и загруженными грамматиками распознавания речи. |
EmulateRecognize(String, CompareOptions) |
Эмулирует ввод фразы в общий распознаватель речи, используя текст вместо аудио для синхронного распознавания речи, и указывает способ обработки распознавателем сравнения Юникода между фразой и загруженными грамматиками распознавания речи. |
Комментарии
Эти методы обходят системный аудиовход. Это может быть полезно при тестировании или отладке приложения или грамматики.
Примечание
Если распознавание речи Windows находится в спящем состоянии, эти методы возвращают null
.
Общий распознаватель вызывает SpeechDetectedсобытия , SpeechHypothesized, SpeechRecognitionRejectedи SpeechRecognized так, как если бы операция распознавания не эмулировалась. Распознаватель игнорирует новые строки и дополнительные пробелы и обрабатывает знаки препинания как литеральные входные данные.
Примечание
Объект RecognitionResult , созданный общим распознавателями в ответ на эмулированные входные данные, имеет значение null
для своего Audio свойства .
Чтобы эмулировать асинхронное распознавание EmulateRecognizeAsync , используйте метод .
EmulateRecognize(String)
- Исходный код:
- SpeechRecognizer.cs
- Исходный код:
- SpeechRecognizer.cs
- Исходный код:
- SpeechRecognizer.cs
Эмулирует ввод фразы в общий распознаватель речи, используя текст вместо аудио для синхронного распознавания речи.
public:
System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(System::String ^ inputText);
public System.Speech.Recognition.RecognitionResult EmulateRecognize (string inputText);
member this.EmulateRecognize : string -> System.Speech.Recognition.RecognitionResult
Public Function EmulateRecognize (inputText As String) As RecognitionResult
Параметры
- inputText
- String
Входные данные для операции распознавания.
Возвращаемое значение
Результат распознавания для операции распознавания или null
, если операция завершилась неудачно или распознавание речи Windows находится в состоянии Сон.
Примеры
В следующем примере пример грамматики загружается в общий распознаватель и эмулирует входные данные в распознаватель. Если функция распознавания речи Windows не запущена, запуск этого приложения также запустит распознавание речи Windows. Если распознавание речи Windows находится в спящем состоянии, всегда EmulateRecognize возвращает значение NULL.
using System;
using System.Speech.Recognition;
namespace SharedRecognizer
{
class Program
{
static void Main(string[] args)
{
// Initialize an instance of the shared recognizer.
using (SpeechRecognizer recognizer = new SpeechRecognizer())
{
// Create and load a sample grammar.
Grammar testGrammar =
new Grammar(new GrammarBuilder("testing testing"));
testGrammar.Name = "Test Grammar";
recognizer.LoadGrammar(testGrammar);
RecognitionResult result;
// This EmulateRecognize call matches the grammar and returns a
// recognition result.
result = recognizer.EmulateRecognize("testing testing");
OutputResult(result);
// This EmulateRecognize call does not match the grammar and
// returns null.
result = recognizer.EmulateRecognize("testing one two three");
OutputResult(result);
}
Console.WriteLine();
Console.WriteLine("Press any key to exit...");
Console.ReadKey();
}
// Output information about a recognition result to the console.
private static void OutputResult(RecognitionResult result)
{
if (result != null)
{
Console.WriteLine("Recognition result = {0}",
result.Text ?? "<no text>");
}
else
{
Console.WriteLine("No recognition result");
}
}
}
}
Комментарии
Распознаватели, поставляемые с Vista и Windows 7, игнорируют регистр и ширину символов при применении правил грамматики к входной фразе. Дополнительные сведения об этом типе сравнения см. в разделах CompareOptions значения OrdinalIgnoreCase перечисления и IgnoreWidth. Распознаватели также игнорируют новые строки и дополнительные пробелы и обрабатывают знаки препинания как литеральные входные данные.
См. также раздел
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized
Применяется к
EmulateRecognize(RecognizedWordUnit[], CompareOptions)
- Исходный код:
- SpeechRecognizer.cs
- Исходный код:
- SpeechRecognizer.cs
- Исходный код:
- SpeechRecognizer.cs
Эмулирует ввод конкретных слов в общий распознаватель речи, используя текст вместо аудио для синхронного распознавания речи, и указывает способ обработки распознавателем сравнения Юникода между словами и загруженными грамматиками распознавания речи.
public:
System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(cli::array <System::Speech::Recognition::RecognizedWordUnit ^> ^ wordUnits, System::Globalization::CompareOptions compareOptions);
public System.Speech.Recognition.RecognitionResult EmulateRecognize (System.Speech.Recognition.RecognizedWordUnit[] wordUnits, System.Globalization.CompareOptions compareOptions);
member this.EmulateRecognize : System.Speech.Recognition.RecognizedWordUnit[] * System.Globalization.CompareOptions -> System.Speech.Recognition.RecognitionResult
Public Function EmulateRecognize (wordUnits As RecognizedWordUnit(), compareOptions As CompareOptions) As RecognitionResult
Параметры
- wordUnits
- RecognizedWordUnit[]
Массив единиц слов, содержащий входные данные для операции распознавания.
- compareOptions
- CompareOptions
Поразрядное сочетание значений перечисления, описывающих тип сравнения, который требуется использовать для эмулируемой операции распознавания.
Возвращаемое значение
Результат распознавания для операции распознавания или null
, если операция завершилась неудачно или распознавание речи Windows находится в состоянии Сон.
Комментарии
Этот метод создает объект с RecognitionResult использованием сведений, указанных в параметре wordUnits
.
Распознаватель использует , compareOptions
когда применяет правила грамматики к входной фразе. Распознаватели, поставляемые вместе с Vista и Windows 7, игнорируют регистр, если OrdinalIgnoreCase имеется значение или IgnoreCase . Распознавтели всегда игнорируют ширину символов и никогда не игнорируют тип Кана. Распознавтели также игнорируют новые строки и лишние пробелы и обрабатывают знаки препинания как литеральные входные данные. Дополнительные сведения о ширине символов и типе каны см. в CompareOptions перечислении .
См. также раздел
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized
Применяется к
EmulateRecognize(String, CompareOptions)
- Исходный код:
- SpeechRecognizer.cs
- Исходный код:
- SpeechRecognizer.cs
- Исходный код:
- SpeechRecognizer.cs
Эмулирует ввод фразы в общий распознаватель речи, используя текст вместо аудио для синхронного распознавания речи, и указывает способ обработки распознавателем сравнения Юникода между фразой и загруженными грамматиками распознавания речи.
public:
System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(System::String ^ inputText, System::Globalization::CompareOptions compareOptions);
public System.Speech.Recognition.RecognitionResult EmulateRecognize (string inputText, System.Globalization.CompareOptions compareOptions);
member this.EmulateRecognize : string * System.Globalization.CompareOptions -> System.Speech.Recognition.RecognitionResult
Public Function EmulateRecognize (inputText As String, compareOptions As CompareOptions) As RecognitionResult
Параметры
- inputText
- String
Входная фраза для операции распознавания.
- compareOptions
- CompareOptions
Поразрядное сочетание значений перечисления, описывающих тип сравнения, который требуется использовать для эмулируемой операции распознавания.
Возвращаемое значение
Результат распознавания для операции распознавания или null
, если операция завершилась неудачно или распознавание речи Windows находится в состоянии Сон.
Комментарии
Распознаватель использует , compareOptions
когда применяет правила грамматики к входной фразе. Распознаватели, поставляемые вместе с Vista и Windows 7, игнорируют регистр, если OrdinalIgnoreCase имеется значение или IgnoreCase . Распознавтели всегда игнорируют ширину символов и никогда не игнорируют тип Кана. Распознавтели также игнорируют новые строки и лишние пробелы и обрабатывают знаки препинания как литеральные входные данные. Дополнительные сведения о ширине символов и типе каны см. в CompareOptions перечислении .
См. также раздел
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized