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 mluví ř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
Když vytvoříte nový SpeechSynthesizer objekt, použije se výchozí systémový hlas. Pokud chcete nakonfigurovat SpeechSynthesizer použití některého z nainstalovaných hlasových hlasů (převodu textu na řeč), použijte metodu nebo SelectVoice metoduSelectVoiceByHints. Chcete-li získat informace o tom, které hlasy jsou nainstalovány, použijte GetInstalledVoices metodu VoiceInfo a třídu.
Tato třída také poskytuje kontrolu nad následujícími aspekty syntézy řeči:
Ke konfiguraci výstupu objektu SpeechSynthesizer použijte SetOutputToAudioStream, SetOutputToDefaultAudioDevice, SetOutputToNulla SetOutputToWaveFile metody.
K vygenerování řeči použijte metodu Speak, SpeakAsync, SpeakSsmlnebo SpeakSsmlAsync metodu. Může SpeechSynthesizer vytvářet řeč z textu, objektu Prompt nebo PromptBuilder z jazyka SSML (Speech Synthesis Markup Language) verze 1.0.
K pozastavení a obnovení syntézy řeči použijte metody Pause a Resume metody.
Chcete-li přidat nebo odebrat lexikony, použijte metody AddLexicon a RemoveLexicon metody. Pomocí SpeechSynthesizer jednoho nebo více lexikonů můžete vést jeho výslovnost slov.
Pokud chcete upravit doručení výstupu řeči, použijte vlastnosti Rate a Volume vlastnosti.
Vyvolá SpeechSynthesizer události, když narazí na určité funkce v výzev: (BookmarkReached, PhonemeReached, VisemeReached, a SpeakProgress). Vyvolává také události, které hlásí na začátku (SpeakStarted) a na konci (SpeakCompleted) operací mluvení a na změně hlasu mluvení (VoiceChange).
Poznámka:
Vždy zavolejte Dispose před uvolněním posledního odkazu na SpeechSynthesizer. Jinak prostředky, které používá, nebudou uvolněny, dokud uvolňování paměti volá metodu SpeechSynthesizer objektu Finalize .
Konstruktory
| Name | Description |
|---|---|
| SpeechSynthesizer() |
Inicializuje novou instanci SpeechSynthesizer třídy. |
Vlastnosti
| Name | Description |
|---|---|
| Rate |
Získá nebo nastaví míru mluvení objektu SpeechSynthesizer . |
| State |
Získá aktuální stav mluvení objektu SpeechSynthesizer . |
| Voice |
Získá informace o aktuálním hlasu objektu SpeechSynthesizer . |
| Volume |
Získá nebo nastaví výstupní svazek objektu SpeechSynthesizer . |
Metody
| Name | Description |
|---|---|
| AddLexicon(Uri, String) |
Přidá do objektu SpeechSynthesizer lexikon. |
| Dispose() |
SpeechSynthesizer Odstraní objekt a uvolní prostředky používané během relace. |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| Finalize() |
Funguje jako ochrana k vyčištění prostředků v případě, že Dispose() metoda není volána. |
| GetCurrentlySpokenPrompt() |
Dostane výzvu, že SpeechSynthesizer mluví. |
| GetHashCode() |
Slouží jako výchozí funkce hash. (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í konkrétní národní prostředí. |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (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, VoiceAge, Int32, CultureInfo) |
Vybere hlas s určitým pohlavím, věkem a národním prostředím na základě pozice, ve které jsou hlasy seřazeny. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Vybere hlas s určitým pohlavím a věkem na základě pozice, ve které jsou hlasy seřazeny. |
| SelectVoiceByHints(VoiceGender, VoiceAge) |
Vybere hlas s konkrétním pohlavím a věkem. |
| SelectVoiceByHints(VoiceGender) |
Vybere hlas s konkrétním pohlavím. |
| SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Nakonfiguruje SpeechSynthesizer objekt pro 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, SpeechAudioFormatInfo) |
Nakonfiguruje SpeechSynthesizer objekt pro připojení výstupu k souboru zvukového formátu Waveform v zadaném formátu. |
| SetOutputToWaveFile(String) |
Nakonfiguruje SpeechSynthesizer objekt pro připojení výstupu k souboru, který obsahuje zvuk ve formátu Waveform. |
| SetOutputToWaveStream(Stream) |
Nakonfiguruje SpeechSynthesizer objekt pro připojení výstupu ke streamu, který obsahuje zvuk ve formátu Waveform. |
| Speak(Prompt) |
Synchronně mluví obsah objektu Prompt . |
| Speak(PromptBuilder) |
Synchronně mluví obsah objektu PromptBuilder . |
| Speak(String) |
Synchronně mluví obsah řetězce. |
| SpeakAsync(Prompt) |
Asynchronně mluví obsah objektu Prompt . |
| SpeakAsync(PromptBuilder) |
Asynchronně mluví obsah objektu PromptBuilder . |
| SpeakAsync(String) |
Asynchronně mluví obsah řetězce. |
| SpeakAsyncCancel(Prompt) |
Zruší asynchronní operaci syntézy pro výzvu zařazenou do fronty. |
| SpeakAsyncCancelAll() |
Zruší všechny operace syntézy řeči ve frontě, asynchronní a asynchronní. |
| SpeakSsml(String) |
Synchronně mluví o String kódu, který obsahuje kód SSML. |
| SpeakSsmlAsync(String) |
Asynchronně mluví o String kódu, který obsahuje kód SSML. |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Událost
| Name | Description |
|---|---|
| BookmarkReached |
Vyvolá se při SpeechSynthesizer zobrazení záložky v příkazovém řádku. |
| PhonemeReached |
Vyvolá se při dosažení foonemu. |
| SpeakCompleted |
Vyvolá se po SpeechSynthesizer dokončení mluvení výzvy. |
| SpeakProgress |
Zvednuto po SpeechSynthesizer jednotlivých slovech výzvy. |
| SpeakStarted |
Vyvolá se, když SpeechSynthesizer začne mluvit o výzvě. |
| StateChanged |
Vyvolá se při změně stavu SpeechSynthesizer . |
| VisemeReached |
Vyvolá se při dosažení viseme. |
| VoiceChange |
Vyvolá se při změně hlasu SpeechSynthesizer . |