SpeechRecognizer Класс

Определение

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

Наследование

Object

SpeechRecognizer

Реализации

IDisposable

Примеры

Следующий пример является частью консольного приложения, которое загружает грамматику распознавания речи и демонстрирует асинхронные эмулированные входные данные, связанные результаты распознавания и связанные события, вызванные распознавателями речи. Если функция распознавания речи Windows не запущена, запуск этого приложения также запустит распознавание речи Windows. Если распознавание речи Windows находится в спящем состоянии, всегда EmulateRecognizeAsync возвращает значение NULL.

using System;  
using System.Speech.Recognition;  
using System.Threading;  

namespace SharedRecognizer  
{  
  class Program  
  {  

    // Indicate whether the asynchronous emulate recognition  
    // operation has completed.  
    static bool completed;  

    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);  

        // Attach event handlers for recognition events.  
        recognizer.SpeechRecognized +=  
          new EventHandler<SpeechRecognizedEventArgs>(  
            SpeechRecognizedHandler);  
        recognizer.EmulateRecognizeCompleted +=  
          new EventHandler<EmulateRecognizeCompletedEventArgs>(  
            EmulateRecognizeCompletedHandler);  

        completed = false;  

        // Start asynchronous emulated recognition.   
        // This matches the grammar and generates a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing testing");  

        // Wait for the asynchronous operation to complete.  
        while (!completed)  
        {  
          Thread.Sleep(333);  
        }  

        completed = false;  

        // Start asynchronous emulated recognition.  
        // This does not match the grammar or generate a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing one two three");  

        // Wait for the asynchronous operation to complete.  
        while (!completed)  
        {  
          Thread.Sleep(333);  
        }  
      }  

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

    // Handle the SpeechRecognized event.  
    static void SpeechRecognizedHandler(  
      object sender, SpeechRecognizedEventArgs e)  
    {  
      if (e.Result != null)  
      {  
        Console.WriteLine("Recognition result = {0}",  
          e.Result.Text ?? "<no text>");  
      }  
      else  
      {  
        Console.WriteLine("No recognition result");  
      }  
    }  

    // Handle the SpeechRecognizeCompleted event.  
    static void EmulateRecognizeCompletedHandler(  
      object sender, EmulateRecognizeCompletedEventArgs e)  
    {  
      if (e.Result == null)  
      {  
        Console.WriteLine("No result generated.");  
      }  

      // Indicate the asynchronous operation is complete.  
      completed = true;  
    }  
  }  
}  

Комментарии

Приложения используют общий распознаватель для доступа к распознаванию речи Windows. Используйте объект , SpeechRecognizer чтобы добавить к пользовательскому интерфейсу распознавания речи Windows.

Этот класс обеспечивает контроль над различными аспектами процесса распознавания речи:

• Для управления грамматиками распознавания речи используйте LoadGrammar, LoadGrammarAsync, UnloadGrammar, UnloadAllGrammarsи Grammars.

• Чтобы получить сведения о текущих операциях распознавания речи, подпишитесь на SpeechRecognizerSpeechDetectedсобытия , SpeechHypothesized, SpeechRecognitionRejectedи SpeechRecognized .

• Чтобы просмотреть или изменить число альтернативных результатов, возвращаемых распознавателями, используйте MaxAlternates свойство . Распознаватель возвращает результаты распознавания в объекте RecognitionResult .

• Чтобы получить доступ к состоянию общего распознавателя или отслеживать его, используйте AudioLevelсвойства , AudioStateAudioPosition, Enabled, PauseRecognizerOnRecognition, , RecognizerAudioPositionи State и AudioLevelUpdatedсобытия , AudioSignalProblemOccurred, AudioStateChangedи StateChanged .

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

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

Настройка распознавания речи Windows управляется с помощью диалогового окна "Свойства речи" в панель управления. Этот интерфейс используется для выбора классического механизма распознавания речи и языка по умолчанию, звукового устройства ввода и поведения распознавания речи в спящем режиме. Если конфигурация распознавания речи Windows изменяется во время работы приложения (например, если распознавание речи отключено или язык ввода изменен), это изменение затрагивает все SpeechRecognizer объекты.

Чтобы создать внутрипроцессный распознаватель речи, не зависящий от распознавания речи Windows, используйте SpeechRecognitionEngine класс .

Конструкторы

Свойства

Методы

События

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

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

• SpeechRecognitionEngine
• Grammar
• RecognitionResult