SpeechRecognitionEngine Construtores

Definição

Espaço de Nomes:: System.Speech.Recognition

Assemblagem:: System.Speech.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da SpeechRecognitionEngine classe.

Sobrecargas

Name	Description
SpeechRecognitionEngine()	Inicializa uma nova instância da SpeechRecognitionEngine classe usando o reconhecimento de fala padrão do sistema.
SpeechRecognitionEngine(CultureInfo)	Inicializa uma nova instância da SpeechRecognitionEngine classe usando o reconhecimento de fala por defeito para uma localização especificada.
SpeechRecognitionEngine(RecognizerInfo)	Inicializa uma nova instância de usar SpeechRecognitionEngine a informação num RecognizerInfo objeto para especificar o reconhecedor a usar.
SpeechRecognitionEngine(String)	Inicializa uma nova instância da SpeechRecognitionEngine classe com um parâmetro de string que especifica o nome do reconhecor a usar.

Observações

Pode construir uma SpeechRecognitionEngine instância a partir de qualquer um dos seguintes:

O motor de reconhecimento de voz padrão para o sistema
Um motor específico de reconhecimento de voz que especifica pelo nome
O motor de reconhecimento de voz por defeito para uma localização que especifica
Um motor de reconhecimento específico que cumpra os critérios que especifica num RecognizerInfo objeto.

Antes de o reconhecedor de voz poder iniciar o reconhecimento, deve carregar pelo menos uma gramática de reconhecimento de fala e configurar a entrada para o reconhecedor.

Para carregar uma gramática, chame o LoadGrammar método ou LoadGrammarAsync .

Para configurar a entrada de áudio, utilize um dos seguintes métodos:

SpeechRecognitionEngine()

Inicializa uma nova instância da SpeechRecognitionEngine classe usando o reconhecimento de fala padrão do sistema.

public:
 SpeechRecognitionEngine();

public SpeechRecognitionEngine();

Public Sub New ()

Observações

Antes de o reconhecedor de voz poder iniciar o reconhecimento de voz, deve carregar pelo menos uma gramática de reconhecimento e configurar a entrada para o reconhecedor.

Para carregar uma gramática, chame o LoadGrammar método ou LoadGrammarAsync .

Para configurar a entrada de áudio, utilize um dos seguintes métodos:

Aplica-se a

SpeechRecognitionEngine(CultureInfo)

Inicializa uma nova instância da SpeechRecognitionEngine classe usando o reconhecimento de fala por defeito para uma localização especificada.

public:
 SpeechRecognitionEngine(System::Globalization::CultureInfo ^ culture);

public SpeechRecognitionEngine(System.Globalization.CultureInfo culture);

new System.Speech.Recognition.SpeechRecognitionEngine : System.Globalization.CultureInfo -> System.Speech.Recognition.SpeechRecognitionEngine

Public Sub New (culture As CultureInfo)

Parâmetros

culture: CultureInfo

O local que o reconhecedor de fala deve suportar.

Exceções

ArgumentException

Nenhum dos reconhecedores de fala instalados suporta a localização especificada, nem culture é a cultura invariante.

ArgumentNullException

Culture é null.

Exemplos

O exemplo seguinte mostra parte de uma aplicação de consola que demonstra reconhecimento básico de fala e inicializa um reconhecimento de voz para o local en-US.

using System;
using System.Speech.Recognition;

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

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

        // Create and load a dictation grammar.
        recognizer.LoadGrammar(new DictationGrammar());

        // Add a handler for the speech recognized event.
        recognizer.SpeechRecognized +=
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);

        // Configure input to the speech recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // Start asynchronous, continuous speech recognition.
        recognizer.RecognizeAsync(RecognizeMode.Multiple);

        // Keep the console window open.
        while (true)
        {
          Console.ReadLine();
        }
      }
    }

    // Handle the SpeechRecognized event.
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine("Recognized text: " + e.Result.Text);
    }
  }
}

Observações

Microsoft Windows e a API System.Speech aceitam todos os códigos válidos de língua-país. Para realizar o reconhecimento de voz usando a linguagem especificada no CultureInfo argumento, deve ser instalado um motor de reconhecimento de voz que suporte esse código língua-país. Os motores de reconhecimento de voz que vieram com Microsoft Windows 7 funcionam com os seguintes códigos de língua e país.

en-GB. Inglês (Reino Unido)
en-US. Inglês (Estados Unidos)
de-DE. Alemão (Alemanha)
es-ES. Espanhol (Espanha)
fr-FR. Francês (França)
ja-JP. Japonês (Japão)
zh-CN. Chinês (China)
zh-TW. Chinês (Taiwan)

Códigos linguísticos de duas letras como "en", "fr" ou "es" também são permitidos.

Antes de o reconhecedor de voz poder iniciar o reconhecimento, deve carregar pelo menos uma gramática de reconhecimento de fala e configurar a entrada para o reconhecedor.

Para carregar uma gramática, chame o LoadGrammar método ou LoadGrammarAsync .

Para configurar a entrada de áudio, utilize um dos seguintes métodos:

Aplica-se a

SpeechRecognitionEngine(RecognizerInfo)

Inicializa uma nova instância de usar SpeechRecognitionEngine a informação num RecognizerInfo objeto para especificar o reconhecedor a usar.

public:
 SpeechRecognitionEngine(System::Speech::Recognition::RecognizerInfo ^ recognizerInfo);

public SpeechRecognitionEngine(System.Speech.Recognition.RecognizerInfo recognizerInfo);

new System.Speech.Recognition.SpeechRecognitionEngine : System.Speech.Recognition.RecognizerInfo -> System.Speech.Recognition.SpeechRecognitionEngine

Public Sub New (recognizerInfo As RecognizerInfo)

Parâmetros

recognizerInfo: RecognizerInfo

A informação para o reconhecedor de fala específico.

Exemplos

O exemplo seguinte mostra parte de uma aplicação de consola que demonstra reconhecimento básico de fala e inicializa um reconhecor de voz que suporta a língua inglesa.

 using System;
using System.Speech.Recognition;

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

      // Select a speech recognizer that supports English.
      RecognizerInfo info = null;
      foreach (RecognizerInfo ri in SpeechRecognitionEngine.InstalledRecognizers())
      {
        if (ri.Culture.TwoLetterISOLanguageName.Equals("en"))
        {
          info = ri;
          break;
        }
      }
      if (info == null) return;

      // Create the selected recognizer.
      using (SpeechRecognitionEngine recognizer =
        new SpeechRecognitionEngine(info))
      {

        // Create and load a dictation grammar.
        recognizer.LoadGrammar(new DictationGrammar());

        // Add a handler for the speech recognized event.
        recognizer.SpeechRecognized +=
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);

        // Configure input to the speech recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // Start asynchronous, continuous speech recognition.
        recognizer.RecognizeAsync(RecognizeMode.Multiple);

        // Keep the console window open.
        while (true)
        {
          Console.ReadLine();
        }
      }
    }

    // Handle the SpeechRecognized event.
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine("Recognized text: " + e.Result.Text);
    }
  }
}

Observações

Pode criar uma instância desta classe para qualquer um dos reconhecedores de fala instalados. Para obter informações sobre quais os reconhecedores instalados, utilize o InstalledRecognizers método.

Antes de o reconhecedor de voz poder iniciar o reconhecimento, deve carregar pelo menos uma gramática de reconhecimento de fala e configurar a entrada para o reconhecedor.

Para carregar uma gramática, chame o LoadGrammar método ou LoadGrammarAsync .

Para configurar a entrada de áudio, utilize um dos seguintes métodos:

Aplica-se a

SpeechRecognitionEngine(String)

Inicializa uma nova instância da SpeechRecognitionEngine classe com um parâmetro de string que especifica o nome do reconhecor a usar.

public:
 SpeechRecognitionEngine(System::String ^ recognizerId);

public SpeechRecognitionEngine(string recognizerId);

new System.Speech.Recognition.SpeechRecognitionEngine : string -> System.Speech.Recognition.SpeechRecognitionEngine

Public Sub New (recognizerId As String)

Parâmetros

recognizerId: String

O nome do token do reconhecedor de fala a usar.

Exceções

ArgumentException

Nenhum reconhecedor de fala com esse nome de token está instalado, nem recognizerId é a cadeia vazia ("").

ArgumentNullException

recognizerId é null.

Exemplos

O exemplo seguinte mostra parte de uma aplicação de consola que demonstra reconhecimento básico de fala e cria uma instância do Speech Recognizer 8.0 para Windows (Inglês - EUA).

using System;
using System.Speech.Recognition;

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

      // Create an instance of the Microsoft Speech Recognizer 8.0 for
      // Windows (English - US).
      using (SpeechRecognitionEngine recognizer =
        new SpeechRecognitionEngine("MS-1033-80-DESK"))
      {

        // Create and load a dictation grammar.
        recognizer.LoadGrammar(new DictationGrammar());

        // Add a handler for the speech recognized event.
        recognizer.SpeechRecognized += new EventHandler(recognizer_SpeechRecognized);

        // Configure input to the speech recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // Start asynchronous, continuous speech recognition.
        recognizer.RecognizeAsync(RecognizeMode.Multiple);

        // Keep the console window open.
        while (true)
        {
          Console.ReadLine();
        }
      }
    }

    // Handle the SpeechRecognized event.
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine("Recognized text: " + e.Result.Text);
    }
  }
}

Observações

O nome do token do recognizer é o valor da Id propriedade do RecognizerInfo objeto devolvida pela RecognizerInfo propriedade do recognizer. Para obter uma coleção de todos os reconhecedores instalados, use o método estático InstalledRecognizers .

Antes de o reconhecedor de voz poder iniciar o reconhecimento, deve carregar pelo menos uma gramática de reconhecimento de fala e configurar a entrada para o reconhecedor.

Para carregar uma gramática, chame o LoadGrammar método ou LoadGrammarAsync .

Para configurar a entrada de áudio, utilize um dos seguintes métodos:

Aplica-se a

Comentários

Esta página foi útil?