SpeechSynthesizer.Speak Méthode

Définition

Génère une sortie vocale de façon synchrone à partir d'une chaîne, un objet de Prompt , ou un objet de PromptBuilder.

Surcharges

Speak(Prompt)

Énonce de façon synchrone le contenu d'un objet Prompt.

Speak(PromptBuilder)

Énonce de façon synchrone le contenu d'un objet PromptBuilder.

Speak(String)

Énonce de façon synchrone le contenu d'une chaîne.

Remarques

Les Speak méthodes génèrent la parole de façon synchrone. Les méthodes ne retournent pas tant que le contenu de la Speak instance n’a pas été complètement prononcé. Il s’agit de la façon la plus simple de générer des paroles. Toutefois, si votre application doit effectuer des tâches tout en parlant, par exemple mettre en surbrillance du texte, une animation de peinture, des contrôles de surveillance ou d’autres tâches, utilisez les SpeakAsync méthodes ou la SpeakSsmlAsync méthode pour générer de la voix de manière asynchrone.

Lors d’un appel à cette méthode, peut SpeechSynthesizer déclencher les événements suivants :

  • StateChanged. Déclenché lorsque l’état de parole du synthétiseur change.

  • SpeakStarted. Déclenché lorsque le synthétiseur commence à générer de la parole.

  • PhonemeReached. Déclenché chaque fois que le synthétiseur atteint une lettre ou une combinaison de lettres qui constituent un son discret de la parole dans une langue.

  • SpeakProgress. Déclenché chaque fois que le synthétiseur termine de parler un mot.

  • VisemeReached. Déclenché chaque fois que la sortie orale nécessite un changement de position de la bouche ou des muscles faciaux utilisés pour produire la parole.

  • BookmarkReached. Déclenché lorsque le synthétiseur rencontre un signet dans une invite.

  • VoiceChange. Déclenché lorsque la voix orale pour le synthétiseur change.

le SpeechSynthesizer ne déclenche pas l’événement SpeakCompleted lors du traitement de l’une Speak des méthodes.

Speak(Prompt)

Source:
SpeechSynthesizer.cs
Source:
SpeechSynthesizer.cs
Source:
SpeechSynthesizer.cs

Énonce de façon synchrone le contenu d'un objet Prompt.

public:
 void Speak(System::Speech::Synthesis::Prompt ^ prompt);
public void Speak (System.Speech.Synthesis.Prompt prompt);
member this.Speak : System.Speech.Synthesis.Prompt -> unit
Public Sub Speak (prompt As Prompt)

Paramètres

prompt
Prompt

Contenu à lire.

Exemples

L’exemple suivant crée un Prompt objet à partir d’une chaîne et transmet l’objet en tant qu’argument à la Speak méthode .

using System;
using System.Speech.Synthesis;

namespace SampleSynthesis
{
  class Program
  {
    static void Main(string[] args)
    {

      // Initialize a new instance of the SpeechSynthesizer.
      using (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 synchronously.
        synth.Speak(color);
      }

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

Remarques

Pour parler de manière asynchrone du contenu d’un Prompt objet, utilisez SpeakAsync.

S’applique à

Speak(PromptBuilder)

Source:
SpeechSynthesizer.cs
Source:
SpeechSynthesizer.cs
Source:
SpeechSynthesizer.cs

Énonce de façon synchrone le contenu d'un objet PromptBuilder.

public:
 void Speak(System::Speech::Synthesis::PromptBuilder ^ promptBuilder);
public void Speak (System.Speech.Synthesis.PromptBuilder promptBuilder);
member this.Speak : System.Speech.Synthesis.PromptBuilder -> unit
Public Sub Speak (promptBuilder As PromptBuilder)

Paramètres

promptBuilder
PromptBuilder

Contenu à lire.

Exemples

L’exemple suivant crée un PromptBuilder objet à partir d’une chaîne et transmet l’objet en tant qu’argument à la Speak méthode .

using System;
using System.Speech.Synthesis;

namespace SampleSynthesis
{
  class Program
  {
    static void Main(string[] args)
    {

      // Initialize a new instance of the SpeechSynthesizer.
      using (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 synchronously.
        synth.Speak(song);
      }

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

Remarques

Pour parler de manière asynchrone du contenu d’un PromptBuilder objet, utilisez SpeakAsync.

S’applique à

Speak(String)

Source:
SpeechSynthesizer.cs
Source:
SpeechSynthesizer.cs
Source:
SpeechSynthesizer.cs

Énonce de façon synchrone le contenu d'une chaîne.

public:
 void Speak(System::String ^ textToSpeak);
public void Speak (string textToSpeak);
member this.Speak : string -> unit
Public Sub Speak (textToSpeak As String)

Paramètres

textToSpeak
String

Texte à lire.

Exemples

Comme indiqué dans l’exemple suivant, la Speak méthode fournit le moyen le plus simple de générer une sortie vocale de manière synchrone.

using System;
using System.Speech.Synthesis;

namespace SampleSynthesis
{
  class Program
  {
    static void Main(string[] args)
    {

      // Initialize a new instance of the SpeechSynthesizer.
      using (SpeechSynthesizer synth = new SpeechSynthesizer())
      {

        // Configure the audio output.
        synth.SetOutputToDefaultAudioDevice();

        // Speak a string synchronously.
        synth.Speak("What is your favorite color?");
      }

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

Remarques

Pour parler de manière synchrone d’une chaîne qui contient le balisage SSML, utilisez la SpeakSsml méthode . Pour parler de manière asynchrone du contenu d’une chaîne, utilisez la SpeakAsync méthode .

S’applique à