Compartir vía


SpeechSynthesizer Clase

Definición

Proporciona acceso a la funcionalidad de un motor de síntesis de voz instalado.

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

Ejemplos

El ejemplo siguiente forma parte de una aplicación de consola que inicializa un SpeechSynthesizer objeto y habla una cadena.

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

Al crear un nuevo SpeechSynthesizer objeto, usa la voz predeterminada del sistema. Para configurar para SpeechSynthesizer usar una de las voces de síntesis de voz instaladas (texto a voz), use el SelectVoice método o SelectVoiceByHints . Para obtener información sobre las voces instaladas, use el GetInstalledVoices método y la VoiceInfo clase .

Esta clase también proporciona control sobre los siguientes aspectos de la síntesis de voz:

SpeechSynthesizer genera eventos cuando encuentra ciertas características en avisos: (BookmarkReached, PhonemeReached, VisemeReachedy SpeakProgress). También genera eventos que informan sobre el inicio () y el final (SpeakStartedSpeakCompleted) de las operaciones de habla y sobre el cambio de la voz de habla (VoiceChange).

Nota:

Realice siempre una llamada a Dispose antes de liberar la última referencia al objeto 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.

Constructores

SpeechSynthesizer()

Inicializa una nueva instancia de la clase SpeechSynthesizer.

Propiedades

Rate

Obtiene o establece la velocidad de habla del objeto SpeechSynthesizer.

State

Obtiene el estado de habla actual del objeto SpeechSynthesizer.

Voice

Obtiene información acerca de la voz actual del objeto SpeechSynthesizer.

Volume

Obtiene o establece el volumen de salida del objeto SpeechSynthesizer.

Métodos

AddLexicon(Uri, String)

Agrega un léxico al objeto SpeechSynthesizer.

Dispose()

Desecha el objeto SpeechSynthesizer y libera los recursos utilizados durante la sesión.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
Finalize()

Actúa como medida de seguridad para limpiar los recursos en caso de que no se llame al método Dispose().

GetCurrentlySpokenPrompt()

Obtiene el marcador del que SpeechSynthesizer está hablando.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetInstalledVoices()

Devuelve todas las voces de síntesis de voz (texto a voz) instaladas.

GetInstalledVoices(CultureInfo)

Devuelve todas las voces instaladas de síntesis de voz (texto a voz) que admiten una configuración regional específica.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
Pause()

Hace una pausa en el objeto SpeechSynthesizer.

RemoveLexicon(Uri)

Quita un léxico del objeto SpeechSynthesizer.

Resume()

Reanuda el objeto de SpeechSynthesizer después de haberse pausado.

SelectVoice(String)

Selecciona una voz concreta por nombre.

SelectVoiceByHints(VoiceGender)

Selecciona una voz con un género concreto.

SelectVoiceByHints(VoiceGender, VoiceAge)

Selecciona una voz con un género y edad específicos.

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.

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.

SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

Configura el objeto SpeechSynthesizer para anexar el resultado a una secuencia de audio.

SetOutputToDefaultAudioDevice()

Configura el objeto SpeechSynthesizer para enviar la salida al dispositivo de audio predeterminado.

SetOutputToNull()

Configura el objeto SpeechSynthesizer para no enviar los resultados de las operaciones de síntesis a un dispositivo, un archivo o un flujo.

SetOutputToWaveFile(String)

Configura el objeto SpeechSynthesizer para anexar la salida a un archivo que contiene audio de formato de forma de onda.

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.

SetOutputToWaveStream(Stream)

Configura el objeto SpeechSynthesizer para anexar la salida a un flujo que contiene audio de formato de forma de onda.

Speak(Prompt)

De forma sincrónica habla el contenido de un objeto Prompt.

Speak(PromptBuilder)

De forma sincrónica habla el contenido de un objeto PromptBuilder.

Speak(String)

De forma sincrónica habla el contenido de una cadena.

SpeakAsync(Prompt)

De forma asincrónica habla el contenido de un objeto Prompt.

SpeakAsync(PromptBuilder)

De forma asincrónica habla el contenido de un objeto PromptBuilder.

SpeakAsync(String)

De forma asincrónica habla el contenido de una cadena.

SpeakAsyncCancel(Prompt)

Cancela la operación asincrónica de síntesis para un mensaje en cola.

SpeakAsyncCancelAll()

Cancela todas las operaciones de síntesis de voz asincrónicas que hay en cola.

SpeakSsml(String)

De forma sincrónica habla un String que contiene el marcado SSML.

SpeakSsmlAsync(String)

De forma asincrónica habla un String que contiene el marcado SSML.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Eventos

BookmarkReached

Se genera cuando SpeechSynthesizer encuentra un marcador en un mensaje.

PhonemeReached

Se genera cuando se alcanza un fonema.

SpeakCompleted

Se genera cuando SpeechSynthesizer termina de leer un mensaje.

SpeakProgress

Se genera después de que SpeechSynthesizer hable cada palabra concreta de un mensaje.

SpeakStarted

Se genera cuando SpeechSynthesizer comienza a leer un mensaje.

StateChanged

Se genera cuando cambia el estado de SpeechSynthesizer.

VisemeReached

Se genera cuando se alcanza un visema.

VoiceChange

Se genera cuando cambia la voz de SpeechSynthesizer.

Se aplica a

Consulte también