Бөлісу құралы:


SpeechRecognizer.EmulateRecognize Метод

Определение

Эмулирует входные данные для распознавателя общей речи, используя текст вместо звука для синхронного распознавания речи.

Перегрузки

Имя Описание
EmulateRecognize(String)

Эмулирует входные данные фразы в распознаватель общей речи, используя текст вместо звука для синхронного распознавания речи.

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Эмулирует входные данные определенных слов в распознаватель общей речи, используя текст вместо звука для синхронного распознавания речи, и указывает, как распознаватель обрабатывает сравнение Юникода между словами и загруженными грамматиками распознавания речи.

EmulateRecognize(String, CompareOptions)

Эмулирует входные данные фразы в распознаватель общей речи, используя текст вместо звука для синхронного распознавания речи, и указывает, как распознаватель обрабатывает сравнение Юникода между фразой и загруженными грамматиками распознавания речи.

Комментарии

Эти методы обходят системный звуковой ввод. Это может быть полезно при тестировании или отладке приложения или грамматики.

Замечание

Если распознавание речи Windows находится в спящем состоянии, эти методы возвращаются null.

Общий распознаватель вызывает SpeechDetectedи события, SpeechRecognitionRejectedSpeechHypothesizedSpeechRecognized как если бы операция распознавания не эмулировалась. Распознаватель игнорирует новые строки и дополнительное пробелы и обрабатывает знак препинания как литеральные входные данные.

Замечание

Объект RecognitionResult , созданный общим распознавательом в ответ на эмулированные входные данные, имеет значение null для его Audio свойства.

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

EmulateRecognize(String)

Исходный код:
SpeechRecognizer.cs
Исходный код:
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
Исходный код:
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 значение. Распознаватели всегда игнорируют ширину символов и никогда не игнорируют тип Kana. Распознаватели также игнорируют новые строки и дополнительные пробелы и обрабатывают знаки препинания как литеральные входные данные. Дополнительные сведения о ширине символов и типе Kana см. в CompareOptions перечислении.

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

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

EmulateRecognize(String, CompareOptions)

Исходный код:
SpeechRecognizer.cs
Исходный код:
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 значение. Распознаватели всегда игнорируют ширину символов и никогда не игнорируют тип Kana. Распознаватели также игнорируют новые строки и дополнительные пробелы и обрабатывают знаки препинания как литеральные входные данные. Дополнительные сведения о ширине символов и типе Kana см. в CompareOptions перечислении.

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

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