SpeechSynthesizer Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona acceso a la funcionalidad de un motor de síntesis de voz instalado.
public ref class SpeechSynthesizer sealed : IDisposablepublic sealed class SpeechSynthesizer : IDisposabletype SpeechSynthesizer = class
interface IDisposablePublic 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
Cuando se crea un nuevo SpeechSynthesizer objeto, se usa la voz del sistema predeterminada. Para configurar para SpeechSynthesizer usar una de las voces instaladas de síntesis de voz (texto a voz), use el SelectVoice método o SelectVoiceByHints . Para obtener información sobre qué voces se instalan, 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 , SpeakAsync, SpeakSsmlo 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éxicos, use los AddLexicon métodos y RemoveLexicon . SpeechSynthesizer puede usar uno o varios 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 determinadas 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:
Dispose Llame siempre antes de liberar la última referencia a .SpeechSynthesizer De lo contrario, los recursos que usa no se liberarán hasta que el recolector de elementos no utilizados llame al SpeechSynthesizer método del Finalize objeto.
Constructores
| Nombre | Description |
|---|---|
| SpeechSynthesizer() |
Inicializa una nueva instancia de la clase SpeechSynthesizer. |
Propiedades
| Nombre | Description |
|---|---|
| Rate |
Obtiene o establece la velocidad de habla del SpeechSynthesizer objeto. |
| State |
Obtiene el estado de habla actual del SpeechSynthesizer objeto . |
| Voice |
Obtiene información sobre la voz actual del SpeechSynthesizer objeto . |
| Volume |
Obtiene o establece el volumen de salida del SpeechSynthesizer objeto. |
Métodos
| Nombre | Description |
|---|---|
| AddLexicon(Uri, String) |
Agrega un léxico al SpeechSynthesizer objeto . |
| Dispose() |
Elimina el SpeechSynthesizer objeto y libera los recursos usados durante la sesión. |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| Finalize() |
Actúa como protección para limpiar los recursos en caso de que no se llame al Dispose() método . |
| GetCurrentlySpokenPrompt() |
Obtiene el símbolo del sistema que SpeechSynthesizer habla. |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| GetInstalledVoices() |
Devuelve todas las voces instaladas de síntesis de voz (texto a voz). |
| 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 Objectactual. (Heredado de Object) |
| Pause() |
Pausa el SpeechSynthesizer objeto . |
| RemoveLexicon(Uri) |
Quita un léxico del SpeechSynthesizer objeto . |
| Resume() |
Reanuda el SpeechSynthesizer objeto después de que se haya pausado. |
| SelectVoice(String) |
Selecciona una voz específica por nombre. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Selecciona una voz con un sexo, una edad y una configuración regional específicos, en función de la posición en la que se ordenan las voces. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Selecciona una voz con un sexo y una edad específicos, en función de la posición en la que se ordenan las voces. |
| SelectVoiceByHints(VoiceGender, VoiceAge) |
Selecciona una voz con un sexo y una edad específicos. |
| SelectVoiceByHints(VoiceGender) |
Selecciona una voz con un género específico. |
| SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Configura el SpeechSynthesizer objeto para anexar la salida a una secuencia de audio. |
| SetOutputToDefaultAudioDevice() |
Configura el SpeechSynthesizer objeto para enviar la salida al dispositivo de audio predeterminado. |
| SetOutputToNull() |
Configura el SpeechSynthesizer objeto para que no envíe resultados de operaciones de síntesis a un dispositivo, archivo o secuencia. |
| SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
Configura el SpeechSynthesizer objeto para anexar la salida a un archivo de formato de audio waveform en un formato especificado. |
| SetOutputToWaveFile(String) |
Configura el SpeechSynthesizer objeto para anexar la salida a un archivo que contiene audio de formato waveform. |
| SetOutputToWaveStream(Stream) |
Configura el SpeechSynthesizer objeto para anexar la salida a una secuencia que contiene audio de formato waveform. |
| Speak(Prompt) |
Habla sincrónicamente el contenido de un Prompt objeto . |
| Speak(PromptBuilder) |
Habla sincrónicamente el contenido de un PromptBuilder objeto . |
| Speak(String) |
Habla sincrónicamente el contenido de una cadena. |
| SpeakAsync(Prompt) |
Habla asincrónicamente el contenido de un Prompt objeto. |
| SpeakAsync(PromptBuilder) |
Habla asincrónicamente el contenido de un PromptBuilder objeto. |
| SpeakAsync(String) |
Habla asincrónicamente el contenido de una cadena. |
| SpeakAsyncCancel(Prompt) |
Cancela la operación de síntesis asincrónica para un mensaje en cola. |
| SpeakAsyncCancelAll() |
Cancela todas las operaciones de síntesis de voz en cola, asincrónicas. |
| SpeakSsml(String) |
Habla sincrónicamente un String que contiene marcado SSML. |
| SpeakSsmlAsync(String) |
Habla asincrónicamente un String que contiene marcado SSML. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Eventos
| Nombre | Description |
|---|---|
| BookmarkReached |
Se genera cuando SpeechSynthesizer encuentra un marcador en un símbolo del sistema. |
| PhonemeReached |
Se genera cuando se alcanza un phoneme. |
| SpeakCompleted |
Se genera cuando SpeechSynthesizer finaliza la conversación de un mensaje. |
| SpeakProgress |
Se genera después SpeechSynthesizer de que hable cada palabra individual de un mensaje. |
| SpeakStarted |
Se genera cuando SpeechSynthesizer comienza la conversación de un mensaje. |
| StateChanged |
Se genera cuando cambia el estado de los SpeechSynthesizer cambios. |
| VisemeReached |
Se genera cuando se alcanza un visema. |
| VoiceChange |
Se genera cuando cambia la voz de los SpeechSynthesizer cambios. |
