SpeechSynthesizer Kelas
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.
Menyediakan akses ke fungsionalitas mesin sintesis ucapan yang diinstal.
public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
- Warisan
-
SpeechSynthesizer
- Penerapan
Contoh
Contoh berikut adalah bagian dari aplikasi konsol SpeechSynthesizer yang menginisialisasi objek dan mengucapkan string.
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();
}
}
}
Keterangan
Saat Anda membuat objek baru SpeechSynthesizer , objek tersebut menggunakan suara sistem default. Untuk mengonfigurasi SpeechSynthesizer untuk menggunakan salah satu suara sintesis ucapan (teks ke ucapan) yang diinstal, gunakan SelectVoice metode atau SelectVoiceByHints . Untuk mendapatkan informasi tentang suara mana yang diinstal, gunakan GetInstalledVoices metode dan VoiceInfo kelas .
Kelas ini juga memberikan kontrol atas aspek sintesis ucapan berikut:
Untuk mengonfigurasi output untuk SpeechSynthesizer objek, gunakan SetOutputToAudioStreammetode , , SetOutputToDefaultAudioDeviceSetOutputToNull, dan SetOutputToWaveFile .
Untuk menghasilkan ucapan, gunakan Speakmetode , SpeakAsync, SpeakSsml, atau SpeakSsmlAsync . SpeechSynthesizer dapat menghasilkan ucapan dari teks, Prompt atau PromptBuilder objek, atau dari Speech Synthesis Markup Language (SSML) Versi 1.0.
Untuk menjeda dan melanjutkan sintesis ucapan, gunakan Pause metode dan Resume .
Untuk menambahkan atau menghapus leksikon, gunakan AddLexicon metode dan RemoveLexicon . SpeechSynthesizer dapat menggunakan satu atau beberapa leksikon untuk memandu pengucapan kata-katanya.
Untuk memodifikasi pengiriman output ucapan, gunakan Rate properti dan Volume .
meningkatkan SpeechSynthesizer peristiwa ketika menemukan fitur tertentu dalam perintah: (BookmarkReached, , PhonemeReachedVisemeReached, dan SpeakProgress). Ini juga menimbulkan peristiwa yang melaporkan awal (SpeakStarted) dan akhir (SpeakCompleted) operasi berbicara dan pada perubahan suara berbicara (VoiceChange).
Catatan
Selalu panggil Dispose sebelum Anda merilis referensi terakhir Anda ke SpeechSynthesizer. Jika tidak, sumber daya yang digunakannya tidak akan dibebaskan SpeechSynthesizer sampai pengumpul sampah memanggil metode objek Finalize .
Konstruktor
SpeechSynthesizer() |
Menginisialisasi instans baru kelas SpeechSynthesizer. |
Properti
Rate |
Mendapatkan atau mengatur tingkat SpeechSynthesizer bicara objek. |
State |
Mendapatkan status SpeechSynthesizer objek yang berbicara saat ini. |
Voice |
Mendapatkan informasi tentang suara SpeechSynthesizer objek saat ini. |
Volume |
Mendapatkan atau mengatur volume SpeechSynthesizer output objek. |
Metode
AddLexicon(Uri, String) |
Menambahkan leksikon ke SpeechSynthesizer objek . |
Dispose() |
Buang SpeechSynthesizer objek dan rilis sumber daya yang digunakan selama sesi. |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
Finalize() |
Bertindak sebagai perlindungan untuk membersihkan sumber daya jika Dispose() metode tidak dipanggil. |
GetCurrentlySpokenPrompt() |
Mendapat perintah bahwa SpeechSynthesizer yang berbicara. |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
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. |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
Pause() |
Menjeda SpeechSynthesizer objek. |
RemoveLexicon(Uri) |
Menghapus leksikon dari SpeechSynthesizer objek . |
Resume() |
SpeechSynthesizer Melanjutkan objek setelah dijeda. |
SelectVoice(String) |
Memilih suara tertentu menurut nama. |
SelectVoiceByHints(VoiceGender) |
Memilih suara dengan jenis kelamin tertentu. |
SelectVoiceByHints(VoiceGender, VoiceAge) |
Memilih suara dengan jenis kelamin dan usia tertentu. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Memilih suara dengan jenis kelamin dan usia tertentu, berdasarkan posisi di mana suara diurutkan. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Memilih suara dengan jenis kelamin, usia, dan lokal tertentu, berdasarkan posisi di mana suara diurutkan. |
SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
SpeechSynthesizer Mengonfigurasi objek untuk menambahkan output ke aliran audio. |
SetOutputToDefaultAudioDevice() |
SpeechSynthesizer Mengonfigurasi objek untuk mengirim output ke perangkat audio default. |
SetOutputToNull() |
SpeechSynthesizer Mengonfigurasi objek untuk tidak mengirim output dari operasi sintesis ke perangkat, file, atau aliran. |
SetOutputToWaveFile(String) |
SpeechSynthesizer Mengonfigurasi objek untuk menambahkan output ke file yang berisi audio format Waveform. |
SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
SpeechSynthesizer Mengonfigurasi objek untuk menambahkan output ke file format audio Waveform dalam format tertentu. |
SetOutputToWaveStream(Stream) |
SpeechSynthesizer Mengonfigurasi objek untuk menambahkan output ke aliran yang berisi audio format Waveform. |
Speak(Prompt) |
Secara sinkron berbicara konten Prompt objek. |
Speak(PromptBuilder) |
Secara sinkron berbicara konten PromptBuilder objek. |
Speak(String) |
Secara sinkron mengucapkan konten string. |
SpeakAsync(Prompt) |
Secara asinkron berbicara isi Prompt objek. |
SpeakAsync(PromptBuilder) |
Secara asinkron berbicara isi PromptBuilder objek. |
SpeakAsync(String) |
Secara asinkron berbicara konten string. |
SpeakAsyncCancel(Prompt) |
Membatalkan operasi sintesis asinkron untuk permintaan yang diantrekan. |
SpeakAsyncCancelAll() |
Membatalkan semua operasi sintesis ucapan yang diantrekan, asinkron, dan bertuliskan. |
SpeakSsml(String) |
Secara sinkron berbicara yang String berisi markup SSML. |
SpeakSsmlAsync(String) |
Secara asinkron berbicara yang String berisi markup SSML. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Acara
BookmarkReached |
Dimunculkan saat SpeechSynthesizer menemukan bookmark dalam perintah. |
PhonemeReached |
Dimunculkan saat fonem tercapai. |
SpeakCompleted |
Dimunculkan ketika SpeechSynthesizer selesai berbicara tentang perintah. |
SpeakProgress |
Dimunculkan setelah SpeechSynthesizer berbicara setiap kata individu dari perintah. |
SpeakStarted |
Dimunculkan ketika SpeechSynthesizer memulai berbicara tentang perintah. |
StateChanged |
Dimunculkan saat status SpeechSynthesizer perubahan. |
VisemeReached |
(Dan diangkatlah) diangkatlah ke atas sebagaimana yang disitir oleh ungkapan kalimat ini. |
VoiceChange |
Muncul saat suara SpeechSynthesizer berubah. |