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
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. |
