Compartilhar via


SpeechSynthesizer Classe

Definição

Fornece acesso à funcionalidade de um mecanismo de síntese de fala instalado.

public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
    interface IDisposable
Public 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 o SpeechSynthesizer para usar uma das vozes de síntese de fala (conversão de texto em fala) instaladas, use o SelectVoice método ou SelectVoiceByHints . 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:

O SpeechSynthesizer gera eventos quando encontra determinados recursos em prompts: (BookmarkReached, PhonemeReached, VisemeReachede SpeakProgress). Ele 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 de fala (VoiceChange).

Observação

Sempre chame Dispose antes de liberar sua última referência ao 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

SpeechSynthesizer()

Inicializa uma nova instância da classe SpeechSynthesizer.

Propriedades

Rate

Obtém ou define a taxa de fala do objeto SpeechSynthesizer.

State

Obtém o estado de atual de fala do objeto SpeechSynthesizer.

Voice

Obtém informações sobre a voz atual do objeto SpeechSynthesizer.

Volume

Obtém ou define o volume de saída do objeto SpeechSynthesizer.

Métodos

AddLexicon(Uri, String)

Adiciona um léxico ao objeto SpeechSynthesizer.

Dispose()

Descarta o objeto SpeechSynthesizer 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 no caso em que o método Dispose() não é chamado.

GetCurrentlySpokenPrompt()

Obtém o prompt de que o SpeechSynthesizer está falando.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetInstalledVoices()

Retorna todas as vozes de síntese (conversão de texto em fala) de fala instalados.

GetInstalledVoices(CultureInfo)

Retorna todas as vozes de síntese de fala (conversão de texto em fala) instaladas 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 Object atual.

(Herdado de Object)
Pause()

Pausa o objeto SpeechSynthesizer.

RemoveLexicon(Uri)

Remove um léxico do objeto SpeechSynthesizer.

Resume()

Retoma o objeto SpeechSynthesizer depois que ele está em pausa.

SelectVoice(String)

Seleciona uma voz específica por nome.

SelectVoiceByHints(VoiceGender)

Seleciona uma voz com um gênero específico.

SelectVoiceByHints(VoiceGender, VoiceAge)

Seleciona uma voz com um gênero e uma idade específicos.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32)

Seleciona uma voz com um sexo e idade específicos, com base na posição na qual as vozes são ordenadas.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)

Seleciona uma voz com um sexo, idade e localidade específicos, com base na posição na qual as vozes são ordenadas.

SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

Configura o objeto SpeechSynthesizer para acrescentar a saída a um fluxo de áudio.

SetOutputToDefaultAudioDevice()

Configura o objeto SpeechSynthesizer para enviar a saída para o dispositivo de áudio padrão.

SetOutputToNull()

Configura o objeto SpeechSynthesizer para não enviar a saída de operações de síntese para um dispositivo, arquivo ou fluxo.

SetOutputToWaveFile(String)

Configura o objeto SpeechSynthesizer para acrescentar a saída a um arquivo que contém o áudio do formato Waveform.

SetOutputToWaveFile(String, SpeechAudioFormatInfo)

Configura o objeto SpeechSynthesizer para acrescentar a saída a um arquivo de formato de áudio de forma de onda em um formato especificado.

SetOutputToWaveStream(Stream)

Configura o objeto SpeechSynthesizer para acrescentar a saída a um fluxo que contém o áudio em formato de forma de onda.

Speak(Prompt)

Fala assincronamente o conteúdo de um objeto Prompt.

Speak(PromptBuilder)

Fala assincronamente o conteúdo de um objeto PromptBuilder.

Speak(String)

Fala assincronamente o conteúdo de uma cadeia de caracteres.

SpeakAsync(Prompt)

Fala o conteúdo de um objeto Prompt de forma assíncrona.

SpeakAsync(PromptBuilder)

Fala o conteúdo de um objeto PromptBuilder de forma assíncrona.

SpeakAsync(String)

Fala assincronamente o conteúdo de uma cadeia de caracteres.

SpeakAsyncCancel(Prompt)

Cancela a operação de síntese assíncrona de um prompt na fila.

SpeakAsyncCancelAll()

Cancela todas as operações na fila, assíncronas e de sintetização de voz.

SpeakSsml(String)

Fala de forma síncrona uma String que contém marcação SSML.

SpeakSsmlAsync(String)

Fala de forma síncrona uma String que contém marcação SSML.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

BookmarkReached

Acionado quando o SpeechSynthesizer encontra um indicador em um prompt.

PhonemeReached

Acionado quando um fonema é alcançado.

SpeakCompleted

Gerado quando o SpeechSynthesizer conclui a fala com base em um prompt.

SpeakProgress

Gerado depois que SpeechSynthesizer fala cada palavra individual de um prompt.

SpeakStarted

Gerado quando o SpeechSynthesizer começa a falar com base em um prompt.

StateChanged

Gerado quando o estado do SpeechSynthesizer é alterado.

VisemeReached

Acionado quando um visema é alcançado.

VoiceChange

Acionado quando a voz do SpeechSynthesizer é alterada.

Aplica-se a

Confira também