SpeechSynthesizer Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce l'accesso alle funzionalità di un motore di sintesi vocale installato.
public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
- Ereditarietà
-
SpeechSynthesizer
- Implementazioni
Esempio
L'esempio seguente fa parte di un'applicazione console che inizializza un SpeechSynthesizer oggetto e parla una stringa.
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();
}
}
}
Commenti
Quando si crea un nuovo SpeechSynthesizer oggetto, usa la voce di sistema predefinita. Per configurare l'oggetto SpeechSynthesizer per usare una delle voci di sintesi vocale installate (sintesi vocale) installate, usare il SelectVoice metodo o SelectVoiceByHints . Per ottenere informazioni sulle voci installate, usare il GetInstalledVoices metodo e la VoiceInfo classe.
Questa classe fornisce anche il controllo sugli aspetti seguenti della sintesi vocale:
Per configurare l'output per l'oggetto SpeechSynthesizer , usare i SetOutputToAudioStreammetodi , SetOutputToDefaultAudioDevice, SetOutputToNulle SetOutputToWaveFile .
Per generare la voce, usare il Speakmetodo , SpeakAsync, SpeakSsmlo SpeakSsmlAsync . L'oggetto SpeechSynthesizer può produrre voce da testo, oggetto Prompt o PromptBuilder da Speech Synthesis Markup Language (SSML) versione 1.0.
Per sospendere e riprendere la sintesi vocale, usare i Pause metodi e Resume .
Per aggiungere o rimuovere i lessici, usare i AddLexicon metodi e RemoveLexicon . Può SpeechSynthesizer usare uno o più leconi per guidare la pronuncia delle parole.
Per modificare il recapito dell'output vocale, usare le Rate proprietà e Volume .
Genera SpeechSynthesizer eventi quando rileva determinate funzionalità nei prompt: (BookmarkReached, PhonemeReached, VisemeReachede SpeakProgress). Genera anche eventi che segnalano l'inizio () e la fine (SpeakStartedSpeakCompleted) delle operazioni di parla e sulla modifica della voce di parlato (VoiceChange).
Nota
Chiamare sempre il metodo Dispose prima di rilasciare l'ultimo riferimento a SpeechSynthesizer. In caso contrario, le risorse utilizzate non verranno liberate finché il metodo SpeechSynthesizer dell'oggetto Finalize non viene richiamato dal Garbage Collector.
Costruttori
SpeechSynthesizer() |
Inizializza una nuova istanza della classe SpeechSynthesizer. |
Proprietà
Rate |
Ottiene o imposta la velocità di pronuncia dell'oggetto SpeechSynthesizer. |
State |
Ottiene lo stato di pronuncia dell'oggetto SpeechSynthesizer. |
Voice |
Ottiene informazioni sulla voce corrente dell'oggetto SpeechSynthesizer. |
Volume |
Ottiene o imposta il volume di output dell'oggetto SpeechSynthesizer. |
Metodi
AddLexicon(Uri, String) |
Aggiunge un lessico all'oggetto SpeechSynthesizer. |
Dispose() |
Elimina l'oggetto SpeechSynthesizer e rilascia le risorse usate durante la sessione. |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
Finalize() |
Agisce da misura di sicurezza per la pulizia delle risorse nel caso in cui il metodo Dispose() non venga chiamato. |
GetCurrentlySpokenPrompt() |
Ottiene il prompt che SpeechSynthesizer sta parlando. |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetInstalledVoices() |
Restituisce tutte le voci di sintesi vocale installate. |
GetInstalledVoices(CultureInfo) |
Restituisce tutte le voci di sintesi vocale installate (sintesi vocale) che supportano impostazioni locali specifiche. |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
Pause() |
Mette in pausa l'oggetto SpeechSynthesizer. |
RemoveLexicon(Uri) |
Rimuove un lessico dall'oggetto SpeechSynthesizer. |
Resume() |
Riprende l'oggetto SpeechSynthesizer dopo che è stato messo in pausa. |
SelectVoice(String) |
Seleziona una voce specifica per nome. |
SelectVoiceByHints(VoiceGender) |
Seleziona una voce con genere specifico. |
SelectVoiceByHints(VoiceGender, VoiceAge) |
Seleziona una voce con genere ed età specifici. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32) |
Seleziona una voce con genere ed età specifici, in base alla posizione in cui le voci sono ordinate. |
SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) |
Seleziona una voce con genere, età e impostazioni locali specifici, in base alla posizione in cui le voci sono ordinate. |
SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) |
Configura l'oggetto SpeechSynthesizer per aggiungere l'output a un flusso audio. |
SetOutputToDefaultAudioDevice() |
Configura l'oggetto SpeechSynthesizer per inviare l'output al dispositivo audio predefinito. |
SetOutputToNull() |
Configura l'oggetto SpeechSynthesizer per non inviare l'output dalle operazioni di sintesi di un dispositivo, file o flusso. |
SetOutputToWaveFile(String) |
Configura l'oggetto SpeechSynthesizer per aggiungere l'output a un file che contiene l'audio in formato Waveform. |
SetOutputToWaveFile(String, SpeechAudioFormatInfo) |
Configura l'oggetto SpeechSynthesizer per aggiungere l'output a un file in formato audio Waveform in un formato specificato. |
SetOutputToWaveStream(Stream) |
Configura l'oggetto SpeechSynthesizer per aggiungere l'output a un flusso che contiene l'audio in formato Waveform. |
Speak(Prompt) |
In modo sincrono sul contenuto di un oggetto di Prompt. |
Speak(PromptBuilder) |
In modo sincrono sul contenuto di un oggetto di PromptBuilder. |
Speak(String) |
In modo sincrono legge il contenuto di una stringa. |
SpeakAsync(Prompt) |
In modo asincrono legge il contenuto di un oggetto di Prompt. |
SpeakAsync(PromptBuilder) |
In modo asincrono legge il contenuto di un oggetto di PromptBuilder. |
SpeakAsync(String) |
In modo asincrono legge il contenuto di una stringa. |
SpeakAsyncCancel(Prompt) |
Annulla l'operazione asincrona di sintesi per una richiesta in coda. |
SpeakAsyncCancelAll() |
Annulla tutte le operazioni asincrone di sintesi vocale in coda. |
SpeakSsml(String) |
In modo sincrono legge un oggetto String che contiene il markup SSML. |
SpeakSsmlAsync(String) |
In modo asincrono legge un String che contiene il markup SSML. |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Eventi
BookmarkReached |
Generato quando SpeechSynthesizer rileva un segnalibro in un prompt. |
PhonemeReached |
Generato quando viene raggiunto un fonema. |
SpeakCompleted |
Generato quando SpeechSynthesizer completa la pronuncia di un prompt. |
SpeakProgress |
Generato dopo la pronuncia di ogni singola parola di un prompt da parte di SpeechSynthesizer. |
SpeakStarted |
Generato quando SpeechSynthesizer inizia a pronunciare un prompt. |
StateChanged |
Generato alla modifica dello stato di SpeechSynthesizer. |
VisemeReached |
Generato quando viene raggiunto un viseme. |
VoiceChange |
Generato alla modifica della voce di SpeechSynthesizer. |