SpeechSynthesizer Kelas

Definisi

Ruang nama:

System.Speech.Synthesis

Rakitan:

System.Speech.dll

Paket:

System.Speech v11.0.0-preview.3.26207.106

Sumber:

SpeechSynthesizer.cs

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

Object

SpeechSynthesizer

Penerapan

IDisposable

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, objek Prompt atau PromptBuilder , 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 operasi mulai (SpeakStarted) dan akhir (SpeakCompleted) berbicara dan pada perubahan suara berbicara (VoiceChange).

Nota

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

Nama	Deskripsi
SpeechSynthesizer()	Menginisialisasi instans baru dari kelas SpeechSynthesizer.

Properti

Nama	Deskripsi
Rate	Mendapatkan atau mengatur tingkat SpeechSynthesizer bicara objek.
State	Mendapatkan status SpeechSynthesizer berbicara objek saat ini.
Voice	Mendapatkan informasi tentang suara SpeechSynthesizer objek saat ini.
Volume	Mendapatkan atau mengatur volume SpeechSynthesizer output objek.

Metode

Nama	Deskripsi
AddLexicon(Uri, String)	Menambahkan leksikon ke SpeechSynthesizer objek.
Dispose()	SpeechSynthesizer Membuang objek dan merilis sumber daya yang digunakan selama sesi.
Finalize()	Bertindak sebagai perlindungan untuk membersihkan sumber daya jika Dispose() metode tersebut tidak dipanggil.
GetCurrentlySpokenPrompt()	Mendapat perintah bahwa SpeechSynthesizer yang berbicara.
GetInstalledVoices()	Mengembalikan semua suara sintesis ucapan (teks ke ucapan) yang diinstal.
GetInstalledVoices(CultureInfo)	Mengembalikan semua suara sintesis ucapan (teks ke ucapan) yang diinstal yang mendukung lokal tertentu.
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, VoiceAge, Int32, CultureInfo)	Memilih suara dengan jenis kelamin, usia, dan lokal tertentu, berdasarkan posisi di mana suara diurutkan.
SelectVoiceByHints(VoiceGender, VoiceAge, Int32)	Memilih suara dengan jenis kelamin dan usia tertentu, berdasarkan posisi di mana suara diurutkan.
SelectVoiceByHints(VoiceGender, VoiceAge)	Memilih suara dengan jenis kelamin dan usia tertentu.
SelectVoiceByHints(VoiceGender)	Memilih suara dengan jenis kelamin tertentu.
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, SpeechAudioFormatInfo)	SpeechSynthesizer Mengonfigurasi objek untuk menambahkan output ke file format audio Waveform dalam format tertentu.
SetOutputToWaveFile(String)	SpeechSynthesizer Mengonfigurasi objek untuk menambahkan output ke file yang berisi audio format Waveform.
SetOutputToWaveStream(Stream)	SpeechSynthesizer Mengonfigurasi objek untuk menambahkan output ke aliran yang berisi audio format Waveform.
Speak(Prompt)	Secara sinkron berbicara isi Prompt objek.
Speak(PromptBuilder)	Secara sinkron berbicara isi PromptBuilder objek.
Speak(String)	Secara sinkron berbicara 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 antrean.
SpeakAsyncCancelAll()	Membatalkan semua operasi sintesis ucapan yang diantrekan, asinkron, dan ucapan.
SpeakSsml(String)	Secara sinkron berbicara yang String berisi markup SSML.
SpeakSsmlAsync(String)	Secara asinkron berbicara yang String berisi markup SSML.

Acara

Nama	Deskripsi
BookmarkReached	Dimunculkan saat SpeechSynthesizer menemukan marka buku dalam perintah.
PhonemeReached	Dinaikkan ketika telepon tercapai.
SpeakCompleted	Dimunculkan ketika SpeechSynthesizer menyelesaikan berbicara tentang perintah.
SpeakProgress	Dimunculkan setelah SpeechSynthesizer berbicara setiap kata individu dari perintah.
SpeakStarted	Dimunculkan ketika SpeechSynthesizer memulai berbicara tentang perintah.
StateChanged	Dimunculkan ketika status SpeechSynthesizer perubahan.
VisemeReached	Dinaikkan ketika viseme tercapai.
VoiceChange	Dimunculkan saat suara SpeechSynthesizer berubah.

Lihat juga

• InstalledVoice
• Prompt
• PromptBuilder