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. Распознаватели также игнорируют новые строки и дополнительные пробелы и обрабатывают знаки препинания как литеральные входные данные.

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

Применяется к

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 перечислении .

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

Применяется к

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 перечислении .

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

Применяется к