SpeechSynthesizer.Speak Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Génère une sortie vocale de manière synchrone à partir d’une chaîne, d’un Prompt objet ou d’un PromptBuilder objet.
Surcharges
| Nom | Description |
|---|---|
| Speak(Prompt) |
Parle de façon synchrone le contenu d’un Prompt objet. |
| Speak(PromptBuilder) |
Parle de façon synchrone le contenu d’un PromptBuilder objet. |
| Speak(String) |
Parle de façon synchrone le contenu d’une chaîne. |
Remarques
Les Speak méthodes génèrent la parole de manière synchrone. Les méthodes ne retournent pas tant que le contenu de l’instance Speak n’a pas été complètement prononcé. Il s’agit du moyen le plus simple de générer la parole. Toutefois, si votre application doit effectuer des tâches en parlant, par exemple mettre en surbrillance le texte, l’animation de peinture, les contrôles de surveillance ou d’autres tâches, utilisez les SpeakAsync méthodes ou la SpeakSsmlAsync méthode pour générer la parole de manière asynchrone.
Pendant un appel à cette méthode, l’événement SpeechSynthesizer peut 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 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 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 parlée nécessite un changement de position de la bouche ou des muscles du visage 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 parlante pour le synthétiseur change.
Le SpeechSynthesizer n’déclenche pas l’événement SpeakCompleted lors du traitement des Speak méthodes.
Speak(Prompt)
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
Parle de façon synchrone le contenu d’un Prompt objet.
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 à parler.
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 le contenu d’un Prompt objet, utilisez SpeakAsync.
S’applique à
Speak(PromptBuilder)
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
Parle de façon synchrone le contenu d’un PromptBuilder objet.
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 à parler.
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 le contenu d’un PromptBuilder objet, utilisez SpeakAsync.
S’applique à
Speak(String)
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
- Source:
- SpeechSynthesizer.cs
Parle 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 à parler.
Exemples
Comme illustré dans l’exemple suivant, la Speak méthode fournit les moyens les plus simples de générer la 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 une chaîne qui contient le balisage SSML, utilisez la SpeakSsml méthode. Pour parler de manière asynchrone le contenu d’une chaîne, utilisez la SpeakAsync méthode.