SpeechSynthesizer SpeechSynthesizer SpeechSynthesizer SpeechSynthesizer Class

Definición

Proporciona acceso a la funcionalidad de un motor de síntesis de voz instalado.Provides access to the functionality of an installed speech synthesis engine.

public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
    interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
Herencia
SpeechSynthesizerSpeechSynthesizerSpeechSynthesizerSpeechSynthesizer
Implementaciones

Ejemplos

El ejemplo siguiente es parte de una aplicación de consola que inicializa un SpeechSynthesizer objeto y es orador una cadena.The following example is part of a console application that initializes a SpeechSynthesizer object and speaks a string.


using System;  
using System.Speech.Synthesis;  

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

      // Initialize a new instance of the SpeechSynthesizer.  
      SpeechSynthesizer synth = new SpeechSynthesizer();  

      // Configure the audio output.   
      synth.SetOutputToDefaultAudioDevice();  

      // Speak a string.  
      synth.Speak("This example demonstrates a basic use of Speech Synthesizer");  

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

Comentarios

Cuando se crea un nuevo SpeechSynthesizer de objeto, usa la voz del sistema de forma predeterminada.When you create a new SpeechSynthesizer object, it uses the default system voice. Para configurar el SpeechSynthesizer para usar una de las voces de síntesis (texto a voz) de voz instalado, use el SelectVoice o SelectVoiceByHints método.To configure the SpeechSynthesizer to use one of the installed speech synthesis (text-to-speech) voices, use the SelectVoice or SelectVoiceByHints method. Para obtener información sobre la que se instalan las voces, use el GetInstalledVoices método y el VoiceInfo clase.To get information about which voices are installed, use the GetInstalledVoices method and the VoiceInfo class.

Esta clase también proporciona control sobre los siguientes aspectos de síntesis de voz:This class also provides control over the following aspects of speech synthesis:

El SpeechSynthesizer provoca eventos cuando encuentra determinadas características en los mensajes: (BookmarkReached, PhonemeReached, VisemeReached, y SpeakProgress).The SpeechSynthesizer raises events when it encounters certain features in prompts: (BookmarkReached, PhonemeReached, VisemeReached, and SpeakProgress). También provoca eventos que informan sobre el inicio (SpeakStarted) y final (SpeakCompleted) de hablar de las operaciones y en el cambio de la voz (VoiceChange).It also raises events that report on the start (SpeakStarted) and end (SpeakCompleted) of speak operations and on the change of the speaking voice (VoiceChange).

Nota

Realice siempre una llamada a Dispose antes de liberar la última referencia al objeto SpeechSynthesizer.Always call Dispose before you release your last reference to the SpeechSynthesizer. En caso contrario, los recursos que está usando no se liberarán hasta que el recolector de elementos no utilizados llame al método SpeechSynthesizer del objeto Finalize.Otherwise, the resources it is using will not be freed until the garbage collector calls the SpeechSynthesizer object's Finalize method.

Constructores

SpeechSynthesizer() SpeechSynthesizer() SpeechSynthesizer() SpeechSynthesizer()

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

Propiedades

Rate Rate Rate Rate

Obtiene o establece la velocidad de habla del objeto SpeechSynthesizer.Gets or sets the speaking rate of the SpeechSynthesizer object.

State State State State

Obtiene el estado de habla actual del objeto SpeechSynthesizer.Gets the current speaking state of the SpeechSynthesizer object.

Voice Voice Voice Voice

Obtiene información acerca de la voz actual del objeto SpeechSynthesizer.Gets information about the current voice of the SpeechSynthesizer object.

Volume Volume Volume Volume

Obtiene o establece el volumen de salida del objeto SpeechSynthesizer.Get or sets the output volume of the SpeechSynthesizer object.

Métodos

AddLexicon(Uri, String) AddLexicon(Uri, String) AddLexicon(Uri, String) AddLexicon(Uri, String)

Agrega un léxico al objeto SpeechSynthesizer.Adds a lexicon to the SpeechSynthesizer object.

Dispose() Dispose() Dispose() Dispose()

Desecha el objeto SpeechSynthesizer y libera los recursos utilizados durante la sesión.Disposes the SpeechSynthesizer object and releases resources used during the session.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Actúa como medida de seguridad para limpiar los recursos en caso de que no se llame al método Dispose().Acts as a safeguard to clean up resources in the event that the Dispose() method is not called.

GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt()

Obtiene el marcador del que SpeechSynthesizer está hablando.Gets the prompt that the SpeechSynthesizer is speaking.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetInstalledVoices() GetInstalledVoices() GetInstalledVoices() GetInstalledVoices()

Devuelve todas las voces de síntesis de voz (texto a voz) instaladas.Returns all of the installed speech synthesis (text-to-speech) voices.

GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo)

Devuelve todas las voces de síntesis de voz (texto a voz) instaladas que admiten una configuración regional específica.Returns all of the installed speech synthesis (text-to-speech) voices that support a specific locale.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Pause() Pause() Pause() Pause()

Hace una pausa en el objeto SpeechSynthesizer.Pauses the SpeechSynthesizer object.

RemoveLexicon(Uri) RemoveLexicon(Uri) RemoveLexicon(Uri) RemoveLexicon(Uri)

Quita un léxico del objeto SpeechSynthesizer.Removes a lexicon from the SpeechSynthesizer object.

Resume() Resume() Resume() Resume()

Reanuda el objeto de SpeechSynthesizer después de haberse pausado.Resumes the SpeechSynthesizer object after it has been paused.

SelectVoice(String) SelectVoice(String) SelectVoice(String) SelectVoice(String)

Selecciona una voz concreta por nombre.Selects a specific voice by name.

SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender)

Selecciona una voz con un género concreto.Selects a voice with a specific gender.

SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge)

Selecciona una voz con un género y edad específicos.Selects a voice with a specific gender and age.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32)

Selecciona una voz con un género y edad específicos, en función de la posición en la que se ordenan las voces.Selects a voice with a specific gender and age, based on the position in which the voices are ordered.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)

Selecciona una voz con un género, edad y configuración regional específicos, en función de la posición en la que se ordenan las voces.Selects a voice with a specific gender, age, and locale, based on the position in which the voices are ordered.

SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

Configura el objeto SpeechSynthesizer para anexar el resultado a una secuencia de audio.Configures the SpeechSynthesizer object to append output to an audio stream.

SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice()

Configura el objeto SpeechSynthesizer para enviar la salida al dispositivo de audio predeterminado.Configures the SpeechSynthesizer object to send output to the default audio device.

SetOutputToNull() SetOutputToNull() SetOutputToNull() SetOutputToNull()

Configura el objeto SpeechSynthesizer para no enviar los resultados de las operaciones de síntesis a un dispositivo, un archivo o un flujo.Configures the SpeechSynthesizer object to not send output from synthesis operations to a device, file, or stream.

SetOutputToWaveFile(String) SetOutputToWaveFile(String) SetOutputToWaveFile(String) SetOutputToWaveFile(String)

Configura el objeto SpeechSynthesizer para anexar la salida a un archivo que contiene audio de formato de forma de onda.Configures the SpeechSynthesizer object to append output to a file that contains Waveform format audio.

SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo)

Configura el objeto SpeechSynthesizer para anexar la salida a un archivo de formato de audio de forma de onda en un formato especificado.Configures the SpeechSynthesizer object to append output to a Waveform audio format file in a specified format.

SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream)

Configura el objeto SpeechSynthesizer para anexar la salida a un flujo que contiene audio de formato de forma de onda.Configures the SpeechSynthesizer object to append output to a stream that contains Waveform format audio.

Speak(Prompt) Speak(Prompt) Speak(Prompt) Speak(Prompt)

De forma sincrónica habla el contenido de un objeto Prompt.Synchronously speaks the contents of a Prompt object.

Speak(PromptBuilder) Speak(PromptBuilder) Speak(PromptBuilder) Speak(PromptBuilder)

De forma sincrónica habla el contenido de un objeto PromptBuilder.Synchronously speaks the contents of a PromptBuilder object.

Speak(String) Speak(String) Speak(String) Speak(String)

De forma sincrónica habla el contenido de una cadena.Synchronously speaks the contents of a string.

SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt)

De forma asincrónica habla el contenido de un objeto Prompt.Asynchronously speaks the contents of a Prompt object.

SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder)

De forma asincrónica habla el contenido de un objeto PromptBuilder.Asynchronously speaks the contents of a PromptBuilder object.

SpeakAsync(String) SpeakAsync(String) SpeakAsync(String) SpeakAsync(String)

De forma asincrónica habla el contenido de una cadena.Asynchronously speaks the contents of a string.

SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt)

Cancela la operación asincrónica de síntesis para un mensaje en cola.Cancels the asynchronous synthesis operation for a queued prompt.

SpeakAsyncCancelAll() SpeakAsyncCancelAll() SpeakAsyncCancelAll() SpeakAsyncCancelAll()

Cancela todas las operaciones de síntesis de voz asincrónicas que hay en cola.Cancels all queued, asynchronous, speech synthesis operations.

SpeakSsml(String) SpeakSsml(String) SpeakSsml(String) SpeakSsml(String)

De forma sincrónica habla un String que contiene el marcado SSML.Synchronously speaks a String that contains SSML markup.

SpeakSsmlAsync(String) SpeakSsmlAsync(String) SpeakSsmlAsync(String) SpeakSsmlAsync(String)

De forma asincrónica habla un String que contiene el marcado SSML.Asynchronously speaks a String that contains SSML markup.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Eventos

BookmarkReached BookmarkReached BookmarkReached BookmarkReached

Se genera cuando SpeechSynthesizer encuentra un marcador en un mensaje.Raised when the SpeechSynthesizer encounters a bookmark in a prompt.

PhonemeReached PhonemeReached PhonemeReached PhonemeReached

Se genera cuando se alcanza un fonema.Raised when a phoneme is reached.

SpeakCompleted SpeakCompleted SpeakCompleted SpeakCompleted

Se genera cuando SpeechSynthesizer termina de leer un mensaje.Raised when the SpeechSynthesizer completes the speaking of a prompt.

SpeakProgress SpeakProgress SpeakProgress SpeakProgress

Se genera después de que SpeechSynthesizer hable cada palabra concreta de un mensaje.Raised after the SpeechSynthesizer speaks each individual word of a prompt.

SpeakStarted SpeakStarted SpeakStarted SpeakStarted

Se genera cuando SpeechSynthesizer comienza a leer un mensaje.Raised when the SpeechSynthesizer begins the speaking of a prompt.

StateChanged StateChanged StateChanged StateChanged

Se genera cuando cambia el estado de SpeechSynthesizer.Raised when the state of the SpeechSynthesizer changes.

VisemeReached VisemeReached VisemeReached VisemeReached

Se genera cuando se alcanza un visema.Raised when a viseme is reached.

VoiceChange VoiceChange VoiceChange VoiceChange

Se genera cuando cambia la voz de SpeechSynthesizer.Raised when the voice of the SpeechSynthesizer changes.

Se aplica a

Consulte también: