SpeechSynthesizer.GetInstalledVoices Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengembalikan kumpulan suara sintesis ucapan (teks ke ucapan) yang saat ini diinstal pada sistem.
Overload
GetInstalledVoices() |
Mengembalikan semua suara sintesis ucapan (teks ke ucapan) yang diinstal. |
GetInstalledVoices(CultureInfo) |
Mengembalikan semua suara sintesis ucapan yang diinstal (teks ke ucapan) yang mendukung lokal tertentu. |
Keterangan
Ketika aplikasi memanggil GetInstalledVoices, metode memverifikasi bahwa masing-masing suara (mesin untuk teks ke ucapan) yang ditemukannya di registri memenuhi kriteria minimum tertentu. Untuk suara apa pun yang gagal verifikasi, GetInstalledVoices atur propertinya Enabled ke False
. Aplikasi tidak dapat memilih suara yang propertinya Enabled adalah False
. Biasanya, aplikasi tidak akan mengatur properti suara Enabled .
GetInstalledVoices()
- Sumber:
- SpeechSynthesizer.cs
- Sumber:
- SpeechSynthesizer.cs
Mengembalikan semua suara sintesis ucapan (teks ke ucapan) yang diinstal.
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)
Mengembalikan
Mengembalikan kumpulan suara baca-saja yang saat ini diinstal pada sistem.
Contoh
Contoh berikut adalah bagian dari aplikasi konsol SpeechSynthesizer yang menginisialisasi objek dan output ke konsol daftar suara yang diinstal (mesin untuk sintesis ucapan) dan menunjukkan informasi yang tersedia untuk setiap suara.
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();
}
}
}
Keterangan
Suara adalah mesin untuk sintesis ucapan (teks ke ucapan atau TTS) yang diinstal pada sistem.
Lihat juga
Berlaku untuk
GetInstalledVoices(CultureInfo)
- Sumber:
- SpeechSynthesizer.cs
- Sumber:
- SpeechSynthesizer.cs
Mengembalikan semua suara sintesis ucapan yang diinstal (teks ke ucapan) yang mendukung lokal tertentu.
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
Lokal yang harus didukung suara.
Mengembalikan
Mengembalikan kumpulan suara baca-saja yang saat ini diinstal pada sistem yang mendukung lokal yang ditentukan.
Contoh
Contoh berikut adalah bagian dari aplikasi konsol SpeechSynthesizer yang menginisialisasi objek dan output ke konsol daftar suara yang diinstal yang mendukung lokal 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);
}
}
}
Keterangan
Jika tidak ada suara yang diinstal yang mendukung lokal yang ditentukan, metode ini mengembalikan koleksi kosong.
Microsoft Windows dan System.Speech API menerima semua kode negara bahasa yang valid. Untuk melakukan teks ke ucapan menggunakan bahasa yang ditentukan dalam properti Budaya, mesin sintesis ucapan yang mendukung kode negara bahasa tersebut harus diinstal. Mesin sintesis ucapan yang dikirim dengan Microsoft Windows 7 berfungsi dengan kode negara bahasa berikut:
en-US. Inggris (Amerika Serikat)
zh-CN. Tionghoa (Tiongkok)
zh-TW. China (Taiwan)
Kode bahasa dua huruf seperti "en" juga diizinkan.