SpeechRecognitionEngine Constructores

Definición

Inicializa una nueva instancia de la clase SpeechRecognitionEngine.Initializes a new instance of the SpeechRecognitionEngine class.

Sobrecargas

SpeechRecognitionEngine()

Inicializa una nueva instancia de la clase SpeechRecognitionEngine utilizando el reconocedor de voz predeterminado para el sistema.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for the system.

SpeechRecognitionEngine(CultureInfo)

Inicializa una nueva instancia de la clase SpeechRecognitionEngine utilizando el reconocedor de voz predeterminado para una configuración regional especificada.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for a specified locale.

SpeechRecognitionEngine(RecognizerInfo)

Inicializa una nueva instancia de SpeechRecognitionEngine utilizando la información de un objeto RecognizerInfo para especificar el reconocedor que de va a utilizar.Initializes a new instance of the SpeechRecognitionEngine using the information in a RecognizerInfo object to specify the recognizer to use.

SpeechRecognitionEngine(String)

Inicializa una nueva instancia de la clase SpeechRecognitionEngine con un parámetro de cadena que especifica el nombre del reconocedor que se va a utilizar.Initializes a new instance of the SpeechRecognitionEngine class with a string parameter that specifies the name of the recognizer to use.

Comentarios

Puede crear una SpeechRecognitionEngine instancia de a partir de cualquiera de las siguientes opciones:You can construct a SpeechRecognitionEngine instance from any of the following:

  • Motor de reconocimiento de voz predeterminado para el sistemaThe default speech recognition engine for the system

  • Un motor de reconocimiento de voz específico que especifique por nombreA specific speech recognition engine that you specify by name

  • El motor de reconocimiento de voz predeterminado para una configuración regional que especifiqueThe default speech recognition engine for a locale that you specify

  • Un motor de reconocimiento específico que cumpla los criterios especificados en un RecognizerInfo objeto.A specific recognition engine that meets the criteria that you specify in a RecognizerInfo object.

Antes de que el reconocedor de voz pueda comenzar el reconocimiento, debe cargar al menos una gramática de reconocimiento de voz y configurar la entrada para el reconocedor.Before the speech recognizer can begin recognition, you must load at least one speech recognition grammar and configure the input for the recognizer.

Para cargar una gramática, llame al LoadGrammar LoadGrammarAsync método o.To load a grammar, call the LoadGrammar or LoadGrammarAsync method.

Para configurar la entrada de audio, use uno de los métodos siguientes:To configure the audio input, use one of the following methods:

SpeechRecognitionEngine()

Inicializa una nueva instancia de la clase SpeechRecognitionEngine utilizando el reconocedor de voz predeterminado para el sistema.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for the system.

public:
 SpeechRecognitionEngine();
public SpeechRecognitionEngine ();
Public Sub New ()

Comentarios

Antes de que el reconocedor de voz pueda comenzar el reconocimiento de voz, debe cargar al menos una gramática de reconocimiento y configurar la entrada para el reconocedor.Before the speech recognizer can begin speech recognition, you must load at least one recognition grammar and configure the input for the recognizer.

Para cargar una gramática, llame al LoadGrammar LoadGrammarAsync método o.To load a grammar, call the LoadGrammar or LoadGrammarAsync method.

Para configurar la entrada de audio, use uno de los métodos siguientes:To configure the audio input, use one of the following methods:

Se aplica a

SpeechRecognitionEngine(CultureInfo)

Inicializa una nueva instancia de la clase SpeechRecognitionEngine utilizando el reconocedor de voz predeterminado para una configuración regional especificada.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for a specified locale.

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

Configuración regional que el módulo de reconocimiento de voz debe admitir.The locale that the speech recognizer must support.

Excepciones

Ninguno de los reconocedores de voz instalados admite la configuración regional especificada, o culture es la referencia cultural invariable.None of the installed speech recognizers support the specified locale, or culture is the invariant culture.

Culture es null.Culture is null.

Ejemplos

En el ejemplo siguiente se muestra parte de una aplicación de consola que muestra el reconocimiento de voz básico e inicializa un reconocedor de voz para la configuración regional en-US.The following example shows part of a console application that demonstrates basic speech recognition, and initializes a speech recognizer for the en-US locale.

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

Comentarios

Microsoft Windows y System. Speech API aceptan todos los códigos de país de idioma válidos.Microsoft Windows and the System.Speech API accept all valid language-country codes. Para realizar el reconocimiento de voz con el idioma especificado en el CultureInfo argumento, se debe instalar un motor de reconocimiento de voz que admita ese código de país.To perform speech recognition using the language specified in the CultureInfo argument, a speech recognition engine that supports that language-country code must be installed. Los motores de reconocimiento de voz que se incluyen con Microsoft Windows 7 funcionan con los siguientes códigos de país de idioma.The speech recognition engines that shipped with Microsoft Windows 7 work with the following language-country codes.

  • en-GB.en-GB. Inglés (Reino Unido)English (United Kingdom)

  • en-US.en-US. Spanish (Traditional Sort) - SpainEnglish (United States)

  • de-DE.de-DE. Alemán (Alemania)German (Germany)

  • es-ES.es-ES. Español (España)Spanish (Spain)

  • fr-FR.fr-FR. Francés (Francia)French (France)

  • ja-JP.ja-JP. Japonés (Japón)Japanese (Japan)

  • zh-CN.zh-CN. Chino (China)Chinese (China)

  • zh-TW.zh-TW. Chino (Taiwán)Chinese (Taiwan)

También se permiten códigos de idioma de dos letras, como "en", "fr" o "es".Two-letter language codes such as "en", "fr", or "es" are also permitted.

Antes de que el reconocedor de voz pueda comenzar el reconocimiento, debe cargar al menos una gramática de reconocimiento de voz y configurar la entrada para el reconocedor.Before the speech recognizer can begin recognition, you must load at least one speech recognition grammar and configure the input for the recognizer.

Para cargar una gramática, llame al LoadGrammar LoadGrammarAsync método o.To load a grammar, call the LoadGrammar or LoadGrammarAsync method.

Para configurar la entrada de audio, use uno de los métodos siguientes:To configure the audio input, use one of the following methods:

Se aplica a

SpeechRecognitionEngine(RecognizerInfo)

Inicializa una nueva instancia de SpeechRecognitionEngine utilizando la información de un objeto RecognizerInfo para especificar el reconocedor que de va a utilizar.Initializes a new instance of the SpeechRecognitionEngine using the information in a RecognizerInfo object to specify the recognizer to use.

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

La información del módulo de reconocimiento de voz concreto.The information for the specific speech recognizer.

Ejemplos

En el ejemplo siguiente se muestra parte de una aplicación de consola que muestra el reconocimiento de voz básico e inicializa un reconocedor de voz que admite el idioma inglés.The following example shows part of a console application that demonstrates basic speech recognition, and initializes a speech recognizer that supports the English language.

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

Comentarios

Puede crear una instancia de esta clase para cualquiera de los reconocedores de voz instalados.You can create an instance of this class for any of the installed speech recognizers. Para obtener información acerca de los reconocedores instalados, use el InstalledRecognizers método.To get information about which recognizers are installed, use the InstalledRecognizers method.

Antes de que el reconocedor de voz pueda comenzar el reconocimiento, debe cargar al menos una gramática de reconocimiento de voz y configurar la entrada para el reconocedor.Before the speech recognizer can begin recognition, you must load at least one speech recognition grammar and configure the input for the recognizer.

Para cargar una gramática, llame al LoadGrammar LoadGrammarAsync método o.To load a grammar, call the LoadGrammar or LoadGrammarAsync method.

Para configurar la entrada de audio, use uno de los métodos siguientes:To configure the audio input, use one of the following methods:

Se aplica a

SpeechRecognitionEngine(String)

Inicializa una nueva instancia de la clase SpeechRecognitionEngine con un parámetro de cadena que especifica el nombre del reconocedor que se va a utilizar.Initializes a new instance of the SpeechRecognitionEngine class with a string parameter that specifies the name of the recognizer to use.

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

El nombre de token de módulo de reconocimiento de voz para usar.The token name of the speech recognizer to use.

Excepciones

No se instala ningún reconocedor de voz con ese nombre de token o recognizerId es una cadena vacía ("").No speech recognizer with that token name is installed, or recognizerId is the empty string ("").

recognizerId es null.recognizerId is null.

Ejemplos

En el ejemplo siguiente se muestra parte de una aplicación de consola que muestra el reconocimiento de voz básico y crea una instancia del reconocedor de voz 8,0 para Windows (Inglés-Estados Unidos).The following example shows part of a console application that demonstrates basic speech recognition, and creates an instance of the Speech Recognizer 8.0 for Windows (English - US).

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

Comentarios

El nombre de token del reconocedor es el valor de la Id propiedad del RecognizerInfo objeto devuelto por la RecognizerInfo propiedad del reconocedor.The token name of the recognizer is the value of the Id property of the RecognizerInfo object returned by the RecognizerInfo property of the recognizer. Para obtener una colección de todos los reconocedores instalados, use el InstalledRecognizers método estático.To get a collection of all the installed recognizers, use the static InstalledRecognizers method.

Antes de que el reconocedor de voz pueda comenzar el reconocimiento, debe cargar al menos una gramática de reconocimiento de voz y configurar la entrada para el reconocedor.Before the speech recognizer can begin recognition, you must load at least one speech recognition grammar and configure the input for the recognizer.

Para cargar una gramática, llame al LoadGrammar LoadGrammarAsync método o.To load a grammar, call the LoadGrammar or LoadGrammarAsync method.

Para configurar la entrada de audio, use uno de los métodos siguientes:To configure the audio input, use one of the following methods:

Se aplica a