SpeechSynthesizer.GetInstalledVoices SpeechSynthesizer.GetInstalledVoices SpeechSynthesizer.GetInstalledVoices SpeechSynthesizer.GetInstalledVoices Method

定義

現在システムにインストールされている音声合成 (音声変換) の音声のコレクションを返します。Returns the collection of speech synthesis (text-to-speech) voices that are currently installed on the system.

オーバーロード

GetInstalledVoices() GetInstalledVoices() GetInstalledVoices() GetInstalledVoices()

インストール済みの音声合成 (音声変換) の音声を返します。Returns all of the installed speech synthesis (text-to-speech) voices.

GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo)

特定のロケールをサポートする、インストール済みの音声合成 (音声変換) の音声を返します。Returns all of the installed speech synthesis (text-to-speech) voices that support a specific locale.

注釈

アプリケーションがを呼びGetInstalledVoices出すと、メソッドは、レジストリ内で見つかった各音声 (音声合成のエンジン) が特定の最小条件を満たしていることを確認します。When an application calls GetInstalledVoices, the method verifies that each of the voices (engines for text-to-speech) it finds in the registry meets certain minimum criteria. 検証に失敗した音声にGetInstalledVoices対してEnabledは、 Falseそのプロパティをに設定します。For any voice that fails verification, GetInstalledVoices sets its Enabled property to False. アプリケーションは、 EnabledプロパティがでFalseある音声を選択できません。An application cannot select a voice whose Enabled property is False. 通常、アプリケーションは音声のEnabledプロパティを設定しません。Typically, applications will not set a voice's Enabled property.

GetInstalledVoices() GetInstalledVoices() GetInstalledVoices() GetInstalledVoices()

インストール済みの音声合成 (音声変換) の音声を返します。Returns all of the installed speech synthesis (text-to-speech) voices.

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)

戻り値

システムに現在インストールされている、音声の読み取り専用のコレクションを返します。Returns a read-only collection of the voices currently installed on the system.

次の例は、オブジェクトをSpeechSynthesizer初期化し、インストールされている音声の一覧 (音声合成用エンジン) をコンソールに出力して、各音声で利用できる情報を示すコンソールアプリケーションの一部です。The following example is part of a console application that initializes a SpeechSynthesizer object and outputs to the console a list of the installed voices (engines for speech synthesis) and demonstrates the information that is available for each voice.

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

注釈

音声は、システムにインストールされている音声合成 (音声合成または TTS) のエンジンです。A voice is an engine for speech synthesis (text-to-speech or TTS) that is installed on the system.

こちらもご覧ください

GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo)

特定のロケールをサポートする、インストール済みの音声合成 (音声変換) の音声を返します。Returns all of the installed speech synthesis (text-to-speech) voices that support a specific locale.

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)

パラメーター

culture
CultureInfo CultureInfo CultureInfo CultureInfo

音声がサポートする必要があるロケール。The locale that the voice must support.

戻り値

指定のロケールをサポートするシステムに現在インストールされている、音声の読み取り専用のコレクションを返します。Returns a read-only collection of the voices currently installed on the system that support the specified locale.

次の例は、オブジェクトをSpeechSynthesizer初期化し、en-us ロケールをサポートするインストール済みの音声のリストをコンソールに出力するコンソールアプリケーションの一部です。The following example is part of a console application that initializes a SpeechSynthesizer object and outputs to the console a list of the installed voices that support the en-US locale.

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

注釈

インストールされているどの音声も指定されたロケールをサポートしていない場合、このメソッドは空のコレクションを返します。If none of the installed voices support the specified locale, this method returns an empty collection.

Microsoft Windows とシステム。 Speech API 有効な国コードをすべて受け入れます。Microsoft Windows and the System.Speech API accept all valid language-country codes. カルチャプロパティで指定された言語を使用して音声合成エンジンを実行するには、その言語の国コードをサポートする音声合成エンジンがインストールされている必要があります。To perform text-to-speech using the language specified in the Culture property, a speech synthesis engine that supports that language-country code must be installed. Microsoft Windows 7 に付属している音声合成エンジンは、次の言語の国コードで動作します。The speech synthesis engines that shipped with Microsoft Windows 7 work with the following language-country codes:

  • en-US.en-US. 英語 (米国)English (United States)

  • zh-CN.zh-CN. 中国語 (中国)Chinese (China)

  • zh-TW.zh-TW. 中国語 (台湾)Chinese (Taiwan)

"En" など、2文字の言語コードも許可されます。Two-letter language codes such as "en" are also permitted.

こちらもご覧ください

適用対象