SpeechSynthesizer.SpeakAsync Método

Definição

Namespace:

System.Speech.Synthesis

Assembly:

System.Speech.dll

Pacote:

System.Speech v9.0.0-preview.3.24172.9

Gera a saída de fala de forma assíncrona de uma cadeia de caracteres, um objeto Prompt ou um objeto PromptBuilder.

Sobrecargas

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.

Comentários

Os SpeakAsync métodos geram fala de forma assíncrona. Os métodos retornam imediatamente sem esperar que o conteúdo do objeto termine de SpeakAsync falar. Use SpeakAsync se o aplicativo precisar executar tarefas durante a fala, por exemplo, realçar texto, animação de pintura, monitorar controles ou outras tarefas.

Durante uma chamada para esse método, o SpeechSynthesizer pode gerar os seguintes eventos:

• StateChanged. Gerado quando o estado de fala do sintetizador é alterado.

• SpeakStarted. Gerado quando o sintetizador começa a gerar fala.

• PhonemeReached. Gerado sempre que o sintetizador atinge uma letra ou combinação de letras que constituem um som discreto de fala em uma linguagem.

• SpeakProgress. Gerado sempre que o sintetizador conclui falando uma palavra.

• VisemeReached. Gerado sempre que a saída falada requer uma mudança na posição da boca ou nos músculos faciais usados para produzir fala.

• BookmarkReached. Gerado quando o sintetizador encontra um indicador em um prompt.

• VoiceChange. Gerado quando a voz de fala para o sintetizador é alterada.

• SpeakCompleted. Gerado quando o sintetizador conclui uma SpeakAsync operação.

Se o aplicativo não precisar executar tarefas durante a fala, você poderá usar os Speak métodos ou o SpeakSsml método para gerar fala de forma síncrona.

SpeakAsync(Prompt)

Origem:

SpeechSynthesizer.cs

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

public:
 void SpeakAsync(System::Speech::Synthesis::Prompt ^ prompt);

public void SpeakAsync (System.Speech.Synthesis.Prompt prompt);

member this.SpeakAsync : System.Speech.Synthesis.Prompt -> unit

Public Sub SpeakAsync (prompt As Prompt)

Parâmetros

prompt

Prompt

O conteúdo a ser falado.

Exemplos

O exemplo a seguir cria um Prompt objeto de uma cadeia de caracteres e passa o objeto como um argumento para o SpeakAsync método .

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

      // Create a prompt from a string.
      Prompt color = new Prompt("What is your favorite color?");

      // Speak the contents of the prompt asynchronously.
      synth.SpeakAsync(color);

      Console.WriteLine();
      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }
  }
}

Comentários

Você pode cancelar a fala assíncrona de um prompt com o SpeakAsyncCancel método ou SpeakAsyncCancelAll .

Para falar de forma síncrona o conteúdo de um Prompt objeto, use Speak.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Speak(Prompt).

SpeakAsync(PromptBuilder)

Origem:

SpeechSynthesizer.cs

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

public:
 System::Speech::Synthesis::Prompt ^ SpeakAsync(System::Speech::Synthesis::PromptBuilder ^ promptBuilder);

public System.Speech.Synthesis.Prompt SpeakAsync (System.Speech.Synthesis.PromptBuilder promptBuilder);

member this.SpeakAsync : System.Speech.Synthesis.PromptBuilder -> System.Speech.Synthesis.Prompt

Public Function SpeakAsync (promptBuilder As PromptBuilder) As Prompt

Parâmetros

promptBuilder

PromptBuilder

O conteúdo a ser falado.

Retornos

Prompt

O objeto que contém o conteúdo a ser falado.

Exemplos

O exemplo a seguir cria um PromptBuilder objeto de uma cadeia de caracteres e passa o objeto como um argumento para o SpeakAsync método .

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

      // Create a PromptBuilder object and append a text string.
      PromptBuilder song = new PromptBuilder();
      song.AppendText("Say the name of the song you want to hear");

      // Speak the contents of the prompt asynchronously.
      synth.SpeakAsync(song);

      Console.WriteLine();
      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }
  }
}

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Speak(PromptBuilder).

Comentários

Para falar de forma síncrona o conteúdo de um PromptBuilder objeto, use Speak.

SpeakAsync(String)

Origem:

SpeechSynthesizer.cs

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

public:
 System::Speech::Synthesis::Prompt ^ SpeakAsync(System::String ^ textToSpeak);

public System.Speech.Synthesis.Prompt SpeakAsync (string textToSpeak);

member this.SpeakAsync : string -> System.Speech.Synthesis.Prompt

Public Function SpeakAsync (textToSpeak As String) As Prompt

Parâmetros

textToSpeak

String

O texto para fala.

Retornos

Prompt

O objeto que contém o conteúdo a ser falado.

Exemplos

Conforme mostrado no exemplo a seguir, o SpeakAsync método fornece os meios mais simples para gerar saída de fala de forma assíncrona.

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 asynchronously.
      synth.SpeakAsync("What is your favorite color?");

      Console.WriteLine();
      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }
  }
}

Comentários

Para falar de forma assíncrona uma cadeia de caracteres que contém marcação SSML, use o SpeakSsmlAsync método . Para falar de forma síncrona o conteúdo de uma cadeia de caracteres, use o Speak método . Você pode cancelar a fala assíncrona de um prompt com o SpeakAsyncCancel método ou SpeakAsyncCancelAll .

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Speak(String).

Confira também

• Speak