SpeechSynthesizer Classe
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.
Fournit l’accès à la fonctionnalité d’un moteur de synthèse vocale installé.
public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
- Héritage
-
SpeechSynthesizer
- Implémente
Exemples
L’exemple suivant fait partie d’une application console qui initialise un SpeechSynthesizer objet et parle une chaîne.
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();
}
}
}
Remarques
Lorsque vous créez un SpeechSynthesizer objet, il utilise la voix système par défaut. Pour configurer pour SpeechSynthesizer utiliser l’une des voix de synthèse vocale installées (synthèse vocale), utilisez la SelectVoice méthode ou SelectVoiceByHints . Pour obtenir des informations sur les voix installées, utilisez la GetInstalledVoices méthode et la VoiceInfo classe .
Cette classe permet également de contrôler les aspects suivants de la synthèse vocale :
Pour configurer la sortie de l’objet SpeechSynthesizer , utilisez les SetOutputToAudioStreamméthodes , SetOutputToDefaultAudioDevice, SetOutputToNullet SetOutputToWaveFile .
Pour générer la parole, utilisez la Speakméthode , SpeakAsync, SpeakSsmlou SpeakSsmlAsync . Peut SpeechSynthesizer produire de la parole à partir de texte, d’un objet ou PromptBuilder d’un Prompt objet ou de SSML (Speech Synthesis Markup Language) version 1.0.
Pour suspendre et reprendre la synthèse vocale, utilisez les Pause méthodes et Resume .
Pour ajouter ou supprimer des lexiques, utilisez les AddLexicon méthodes et RemoveLexicon . Le SpeechSynthesizer peut utiliser une ou plusieurs lexiques pour guider sa prononciation de mots.
Pour modifier la remise de la sortie vocale, utilisez les Rate propriétés et Volume .
Le SpeechSynthesizer déclenche des événements lorsqu’il rencontre certaines fonctionnalités dans les invites : (BookmarkReached, PhonemeReached, VisemeReachedet SpeakProgress). Il soulève également des événements qui signalent le début (SpeakStarted) et la fin (SpeakCompleted) des opérations de parler et le changement de la voix orale (VoiceChange).
Notes
Appelez toujours Dispose avant de libérer votre dernière référence à SpeechSynthesizer. Sinon, les ressources utilisées ne seront pas libérées tant que le garbage collector n'aura pas appelé la méthode SpeechSynthesizer de l'objet Finalize.
Constructeurs
SpeechSynthesizer() |
Initialise une nouvelle instance de la classe SpeechSynthesizer. |
Propriétés
Rate |
Obtient ou définit la vitesse d'énonciation de l'objet SpeechSynthesizer. |
State |
Obtient l'état d'énonciation actuel de l'objet SpeechSynthesizer. |
Voice |
Obtient des informations sur la voix actuelle de l'objet SpeechSynthesizer. |
Volume |
Obtient ou définit le volume de sortie de l'objet de SpeechSynthesizer. |
Méthodes
AddLexicon(Uri, String) |
Ajoute un lexique à l'objet SpeechSynthesizer. |
Dispose() |
Supprime l’objet SpeechSynthesizer et libère les ressources utilisées pendant la session. |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
Finalize() |
Agit comme un dispositif de protection pour nettoyer les ressources au cas où la méthode Dispose() n'est pas appelée. |
GetCurrentlySpokenPrompt() |
Obtient l'invite que le SpeechSynthesizer est en train de prononcer. |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetInstalledVoices() |
Retourne toutes les voix de synthèse vocale installées (conversion de texte par synthèse vocale). |
GetInstalledVoices(CultureInfo) |
Retourne toutes les voix de synthèse vocale installées qui prennent en charge un paramètre régional spécifique. |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
Pause() |
Suspend l'objet SpeechSynthesizer. |
RemoveLexicon(Uri) |
Supprime un lexique de l'objet SpeechSynthesizer. |
Resume() |
Reprend l'objet SpeechSynthesizer après qu'il a été suspendu. |
SelectVoice(String) |
Sélectionne une voix spécifique par son nom. |
SelectVoiceByHints(VoiceGender) |
Sélectionne une voix avec un type spécifique. |
SelectVoiceByHints(VoiceGender, VoiceAge) |
Sélectionne une voix avec un type et un âge spécifiques. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Sélectionne une voix avec un type et un âge spécifiques, selon la position dans laquelle les voix sont classées. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Sélectionne une voix avec un type et un âge et des paramètres régionaux spécifiques, selon la position dans laquelle les voix sont classées. |
SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Configure l'objet SpeechSynthesizer pour ajouter la sortie vers un flux audio. |
SetOutputToDefaultAudioDevice() |
Configure l'objet SpeechSynthesizer pour envoyer la sortie au périphérique audio par défaut. |
SetOutputToNull() |
Configure l'objet SpeechSynthesizer pour ne pas envoyer la sortie des opérations de synthèse à un périphérique, un fichier ou un flux. |
SetOutputToWaveFile(String) |
Configure l'objet SpeechSynthesizer pour ajouter la sortie à un fichier qui contient les données audio au format Waveform. |
SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
Configure l'objet SpeechSynthesizer pour ajouter la sortie à un fichier de format audio Waveform dans un format spécifié. |
SetOutputToWaveStream(Stream) |
Configure l'objet SpeechSynthesizer pour ajouter la sortie à un flux qui contient les données audio au format Waveform. |
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. |
SpeakAsync(Prompt) |
Énonce de façon asynchrone le contenu d'un objet Prompt. |
SpeakAsync(PromptBuilder) |
Énonce de façon asynchrone le contenu d'un objet PromptBuilder. |
SpeakAsync(String) |
Énonce de façon asynchrone le contenu d'une chaîne. |
SpeakAsyncCancel(Prompt) |
Annule l'opération asynchrone de synthèse pour une invite en file d'attente. |
SpeakAsyncCancelAll() |
Annule toutes les opérations asynchrones de synthèse vocale mises en file d'attente. |
SpeakSsml(String) |
Énonce de façon synchrone une String qui contient un balisage SSML. |
SpeakSsmlAsync(String) |
Énonce de façon asynchrone une String qui contient un balisage SSML. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Événements
BookmarkReached |
Déclenché lorsque SpeechSynthesizer rencontre un signet dans une invite. |
PhonemeReached |
Déclenché lorsqu'un phonème est atteint. |
SpeakCompleted |
Déclenché lorsque SpeechSynthesizer termine la lecture d'une invite. |
SpeakProgress |
Déclenché après que le SpeechSynthesizer ait prononcé chaque mot d'une invite. |
SpeakStarted |
Déclenché lorsque SpeechSynthesizer commence la lecture d'une invite. |
StateChanged |
Déclenché lorsque l'état de l'objet SpeechSynthesizer change. |
VisemeReached |
Déclenché lorsqu'un viseme est atteint. |
VoiceChange |
Déclenché lorsque la voix de l'objet SpeechSynthesizer change. |