SpeechSynthesizer.GetInstalledVoices Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Auflistung von Sprachsynthesestimden (Text-zu-Sprache) zurück, die derzeit auf dem System installiert sind.
Überlädt
| Name | Beschreibung |
|---|---|
| GetInstalledVoices() |
Gibt alle installierten Sprachsynthesestimden (Text-zu-Sprache)-Stimmen zurück. |
| GetInstalledVoices(CultureInfo) |
Gibt alle installierten Sprachsynthesestimden (Text-zu-Sprache) zurück, die ein bestimmtes Gebietsschema unterstützen. |
Hinweise
Wenn eine Anwendung aufruft GetInstalledVoices, überprüft die Methode, ob jede der Stimmen (Engines für Text-zu-Sprache) in der Registrierung bestimmte Mindestkriterien erfüllt. Legt für jede Stimme, die die Überprüfung fehlschlägt, GetInstalledVoices die Enabled Eigenschaft auf False. Eine Anwendung kann keine Stimme auswählen, deren Enabled Eigenschaft lautet False. In der Regel legen Anwendungen die Eigenschaft einer Stimme Enabled nicht fest.
GetInstalledVoices()
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
Gibt alle installierten Sprachsynthesestimden (Text-zu-Sprache)-Stimmen zurück.
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)
Gibt zurück
Gibt eine schreibgeschützte Auflistung der aktuell auf dem System installierten Stimmen zurück.
Beispiele
Das folgende Beispiel ist Teil einer Konsolenanwendung, die ein SpeechSynthesizer Objekt initialisiert und in der Konsole eine Liste der installierten Stimmen (Engines für die Sprachsynthese) ausgibt und die Informationen veranschaulicht, die für jede Stimme verfügbar sind.
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();
}
}
}
Hinweise
Eine Stimme ist ein Modul für die Sprachsynthese (Text-zu-Sprache oder TTS), das auf dem System installiert ist.
Weitere Informationen
Gilt für:
GetInstalledVoices(CultureInfo)
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
- Quelle:
- SpeechSynthesizer.cs
Gibt alle installierten Sprachsynthesestimden (Text-zu-Sprache) zurück, die ein bestimmtes Gebietsschema unterstützen.
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)
Parameter
- culture
- CultureInfo
Das Gebietsschema, das von der Stimme unterstützt werden muss.
Gibt zurück
Gibt eine schreibgeschützte Auflistung der aktuell auf dem System installierten Stimmen zurück, die das angegebene Gebietsschema unterstützen.
Beispiele
Das folgende Beispiel ist Teil einer Konsolenanwendung, die ein SpeechSynthesizer Objekt initialisiert und in der Konsole eine Liste der installierten Stimmen ausgibt, die das gebietsschema en-US unterstützen.
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);
}
}
}
Hinweise
Wenn keine der installierten Stimmen das angegebene Gebietsschema unterstützt, gibt diese Methode eine leere Auflistung zurück.
Microsoft Windows und die System.Speech-API akzeptieren alle gültigen Sprachlandcodes. Zum Ausführen von Text-zu-Sprache mithilfe der in der Culture-Eigenschaft angegebenen Sprache muss ein Sprachsynthesemodul installiert werden, das diesen Sprachlandcode unterstützt. Die Sprachsynthesemodule, die mit Microsoft Windows 7 ausgeliefert wurden, funktionieren mit den folgenden Sprachlandcodes:
en-US. Englisch (Vereinigte Staaten)
zh-CN Chinesisch (China)
zh-TW. Chinesisch (Taiwan)
Zwei-Buchstaben-Sprachcodes wie "en" sind ebenfalls zulässig.