SpeechSynthesizer Classe

Definição

Espaço de Nomes:
System.Speech.Synthesis
Assemblagem:
System.Speech.dll
Pacote:
System.Speech v11.0.0-preview.4.26230.115
Origem:
SpeechSynthesizer.cs
Origem:
SpeechSynthesizer.cs
Origem:
SpeechSynthesizer.cs
Origem:
SpeechSynthesizer.cs

Fornece acesso à funcionalidade de um motor de síntese 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
Herança
Object
SpeechSynthesizer
Implementações
IDisposable

Exemplos

O exemplo seguinte faz parte de uma aplicação de consola que inicializa um SpeechSynthesizer objeto e fala uma string.

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();
    }
  }
}

Observações

Quando crias um novo SpeechSynthesizer objeto, ele usa a voz padrão do sistema. Para configurar o SpeechSynthesizer uso de uma das vozes de síntese de voz (texto para fala) instaladas, use o SelectVoice método ou SelectVoiceByHints . Para obter informações sobre que vozes estão instaladas, use o GetInstalledVoices método e a VoiceInfo classe.

Esta classe também proporciona controlo sobre os seguintes aspetos da síntese de voz:

O SpeechSynthesizer evento surge quando encontra certas funcionalidades nos prompts: (BookmarkReached, PhonemeReached, VisemeReached, e SpeakProgress). Também levanta eventos que reportam o início (SpeakStarted) e o fim (SpeakCompleted) das operações de fala e a mudança da voz falada (VoiceChange).

Note

Ligue Dispose sempre antes de divulgar a sua última referência ao SpeechSynthesizer. Caso contrário, os recursos que está a usar não serão libertados até que o coletor de lixo chame o SpeechSynthesizer método do Finalize objeto.

Construtores

Name Description
SpeechSynthesizer()

Inicializa uma nova instância da SpeechSynthesizer classe.

Propriedades

Name Description
Rate

Obtém ou define a frequência 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

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

Métodos

Name Description
AddLexicon(Uri, String)

Adiciona um léxico ao SpeechSynthesizer objeto.
Dispose()

Elimina o SpeechSynthesizer objeto e liberta os recursos usados durante a sessão.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Finalize()

Funciona como uma salvaguarda para limpar recursos caso o Dispose() processo não seja necessário.
GetCurrentlySpokenPrompt()

Recebe o prompt de que está SpeechSynthesizer a falar.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetInstalledVoices()

Devolve todas as vozes de síntese de voz instaladas (texto para fala).
GetInstalledVoices(CultureInfo)

Devolve todas as vozes de síntese de voz instaladas (texto para fala) que suportam uma localização específica.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Pause()

Pausa o SpeechSynthesizer objeto.
RemoveLexicon(Uri)

Remove um léxico do SpeechSynthesizer objeto.
Resume()

Retoma o SpeechSynthesizer objeto depois de ter sido pausado.
SelectVoice(String)

Seleciona uma voz específica pelo nome.
SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)

Seleciona uma voz com um género, idade e local específicos, com base na posição em que as vozes estão ordenadas.
SelectVoiceByHints(VoiceGender, VoiceAge, Int32)

Seleciona uma voz com um género e idade específicos, com base na posição em que as vozes estão ordenadas.
SelectVoiceByHints(VoiceGender, VoiceAge)

Seleciona uma voz com um género e idade específicos.
SelectVoiceByHints(VoiceGender)

Seleciona uma voz com um género específico.
SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

Configura o SpeechSynthesizer objeto para adicionar saída a um fluxo de áudio.
SetOutputToDefaultAudioDevice()

Configura o SpeechSynthesizer objeto para enviar saída para o dispositivo de áudio predefinido.
SetOutputToNull()

Configura o SpeechSynthesizer objeto para não enviar saída das operações de síntese para um dispositivo, ficheiro ou fluxo.
SetOutputToWaveFile(String, SpeechAudioFormatInfo)

Configura o SpeechSynthesizer objeto para adicionar saída a um ficheiro de formato de áudio de forma de onda num formato especificado.
SetOutputToWaveFile(String)

Configura o SpeechSynthesizer objeto para adicionar saída a um ficheiro que contenha áudio em formato de forma de onda.
SetOutputToWaveStream(Stream)

Configura o SpeechSynthesizer objeto para adicionar saída a um fluxo que contenha áudio em formato de forma de onda.
Speak(Prompt)

Fala sincronizadamente o conteúdo de um Prompt objeto.
Speak(PromptBuilder)

Fala sincronizadamente o conteúdo de um PromptBuilder objeto.
Speak(String)

Fala de forma síncrona o conteúdo de uma corda.
SpeakAsync(Prompt)

Fala assíncronamente o conteúdo de um Prompt objeto.
SpeakAsync(PromptBuilder)

Fala assíncronamente o conteúdo de um PromptBuilder objeto.
SpeakAsync(String)

Fala assíncronamente o conteúdo de uma cadeia.
SpeakAsyncCancel(Prompt)

Cancela a operação de síntese assíncrona para um prompt em fila.
SpeakAsyncCancelAll()

Cancela todas as operações de síntese de voz em fila, assíncronas.
SpeakSsml(String)

Sincronizadamente fala um String que contém marcação SSML.
SpeakSsmlAsync(String)

Assíncronamente fala um String que contém marcação SSML.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
BookmarkReached

Aparece quando encontra SpeechSynthesizer um marcador num prompt.
PhonemeReached

Levanta-se quando se alcança um fonema.
SpeakCompleted

Eleva-se quando termina SpeechSynthesizer de falar de um prompt.
SpeakProgress

Eleva-se depois de SpeechSynthesizer pronunciar cada palavra individual de um prompt.
SpeakStarted

Eleva-se quando começa SpeechSynthesizer a falar de um estímulo.
StateChanged

Levantado quando o estado das SpeechSynthesizer alterações é relevante.
VisemeReached

Eleva-se quando se atinge um visema.
VoiceChange

Ergueu-se quando a voz muda SpeechSynthesizer .

Aplica-se a

Ver também