SpeechSynthesizer Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece acesso à funcionalidade de um mecanismo de síntese de fala instalado.
public ref class SpeechSynthesizer sealed : IDisposablepublic sealed class SpeechSynthesizer : IDisposabletype SpeechSynthesizer = class
interface IDisposablePublic NotInheritable Class SpeechSynthesizer
Implements IDisposable- Herança
-
SpeechSynthesizer
- Implementações
Exemplos
O exemplo a seguir faz parte de um aplicativo de console que inicializa um SpeechSynthesizer objeto e fala uma cadeia de caracteres.
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();
}
}
}
Comentários
Quando você cria um novo SpeechSynthesizer objeto, ele usa a voz do sistema padrão. Para configurar a SpeechSynthesizer síntese de fala instalada (conversão de texto em fala), use o SelectVoice método ou SelectVoiceByHints a síntese de fala instalada. Para obter informações sobre quais vozes estão instaladas, use o GetInstalledVoices método e a VoiceInfo classe.
Essa classe também fornece controle sobre os seguintes aspectos da síntese de fala:
Para configurar a saída para o SpeechSynthesizer objeto, use os SetOutputToAudioStreammétodos , e ,SetOutputToWaveFileSetOutputToDefaultAudioDeviceSetOutputToNull
Para gerar fala, use o Speakmétodo , SpeakAsync, SpeakSsmlou SpeakSsmlAsync . Pode SpeechSynthesizer produzir fala a partir de texto, um Prompt objeto ou PromptBuilder de SSML (Speech Synthesis Markup Language) versão 1.0.
Para pausar e retomar a síntese de fala, use os métodos e Resume os Pause métodos.
Para adicionar ou remover léxicos, use os métodos e RemoveLexicon os AddLexicon métodos. Pode SpeechSynthesizer usar um ou mais léxicos para orientar sua pronúncia de palavras.
Para modificar a entrega da saída de fala, use as propriedades e Volume as Rate propriedades.
O SpeechSynthesizer gera eventos quando encontra determinados recursos em prompts: (BookmarkReached, , PhonemeReachedVisemeReachede SpeakProgress). Também gera eventos que relatam sobre o início (SpeakStarted) e o fim (SpeakCompleted) das operações de fala e sobre a alteração da voz falante (VoiceChange).
Observação
Sempre chame Dispose antes de lançar sua última referência para o SpeechSynthesizer. Caso contrário, os recursos que ele está usando não serão liberados até que o coletor de lixo chame o SpeechSynthesizer método do Finalize objeto.
Construtores
| Nome | Description |
|---|---|
| SpeechSynthesizer() |
Inicializa uma nova instância da classe SpeechSynthesizer. |
Propriedades
| Nome | Description |
|---|---|
| Rate |
Obtém ou define a taxa de fala do SpeechSynthesizer objeto. |
| State |
Obtém o estado atual de fala do SpeechSynthesizer objeto. |
| Voice |
Obtém informações sobre a voz atual do SpeechSynthesizer objeto. |
| Volume |
Obter ou definir o volume de saída do SpeechSynthesizer objeto. |
Métodos
| Nome | Description |
|---|---|
| AddLexicon(Uri, String) |
Adiciona um léxico ao SpeechSynthesizer objeto. |
| Dispose() |
Descarta o SpeechSynthesizer objeto e libera os recursos usados durante a sessão. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Finalize() |
Atua como uma proteção para limpar os recursos caso o Dispose() método não seja chamado. |
| GetCurrentlySpokenPrompt() |
Obtém o aviso de que o SpeechSynthesizer está falando. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetInstalledVoices() |
Retorna todas as vozes instaladas de síntese de fala (texto em fala). |
| GetInstalledVoices(CultureInfo) |
Retorna todas as vozes instaladas de síntese de fala (conversão de texto em fala) que dão suporte a uma localidade específica. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| Pause() |
Pausa o SpeechSynthesizer objeto. |
| RemoveLexicon(Uri) |
Remove um léxico do SpeechSynthesizer objeto. |
| Resume() |
Retoma o SpeechSynthesizer objeto depois que ele é pausado. |
| SelectVoice(String) |
Seleciona uma voz específica por nome. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Seleciona uma voz com um gênero, idade e localidade específicos, com base na posição em que as vozes são ordenadas. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Seleciona uma voz com um gênero e uma idade específicos, com base na posição em que as vozes são ordenadas. |
| SelectVoiceByHints(VoiceGender, VoiceAge) |
Seleciona uma voz com um gênero e uma idade específicos. |
| SelectVoiceByHints(VoiceGender) |
Seleciona uma voz com um gênero específico. |
| SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Configura o SpeechSynthesizer objeto para acrescentar a saída a um fluxo de áudio. |
| SetOutputToDefaultAudioDevice() |
Configura o SpeechSynthesizer objeto para enviar a saída para o dispositivo de áudio padrão. |
| SetOutputToNull() |
Configura o SpeechSynthesizer objeto para não enviar saída de operações de síntese para um dispositivo, arquivo ou fluxo. |
| SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
Configura o SpeechSynthesizer objeto para acrescentar a saída a um arquivo de formato de áudio Waveform em um formato especificado. |
| SetOutputToWaveFile(String) |
Configura o SpeechSynthesizer objeto para acrescentar a saída a um arquivo que contém áudio de formato Waveform. |
| SetOutputToWaveStream(Stream) |
Configura o SpeechSynthesizer objeto para acrescentar a saída a um fluxo que contém áudio de formato waveform. |
| Speak(Prompt) |
Fala de forma síncrona o conteúdo de um Prompt objeto. |
| Speak(PromptBuilder) |
Fala de forma síncrona o conteúdo de um PromptBuilder objeto. |
| Speak(String) |
Fala de forma síncrona o conteúdo de uma cadeia de caracteres. |
| SpeakAsync(Prompt) |
Fala de forma assíncrona o conteúdo de um Prompt objeto. |
| SpeakAsync(PromptBuilder) |
Fala de forma assíncrona o conteúdo de um PromptBuilder objeto. |
| SpeakAsync(String) |
Fala de forma assíncrona o conteúdo de uma cadeia de caracteres. |
| SpeakAsyncCancel(Prompt) |
Cancela a operação de síntese assíncrona para um prompt na fila. |
| SpeakAsyncCancelAll() |
Cancela todas as operações de síntese de fala enfileiradas, assíncronas. |
| SpeakSsml(String) |
Fala de forma síncrona um String que contém marcação SSML. |
| SpeakSsmlAsync(String) |
Fala de forma assíncrona um String que contém marcação SSML. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
Eventos
| Nome | Description |
|---|---|
| BookmarkReached |
Gerado quando o SpeechSynthesizer indicador encontra um indicador em um prompt. |
| PhonemeReached |
Gerado quando um nome de telefone é atingido. |
| SpeakCompleted |
Gerado quando a SpeechSynthesizer fala de um prompt é concluída. |
| SpeakProgress |
Gerado após o SpeechSynthesizer fale cada palavra individual de um prompt. |
| SpeakStarted |
Gerado quando começa SpeechSynthesizer a falar de um prompt. |
| StateChanged |
Gerado quando o estado das SpeechSynthesizer alterações é alterado. |
| VisemeReached |
Gerado quando um viseme é atingido. |
| VoiceChange |
Gerado quando a voz das SpeechSynthesizer alterações é alterada. |
