SpeechRecognitionEngine.EmulateRecognize Метод

Определение

Пространство имен:: System.Speech.Recognition

Сборка:: System.Speech.dll

Пакет:: System.Speech v11.0.0-preview.2.26159.112

Важно!

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

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

Перегрузки

Имя	Описание
EmulateRecognize(String)	Эмулирует входные данные фразы распознаватель речи, используя текст вместо звука для синхронного распознавания речи.
EmulateRecognize(RecognizedWordUnit[], CompareOptions)	Эмулирует входные данные определенных слов в распознаватель речи, используя текст вместо звука для синхронного распознавания речи и указывает, как распознаватель обрабатывает сравнение Юникода между словами и загруженными грамматиками распознавания речи.
EmulateRecognize(String, CompareOptions)	Эмулирует входные данные фразы распознаватель речи, используя текст вместо звука для синхронного распознавания речи и указывает, как распознаватель обрабатывает сравнение Юникода между фразой и загруженными грамматиками распознавания речи.

Эти методы обходят системные звуковые входные данные и предоставляют текст распознавательу в виде String объектов или в виде массива RecognizedWordUnit объектов. Это может быть полезно при тестировании или отладке приложения или грамматики. Например, можно использовать эмуляцию, чтобы определить, находится ли слово в грамматике и какие семантики возвращаются при распознавании слова. SetInputToNull Используйте метод, чтобы отключить входные данные звука в подсистему распознавания речи во время операций эмуляции.

Распознаватель речи вызывает SpeechDetected, SpeechHypothesized SpeechRecognitionRejectedи SpeechRecognized события, как если бы операция распознавания не эмулировалась. Распознаватель игнорирует новые строки и дополнительное пробелы и обрабатывает знак препинания как литеральные входные данные.

Замечание

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

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

EmulateRecognize(String)

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.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

Входные данные для операции распознавания.

Возвращаемое значение

RecognitionResult

Результат операции распознавания или null если операция не выполнена или распознаватель не включен.

Исключения

InvalidOperationException

Распознаватель не загружает грамматики распознавания речи.

ArgumentNullException

inputText равно null.

ArgumentException

inputText — пустая строка ("").

Примеры

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

TestRecognize("Smith")...
 SpeechDetected event raised.
 SpeechRecognized event raised.
  Grammar = Smith; Text = Smith
...Recognition result text = Smith

TestRecognize("Jones")...
 SpeechDetected event raised.
 SpeechRecognized event raised.
  Grammar = Jones; Text = Jones
...Recognition result text = Jones

TestRecognize("Mister")...
 SpeechDetected event raised.
 SpeechHypothesized event raised.
  Grammar = Smith; Text = mister
 SpeechRecognitionRejected event raised.
  Grammar = <not available>; Text =
...No recognition result.

TestRecognize("Mister Smith")...
 SpeechDetected event raised.
 SpeechRecognized event raised.
  Grammar = Smith; Text = mister Smith
...Recognition result text = mister Smith

press any key to exit...

using System;
using System.Globalization;
using System.Speech.Recognition;

namespace Sre_EmulateRecognize
{
  class Program
  {
    static void Main(string[] args)
    {

      // Create an in-process speech recognizer for the en-US locale.
      using (SpeechRecognitionEngine recognizer =
        new SpeechRecognitionEngine(new CultureInfo("en-US")))
      {

        // Load grammars.
        recognizer.LoadGrammar(CreateNameGrammar("Smith"));
        recognizer.LoadGrammar(CreateNameGrammar("Jones"));

        // Disable audio input to the recognizer.
        recognizer.SetInputToNull();

        // Add handlers for events raised by the EmulateRecognize method.
        recognizer.SpeechDetected +=
          new EventHandler<SpeechDetectedEventArgs>(
            SpeechDetectedHandler);
        recognizer.SpeechHypothesized +=
          new EventHandler<SpeechHypothesizedEventArgs>(
            SpeechHypothesizedHandler);
        recognizer.SpeechRecognitionRejected +=
          new EventHandler<SpeechRecognitionRejectedEventArgs>(
            SpeechRecognitionRejectedHandler);
        recognizer.SpeechRecognized +=
          new EventHandler<SpeechRecognizedEventArgs>(
            SpeechRecognizedHandler);

        // Start four synchronous emulated recognition operations.
        TestRecognize(recognizer, "Smith");
        TestRecognize(recognizer, "Jones");
        TestRecognize(recognizer, "Mister");
        TestRecognize(recognizer, "Mister Smith");
      }

      Console.WriteLine("press any key to exit...");
      Console.ReadKey(true);
    }

    // Create a simple name grammar.
    // Set the grammar name to the surname.
    private static Grammar CreateNameGrammar(string surname)
    {
      GrammarBuilder builder = new GrammarBuilder("mister", 0, 1);
      builder.Append(surname);

      Grammar nameGrammar = new Grammar(builder);
      nameGrammar.Name = surname;

      return nameGrammar;
    }

    // Send emulated input to the recognizer for synchronous recognition.
    private static void TestRecognize(
      SpeechRecognitionEngine recognizer, string input)
    {
      Console.WriteLine("TestRecognize(\"{0}\")...", input);
      RecognitionResult result =
        recognizer.EmulateRecognize(input,CompareOptions.IgnoreCase);
      if (result != null)
      {
        Console.WriteLine("...Recognition result text = {0}",
          result.Text ?? "<null>");
      }
      else
      {
        Console.WriteLine("...No recognition result.");
      }
      Console.WriteLine();
    }

    static void SpeechDetectedHandler(
      object sender, SpeechDetectedEventArgs e)
    {
      Console.WriteLine(" SpeechDetected event raised.");
    }

    // Handle events.
    static void SpeechHypothesizedHandler(
      object sender, SpeechHypothesizedEventArgs e)
    {
      Console.WriteLine(" SpeechHypothesized event raised.");
      if (e.Result != null)
      {
        Console.WriteLine("  Grammar = {0}; Text = {1}",
          e.Result.Grammar.Name ?? "<none>", e.Result.Text);
      }
      else
      {
        Console.WriteLine("  No recognition result available.");
      }
    }

    static void SpeechRecognitionRejectedHandler(
      object sender, SpeechRecognitionRejectedEventArgs e)
    {
      Console.WriteLine(" SpeechRecognitionRejected event raised.");
      if (e.Result != null)
      {
        string grammarName;
        if (e.Result.Grammar != null)
        {
          grammarName = e.Result.Grammar.Name ?? "<none>";
        }
        else
        {
          grammarName = "<not available>";
        }
        Console.WriteLine("  Grammar = {0}; Text = {1}",
          grammarName, e.Result.Text);
      }
      else
      {
        Console.WriteLine("  No recognition result available.");
      }
    }

    static void SpeechRecognizedHandler(
      object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine(" SpeechRecognized event raised.");
      if (e.Result != null)
      {
        Console.WriteLine("  Grammar = {0}; Text = {1}",
          e.Result.Grammar.Name ?? "<none>", e.Result.Text);
      }
      else
      {
        Console.WriteLine("  No recognition result available.");
      }
    }
  }
}

Распознаватели, которые приставляются с Vista и Windows 7, игнорируют регистр и ширину символов при применении правил грамматики к входной фразе. Дополнительные сведения об этом типе сравнения см. в CompareOptions значениях OrdinalIgnoreCase перечисления и IgnoreWidth. Распознаватели также игнорируют новые строки и дополнительные пробелы и обрабатывают знаки препинания как литеральные входные данные.

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

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

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.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

Побитовое сочетание значений перечисления, описывающих тип сравнения, используемый для эмулированной операции распознавания.

Возвращаемое значение

RecognitionResult

Результат операции распознавания или null если операция не выполнена или распознаватель не включен.

Исключения

InvalidOperationException

Распознаватель не загружает грамматики распознавания речи.

ArgumentNullException

wordUnits равно null.

ArgumentException

wordUnits содержит один или несколько null элементов.

NotSupportedException

compareOptionsсодержит IgnoreNonSpace IgnoreSymbolsфлаг , или StringSort флаг.

Распознаватель использует при применении compareOptions правил грамматики к входной фразе. Распознаватели, которые приставляются с Vista и Windows 7, игнорируют регистр, если OrdinalIgnoreCase присутствует или IgnoreCase значение. Распознаватель всегда игнорирует ширину символов и никогда не пропускает тип Kana. Распознаватель также игнорирует новые строки и дополнительные пробелы и обрабатывает знак препинания как литеральные входные данные. Дополнительные сведения о ширине символов и типе Kana см. в CompareOptions перечислении.

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

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

EmulateRecognize(String, CompareOptions)

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.cs

Исходный код:: SpeechRecognitionEngine.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

Возвращаемое значение

RecognitionResult

Результат операции распознавания или null если операция не выполнена или распознаватель не включен.

Исключения

InvalidOperationException

Распознаватель не загружает грамматики распознавания речи.

ArgumentNullException

inputText равно null.

ArgumentException

inputText — пустая строка ("").

NotSupportedException

compareOptionsсодержит IgnoreNonSpace IgnoreSymbolsфлаг , или StringSort флаг.

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

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

Кері байланыс

Бет пайдалы болды ма?

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

SpeechRecognitionEngine.EmulateRecognize Метод

Определение

Перегрузки

Комментарии

EmulateRecognize(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

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

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

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

EmulateRecognize(String, CompareOptions)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

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