SpeechSynthesizer Clase

Definición

Espacio de nombres:

System.Speech.Synthesis

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v9.0.0-preview.3.24172.9

Source:

SpeechSynthesizer.cs

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

Object

SpeechSynthesizer

Implementaciones

IDisposable

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:

• Para configurar la salida del SpeechSynthesizer objeto, use los SetOutputToAudioStreammétodos , SetOutputToDefaultAudioDevice, SetOutputToNully SetOutputToWaveFile .

• Para generar voz, use el Speakmétodo , SpeakSsmlSpeakAsync, o SpeakSsmlAsync . SpeechSynthesizer puede generar voz a partir de texto, un Prompt objeto o PromptBuilder desde lenguaje de marcado de síntesis de voz (SSML) versión 1.0.

• Para pausar y reanudar la síntesis de voz, use los Pause métodos y Resume .

• Para agregar o quitar léxico, use los AddLexicon métodos y RemoveLexicon . SpeechSynthesizer puede usar uno o más léxicos para guiar su pronunciación de palabras.

• Para modificar la entrega de la salida de voz, use las Rate propiedades y Volume .

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.

Consulte también

• InstalledVoice
• Prompt
• PromptBuilder
• Síntesis de voz