SpeechSynthesizer Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapewnia dostęp do funkcji zainstalowanego aparatu syntezy mowy.
public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
- Dziedziczenie
-
SpeechSynthesizer
- Implementuje
Przykłady
Poniższy przykład jest częścią aplikacji konsolowej, która inicjuje SpeechSynthesizer obiekt i mówi ciąg.
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();
}
}
}
Uwagi
Podczas tworzenia nowego SpeechSynthesizer obiektu używa on domyślnego głosu systemowego. Aby skonfigurować SpeechSynthesizer jedną z zainstalowanych głosów syntezy mowy (zamiana tekstu na mowę), użyj SelectVoice metody or SelectVoiceByHints . Aby uzyskać informacje o instalowanych głosach, użyj GetInstalledVoices metody i VoiceInfo klasy .
Ta klasa zapewnia również kontrolę nad następującymi aspektami syntezy mowy:
Aby skonfigurować dane wyjściowe dla SpeechSynthesizer obiektu, użyj SetOutputToAudioStreammetod , SetOutputToDefaultAudioDevice, SetOutputToNulli SetOutputToWaveFile .
Aby wygenerować mowę Speak, użyj metody , SpeakAsync, SpeakSsmllub SpeakSsmlAsync . Może SpeechSynthesizer tworzyć mowę Prompt z tekstu, obiektu lub PromptBuilder obiektu lub z języka znaczników syntezy mowy (SSML) w wersji 1.0.
Aby wstrzymać i wznowić syntezę Pause mowy, użyj metod i Resume .
Aby dodać lub usunąć leksykony, użyj AddLexicon metod i RemoveLexicon . Może SpeechSynthesizer używać jednego lub kilku leksykonów do kierowania wymową słów.
Aby zmodyfikować dostarczanie danych wyjściowych mowy, użyj Rate właściwości i Volume .
Funkcja SpeechSynthesizer zgłasza zdarzenia, gdy napotka pewne funkcje w monitach: (BookmarkReached, PhonemeReached, VisemeReachedi SpeakProgress). Zgłasza również zdarzenia, które zgłaszają początek () i koniec (SpeakStartedSpeakCompleted) operacji mówienia oraz zmianę głosu mówiącego (VoiceChange).
Uwaga
Przed wydaniem ostatniego odwołania do elementu należy zawsze wywołać metodę DisposeSpeechSynthesizer. W przeciwnym razie zasoby, których używasz, nie zostaną zwolnione do momentu wywołania SpeechSynthesizer metody obiektu przez moduł odśmieceń Finalize pamięci.
Konstruktory
SpeechSynthesizer() |
Inicjuje nowe wystąpienie klasy SpeechSynthesizer. |
Właściwości
Rate |
Pobiera lub ustawia wskaźnik SpeechSynthesizer mówienia obiektu. |
State |
Pobiera bieżący stan obiektu mówiącego SpeechSynthesizer . |
Voice |
Pobiera informacje o bieżącym głosie SpeechSynthesizer obiektu. |
Volume |
Pobierz lub ustawia wolumin SpeechSynthesizer wyjściowy obiektu. |
Metody
AddLexicon(Uri, String) |
Dodaje leksykon do SpeechSynthesizer obiektu. |
Dispose() |
SpeechSynthesizer Usuwa obiekt i zwalnia zasoby używane podczas sesji. |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
Finalize() |
Działa jako zabezpieczenie w celu oczyszczenia zasobów w przypadku, gdy metoda nie jest wywoływana Dispose() . |
GetCurrentlySpokenPrompt() |
Pobiera monit, że SpeechSynthesizer mówi. |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetInstalledVoices() |
Zwraca wszystkie zainstalowane głosy syntezy mowy (zamiana tekstu na mowę). |
GetInstalledVoices(CultureInfo) |
Zwraca wszystkie zainstalowane głosy syntezy mowy (zamiana tekstu na mowę), które obsługują określone ustawienia regionalne. |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
Pause() |
Wstrzymuje SpeechSynthesizer obiekt. |
RemoveLexicon(Uri) |
Usuwa leksykon z SpeechSynthesizer obiektu. |
Resume() |
Wznawia obiekt po jego wstrzymaniu SpeechSynthesizer . |
SelectVoice(String) |
Wybiera określony głos według nazwy. |
SelectVoiceByHints(VoiceGender) |
Wybiera głos z określoną płcią. |
SelectVoiceByHints(VoiceGender, VoiceAge) |
Wybiera głos z określoną płcią i wiekiem. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Wybiera głos z określoną płcią i wiekiem, na podstawie pozycji, w której są uporządkowane głosy. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Wybiera głos z określoną płcią, wiekiem i ustawieniami regionalnymi na podstawie pozycji, w której są uporządkowane głosy. |
SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Konfiguruje obiekt w SpeechSynthesizer celu dołączenia danych wyjściowych do strumienia audio. |
SetOutputToDefaultAudioDevice() |
Konfiguruje SpeechSynthesizer obiekt do wysyłania danych wyjściowych do domyślnego urządzenia audio. |
SetOutputToNull() |
Konfiguruje SpeechSynthesizer obiekt tak, aby nie wysyłał danych wyjściowych z operacji syntezy do urządzenia, pliku lub strumienia. |
SetOutputToWaveFile(String) |
Konfiguruje obiekt w SpeechSynthesizer celu dołączenia danych wyjściowych do pliku zawierającego dźwięk formatu Waveform. |
SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
Konfiguruje obiekt w SpeechSynthesizer celu dołączenia danych wyjściowych do pliku formatu audio Waveform w określonym formacie. |
SetOutputToWaveStream(Stream) |
Konfiguruje obiekt w SpeechSynthesizer celu dołączenia danych wyjściowych do strumienia zawierającego dźwięk formatu Waveform. |
Speak(Prompt) |
Synchronicznie mówi zawartość Prompt obiektu. |
Speak(PromptBuilder) |
Synchronicznie mówi zawartość PromptBuilder obiektu. |
Speak(String) |
Synchronicznie mówi zawartość ciągu. |
SpeakAsync(Prompt) |
Asynchronicznie mówi zawartość Prompt obiektu. |
SpeakAsync(PromptBuilder) |
Asynchronicznie mówi zawartość PromptBuilder obiektu. |
SpeakAsync(String) |
Asynchronicznie mówi zawartość ciągu. |
SpeakAsyncCancel(Prompt) |
Anuluje operację syntezy asynchronicznej dla wiersza w kolejce. |
SpeakAsyncCancelAll() |
Anuluje wszystkie operacje syntezy mowy w kolejce, asynchroniczne. |
SpeakSsml(String) |
Synchronicznie mówi, String że zawiera znacznikI SSML. |
SpeakSsmlAsync(String) |
Asynchronicznie mówi, String że zawiera znacznikI SSML. |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Zdarzenia
BookmarkReached |
Podniesione, gdy napotka SpeechSynthesizer zakładkę w wierszu polecenia. |
PhonemeReached |
Podniesione, gdy osiągnięto telefon. |
SpeakCompleted |
Podniesione po zakończeniu SpeechSynthesizer wypowiedzi monitu. |
SpeakProgress |
Podniesione SpeechSynthesizer po mówieniu każdego pojedynczego słowa monitu. |
SpeakStarted |
Podniesione SpeechSynthesizer , gdy rozpoczyna się mówienie o monitie. |
StateChanged |
Podniesione, gdy stan SpeechSynthesizer zmian. |
VisemeReached |
Podniesione po osiągnięciu wizem. |
VoiceChange |
Podniesione, gdy głos SpeechSynthesizer zmian. |