SpeechSynthesizer Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ger åtkomst till funktionerna i en installerad talsyntesmotor.
public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
- Arv
-
SpeechSynthesizer
- Implementeringar
Exempel
Följande exempel är en del av ett konsolprogram som initierar ett SpeechSynthesizer objekt och talar en sträng.
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();
}
}
}
Kommentarer
När du skapar ett nytt SpeechSynthesizer objekt använder det standardsystemrösten. Om du vill konfigurera SpeechSynthesizer att använda en av de installerade talsyntesrösterna (text-till-tal) använder du SelectVoice metoden eller SelectVoiceByHints . Om du vill få information om vilka röster som installeras använder du GetInstalledVoices metoden och VoiceInfo klassen.
Den här klassen ger också kontroll över följande aspekter av talsyntes:
Om du vill konfigurera utdata för SpeechSynthesizer objektet använder du SetOutputToAudioStreammetoderna , SetOutputToDefaultAudioDevice, SetOutputToNulloch SetOutputToWaveFile .
Om du vill generera tal använder du Speakmetoden , SpeakAsync, SpeakSsmleller SpeakSsmlAsync . SpeechSynthesizer Kan producera tal från text, ett Prompt objekt eller PromptBuilder från Speech Synthesis Markup Language (SSML) version 1.0.
Om du vill pausa och återuppta talsyntesen Pause använder du metoderna och Resume .
Om du vill lägga till eller ta bort lexikon använder du AddLexicon metoderna och RemoveLexicon . SpeechSynthesizer Kan använda ett eller flera lexikon för att vägleda dess uttal av ord.
Om du vill ändra leveransen av talutdata använder du Rate egenskaperna och Volume .
SpeechSynthesizer Genererar händelser när vissa funktioner påträffas i prompter: (BookmarkReached, PhonemeReached, VisemeReachedoch SpeakProgress). Det genererar också händelser som rapporterar om start (SpeakStarted) och slut (SpeakCompleted) av talåtgärder och om ändringen av talrösten (VoiceChange).
Note
Anropa Dispose alltid innan du släpper din senaste referens till SpeechSynthesizer. Annars frigörs inte de resurser som används förrän skräpinsamlaren SpeechSynthesizer anropar objektets Finalize -metod.
Konstruktorer
| Name | Description |
|---|---|
| SpeechSynthesizer() |
Initierar en ny instans av SpeechSynthesizer klassen. |
Egenskaper
| Name | Description |
|---|---|
| Rate |
Hämtar eller anger objektets SpeechSynthesizer talfrekvens. |
| State |
Hämtar objektets SpeechSynthesizer aktuella taltillstånd. |
| Voice |
Hämtar information om objektets SpeechSynthesizer aktuella röst. |
| Volume |
Hämta eller ange objektets SpeechSynthesizer utdatavolym. |
Metoder
| Name | Description |
|---|---|
| AddLexicon(Uri, String) |
Lägger till ett lexikon i SpeechSynthesizer objektet. |
| Dispose() |
Bortser från objektet SpeechSynthesizer och frigör resurser som används under sessionen. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| Finalize() |
Fungerar som ett skydd för att rensa resurser om Dispose() metoden inte anropas. |
| GetCurrentlySpokenPrompt() |
Får uppmaningen SpeechSynthesizer att talar. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetInstalledVoices() |
Returnerar alla installerade talsyntesröster (text till tal). |
| GetInstalledVoices(CultureInfo) |
Returnerar alla installerade talsyntesröster (text till tal) som stöder ett visst språk. |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| Pause() |
Pausar objektet SpeechSynthesizer . |
| RemoveLexicon(Uri) |
Tar bort ett lexikon från objektet SpeechSynthesizer . |
| Resume() |
Återupptar objektet SpeechSynthesizer när det har pausats. |
| SelectVoice(String) |
Väljer en specifik röst efter namn. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Väljer en röst med ett specifikt kön, ålder och språk, baserat på den position där rösterna sorteras. |
| SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Väljer en röst med ett specifikt kön och en viss ålder, baserat på den position där rösterna sorteras. |
| SelectVoiceByHints(VoiceGender, VoiceAge) |
Väljer en röst med ett specifikt kön och en viss ålder. |
| SelectVoiceByHints(VoiceGender) |
Väljer en röst med ett specifikt kön. |
| SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Konfigurerar objektet SpeechSynthesizer för att lägga till utdata till en ljudström. |
| SetOutputToDefaultAudioDevice() |
Konfigurerar objektet SpeechSynthesizer för att skicka utdata till standardljudenheten. |
| SetOutputToNull() |
Konfigurerar objektet så att det SpeechSynthesizer inte skickar utdata från syntesåtgärder till en enhet, fil eller dataström. |
| SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
Konfigurerar objektet SpeechSynthesizer för att lägga till utdata till en Waveform-ljudformatfil i ett angivet format. |
| SetOutputToWaveFile(String) |
Konfigurerar objektet SpeechSynthesizer för att lägga till utdata till en fil som innehåller Ljud i Waveform-format. |
| SetOutputToWaveStream(Stream) |
Konfigurerar objektet SpeechSynthesizer för att lägga till utdata till en ström som innehåller Ljud i Waveform-format. |
| Speak(Prompt) |
Synkront talar innehållet i ett Prompt objekt. |
| Speak(PromptBuilder) |
Synkront talar innehållet i ett PromptBuilder objekt. |
| Speak(String) |
Synkront talar innehållet i en sträng. |
| SpeakAsync(Prompt) |
Asynkront talar innehållet i ett Prompt objekt. |
| SpeakAsync(PromptBuilder) |
Asynkront talar innehållet i ett PromptBuilder objekt. |
| SpeakAsync(String) |
Asynkront talar innehållet i en sträng. |
| SpeakAsyncCancel(Prompt) |
Avbryter den asynkrona syntesåtgärden för en köad fråga. |
| SpeakAsyncCancelAll() |
Avbryter alla köade, asynkrona talsyntesåtgärder. |
| SpeakSsml(String) |
Talar synkront en String som innehåller SSML-markering. |
| SpeakSsmlAsync(String) |
Asynkront talar en String som innehåller SSML-markering. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
Händelser
| Name | Description |
|---|---|
| BookmarkReached |
Upphöjt när ett SpeechSynthesizer bokmärke påträffas i en prompt. |
| PhonemeReached |
Upphöjt när en fonetik nås. |
| SpeakCompleted |
Upphöjt när talet SpeechSynthesizer om en fråga har slutförts. |
| SpeakProgress |
Upphöjt efter talar SpeechSynthesizer varje individ uttrycker av en prompt. |
| SpeakStarted |
Upphöjt när SpeechSynthesizer börjar tala om en uppmaning. |
| StateChanged |
Utlöses när tillståndet för SpeechSynthesizer ändringarna. |
| VisemeReached |
Upphöjt när en viseme nås. |
| VoiceChange |
Upphöjt när rösten ändras SpeechSynthesizer . |