SpeechSynthesizer.GetInstalledVoices Méthode

Définition

Retourne la collection de voix de synthèse vocale (conversion de texte par synthèse vocale) qui sont actuellement installées sur le système.

Surcharges

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 des paramètres régionaux spécifiques.

Remarques

Lorsqu’une application appelle GetInstalledVoices, la méthode vérifie que chacune des voix (moteurs pour la synthèse vocale) qu’elle trouve dans le Registre répond à certains critères minimaux. Pour toute voix qui échoue à la vérification, GetInstalledVoices définit sa Enabled propriété sur False. Une application ne peut pas sélectionner une voix dont Enabled la propriété est False. En règle générale, les applications ne définissent pas la propriété d’une Enabled voix.

GetInstalledVoices()

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

Retourne toutes les voix de synthèse vocale installées (conversion de texte par synthèse vocale).

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::Speech::Synthesis::InstalledVoice ^> ^ GetInstalledVoices();
public System.Collections.ObjectModel.ReadOnlyCollection<System.Speech.Synthesis.InstalledVoice> GetInstalledVoices ();
member this.GetInstalledVoices : unit -> System.Collections.ObjectModel.ReadOnlyCollection<System.Speech.Synthesis.InstalledVoice>
Public Function GetInstalledVoices () As ReadOnlyCollection(Of InstalledVoice)

Retours

Retourne une collection en lecture seule des voix actuellement installées sur le système.

Exemples

L’exemple suivant fait partie d’une application console qui initialise un SpeechSynthesizer objet et affiche à la console une liste des voix installées (moteurs pour la synthèse vocale) et illustre les informations disponibles pour chaque voix.

using System;
using System.Speech.Synthesis;
using System.Speech.AudioFormat;

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

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

        // Output information about all of the installed voices.
        Console.WriteLine("Installed voices -");
        foreach (InstalledVoice voice in synth.GetInstalledVoices())
        {
          VoiceInfo info = voice.VoiceInfo;
          string AudioFormats = "";
          foreach (SpeechAudioFormatInfo fmt in info.SupportedAudioFormats)
          {
            AudioFormats += String.Format("{0}\n",
            fmt.EncodingFormat.ToString());
          }

          Console.WriteLine(" Name:          " + info.Name);
          Console.WriteLine(" Culture:       " + info.Culture);
          Console.WriteLine(" Age:           " + info.Age);
          Console.WriteLine(" Gender:        " + info.Gender);
          Console.WriteLine(" Description:   " + info.Description);
          Console.WriteLine(" ID:            " + info.Id);
          Console.WriteLine(" Enabled:       " + voice.Enabled);
          if (info.SupportedAudioFormats.Count != 0)
          {
            Console.WriteLine( " Audio formats: " + AudioFormats);
          }
          else
          {
            Console.WriteLine(" No supported audio formats found");
          }

          string AdditionalInfo = "";
          foreach (string key in info.AdditionalInfo.Keys)
          {
            AdditionalInfo += String.Format("  {0}: {1}\n", key, info.AdditionalInfo[key]);
          }

          Console.WriteLine(" Additional Info - " + AdditionalInfo);
          Console.WriteLine();
        }
      }
      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }
  }
}

Remarques

Une voix est un moteur de synthèse vocale (synthèse vocale ou TTS) installé sur le système.

Voir aussi

S’applique à

GetInstalledVoices(CultureInfo)

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

Retourne toutes les voix de synthèse vocale installées qui prennent en charge des paramètres régionaux spécifiques.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::Speech::Synthesis::InstalledVoice ^> ^ GetInstalledVoices(System::Globalization::CultureInfo ^ culture);
public System.Collections.ObjectModel.ReadOnlyCollection<System.Speech.Synthesis.InstalledVoice> GetInstalledVoices (System.Globalization.CultureInfo culture);
member this.GetInstalledVoices : System.Globalization.CultureInfo -> System.Collections.ObjectModel.ReadOnlyCollection<System.Speech.Synthesis.InstalledVoice>
Public Function GetInstalledVoices (culture As CultureInfo) As ReadOnlyCollection(Of InstalledVoice)

Paramètres

culture
CultureInfo

Paramètres régionaux que la voix doit prendre en charge.

Retours

Retourne une collection en lecture seule des voix actuellement installées sur le système qui prennent en charge les paramètres régionaux spécifiés.

Exemples

L’exemple suivant fait partie d’une application console qui initialise un SpeechSynthesizer objet et génère à la console une liste des voix installées qui prennent en charge les paramètres régionaux en-US.

using System;
using System.Globalization;
using System.Speech.Synthesis;

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

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

        // Output information about all of the installed voices that
        // support the en-US locale.
        Console.WriteLine("Installed voices for the en-US locale:");
        foreach (InstalledVoice voice in
          synthesizer.GetInstalledVoices(new CultureInfo("en-US")))
        {
          VoiceInfo info = voice.VoiceInfo;
          OutputVoiceInfo(info);
        }

        // Output information about the current voice.
        Console.WriteLine();
        Console.WriteLine("Current voice:");
        OutputVoiceInfo(synthesizer.Voice);
      }

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

    // Display information about a synthesizer voice.
    private static void OutputVoiceInfo(VoiceInfo info)
    {
      Console.WriteLine("  Name: {0}, culture: {1}, gender: {2}, age: {3}.",
        info.Name, info.Culture, info.Gender, info.Age);
      Console.WriteLine("    Description: {0}", info.Description);
    }
  }
}

Remarques

Si aucune des voix installées ne prend en charge les paramètres régionaux spécifiés, cette méthode retourne une collection vide.

Microsoft Windows et l’API System.Speech acceptent tous les codes de pays de langue valides. Pour effectuer la synthèse vocale à l’aide de la langue spécifiée dans la propriété Culture, un moteur de synthèse vocale qui prend en charge ce code de langue-pays doit être installé. Les moteurs de synthèse vocale fournis avec Microsoft Windows 7 fonctionnent avec les codes de pays de langue suivants :

  • en-US. Anglais (États-Unis)

  • zh-CN. Chinois (Chine)

  • zh-TW. Chinois (Taïwan)

Les codes de langue à deux lettres tels que « en » sont également autorisés.

Voir aussi

S’applique à