SpeechSynthesizer Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje přístup k funkcím nainstalovaného modulu syntézy řeči.
public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
- Dědičnost
-
SpeechSynthesizer
- Implementuje
Příklady
Následující příklad je součástí konzolové aplikace, která inicializuje SpeechSynthesizer objekt a vysloví řetězec.
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();
}
}
}
Poznámky
Při vytváření nového SpeechSynthesizer objektu se použije výchozí systémový hlas. Pokud chcete nakonfigurovat SpeechSynthesizer použití některého z nainstalovaných hlasů syntézy řeči (převodu textu na řeč), použijte metodu SelectVoice nebo SelectVoiceByHints . Pokud chcete získat informace o tom, které hlasy jsou nainstalovány, použijte metodu GetInstalledVoicesVoiceInfo a třídu.
Tato třída také poskytuje kontrolu nad následujícími aspekty syntézy řeči:
Pokud chcete nakonfigurovat výstup objektu SpeechSynthesizer , použijte SetOutputToAudioStreammetody , SetOutputToDefaultAudioDevice, SetOutputToNulla SetOutputToWaveFile .
K vygenerování řeči použijte metodu Speak, SpeakAsync, SpeakSsmlnebo SpeakSsmlAsync . Může SpeechSynthesizer vytvářet řeč z textu, objektu Prompt nebo PromptBuilder nebo z jazyka SSML (Speech Synthesis Markup Language) verze 1.0.
Pokud chcete pozastavit a obnovit syntézu Pause řeči, použijte metody a Resume .
Pokud chcete přidat nebo odebrat lexikony, použijte AddLexicon metody a RemoveLexicon . K SpeechSynthesizer vedení výslovnosti slov může použít jeden nebo více lexikonů.
Pokud chcete upravit doručování výstupu řeči, použijte Rate vlastnosti a Volume .
Vyvolá SpeechSynthesizer události, když narazí na určité funkce ve výzev: (BookmarkReached, PhonemeReached, VisemeReacheda SpeakProgress). Vyvolává také události, které hlásí začátek (SpeakStarted) a konec (SpeakCompleted) operací mluvení a změnu hlasu mluvení (VoiceChange).
Poznámka
Dispose Před uvolněním posledního odkazu na SpeechSynthesizer. Jinak prostředky, které používá, nebudou uvolněny, dokud systém uvolňování paměti nezavolá metodu objektu SpeechSynthesizerFinalize .
Konstruktory
SpeechSynthesizer() |
Inicializuje novou instanci SpeechSynthesizer třídy. |
Vlastnosti
Rate |
Získá nebo nastaví mluvenou rychlost objektu SpeechSynthesizer . |
State |
Získá aktuální mluvený stav objektu SpeechSynthesizer . |
Voice |
Získá informace o aktuálním hlasu objektu SpeechSynthesizer . |
Volume |
Získejte nebo nastaví výstupní svazek objektu SpeechSynthesizer . |
Metody
AddLexicon(Uri, String) |
Přidá do objektu SpeechSynthesizer lexikon. |
Dispose() |
SpeechSynthesizer Odstraní objekt a uvolní prostředky použité během relace. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
Finalize() |
Funguje jako ochrana pro vyčištění prostředků v případě, že Dispose() metoda není volána. |
GetCurrentlySpokenPrompt() |
Získá výzvu, že SpeechSynthesizer mluví. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetInstalledVoices() |
Vrátí všechny nainstalované hlasy syntézy řeči (převod textu na řeč). |
GetInstalledVoices(CultureInfo) |
Vrátí všechny nainstalované hlasy syntézy řeči (převod textu na řeč), které podporují určité národní prostředí. |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
Pause() |
Pozastaví SpeechSynthesizer objekt. |
RemoveLexicon(Uri) |
Odebere z objektu SpeechSynthesizer lexikon. |
Resume() |
SpeechSynthesizer Obnoví objekt po jeho pozastavení. |
SelectVoice(String) |
Vybere konkrétní hlas podle jména. |
SelectVoiceByHints(VoiceGender) |
Vybere hlas s konkrétním pohlavím. |
SelectVoiceByHints(VoiceGender, VoiceAge) |
Vybere hlas s konkrétním pohlavím a věkem. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Vybere hlas s konkrétním pohlavím a věkem na základě pozice, ve které jsou hlasy seřazené. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Vybere hlas s konkrétním pohlavím, věkem a národním prostředím na základě pozice, ve které jsou hlasy seřazené. |
SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Nakonfiguruje objekt pro SpeechSynthesizer připojení výstupu ke zvukovému streamu. |
SetOutputToDefaultAudioDevice() |
Nakonfiguruje objekt tak, SpeechSynthesizer aby odesílal výstup do výchozího zvukového zařízení. |
SetOutputToNull() |
Nakonfiguruje objekt tak, SpeechSynthesizer aby neodesílal výstup z operací syntézy do zařízení, souboru nebo datového proudu. |
SetOutputToWaveFile(String) |
Nakonfiguruje objekt tak, SpeechSynthesizer aby připojil výstup k souboru, který obsahuje zvuk ve formátu Waveform. |
SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
Konfiguruje SpeechSynthesizer objekt pro připojení výstupu k souboru formátu zvuku Waveform v zadaném formátu. |
SetOutputToWaveStream(Stream) |
Nakonfiguruje objekt tak, SpeechSynthesizer aby připojil výstup k datovému proudu, který obsahuje zvuk ve formátu Waveform. |
Speak(Prompt) |
Synchronně vyslovuje obsah objektu Prompt . |
Speak(PromptBuilder) |
Synchronně vyslovuje obsah objektu PromptBuilder . |
Speak(String) |
Synchronně vyslovuje obsah řetězce. |
SpeakAsync(Prompt) |
Asynchronně vyslovuje obsah objektu Prompt . |
SpeakAsync(PromptBuilder) |
Asynchronně vyslovuje obsah objektu PromptBuilder . |
SpeakAsync(String) |
Asynchronně vyslovuje obsah řetězce. |
SpeakAsyncCancel(Prompt) |
Zruší operaci asynchronní syntézy pro výzvu ve frontě. |
SpeakAsyncCancelAll() |
Zruší všechny operace syntézy řeči ve frontě, asynchronní operace. |
SpeakSsml(String) |
Synchronně vyslovuje String kód, který obsahuje kód SSML. |
SpeakSsmlAsync(String) |
Asynchronně vyslovuje String kód, který obsahuje kód SSML. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Událost
BookmarkReached |
Vyvolána, když se SpeechSynthesizer zobrazí záložka ve výzvě. |
PhonemeReached |
Vyvolání při dosažení fonému. |
SpeakCompleted |
Vyvolána, když se SpeechSynthesizer dokončí řeč o výzvě. |
SpeakProgress |
Vyvolá se po vyslovování SpeechSynthesizer každého jednotlivého slova výzvy. |
SpeakStarted |
Vyvolána, SpeechSynthesizer když začne mluvit o výzvě. |
StateChanged |
Vyvolá se při změně stavu SpeechSynthesizer . |
VisemeReached |
Vyvolá se při dosažení visemu. |
VoiceChange |
Zvednuto, když se změní hlas SpeechSynthesizer . |