Vai al contenuto

@capgo/capacitor-speech-synthesis

Leggi ad alta voce un testo o esportalo in un file, con controllo di voce, velocità, tono e lingua.

@capgo/capacitor-speech-synthesis gestisce il motore text-to-speech della piattaforma per l'accessibilità, l'apprendimento linguistico e la navigazione hands-free. Scegli una voce, regola velocità e tono, metti in pausa o riprendi passaggi lunghi e genera file audio su iOS e Android per la riproduzione offline.

Chiama initialize() su iOS per una prima sintesi vocale più rapida, e activateAudioSession() quando serve una specifica categoria audio iOS.

PiattaformaSupportoNote
iOSSìAVSpeechSynthesizer, helper per la sessione audio
AndroidSìMotore TTS Android
WebParzialeSintesi vocale del browser, dove disponibile
  • speak - Legge il testo fornito con le opzioni specificate. L'enunciato viene aggiunto alla coda del parlato.
  • synthesizeToFile - Sintetizza il parlato in un file audio (solo Android/iOS). Restituisce il percorso del file in cui è stato salvato l'audio.
  • cancel - Annulla tutti gli enunciati in coda e interrompe il parlato corrente.
  • pause - Mette in pausa immediatamente il parlato.
MetodoDescrizione
speakRiproduce il testo fornito con le opzioni specificate. L'utterance viene aggiunta alla coda di riproduzione.
synthesizeToFileSintetizza il parlato in un file audio (solo Android/iOS). Restituisce il percorso in cui è stato salvato l'audio.
cancelAnnulla tutte le utterance in coda e interrompe la riproduzione in corso.
pauseMette subito in pausa la riproduzione.
resumeRiprende la riproduzione dopo la pausa.
isSpeakingVerifica se la sintesi vocale è in corso.
isAvailableVerifica se la sintesi vocale è disponibile sul dispositivo.
getVoicesRecupera tutte le voci disponibili.
getLanguagesRecupera tutte le lingue disponibili.
isLanguageAvailableVerifica se una lingua specifica è disponibile.
isVoiceAvailableVerifica se una voce specifica è disponibile.
initializeInizializza il motore di sintesi vocale (ottimizzazione iOS). Può ridurre la latenza della prima richiesta vocale.
activateAudioSessionAttiva la sessione audio con una categoria specifica (solo iOS).
deactivateAudioSessionDisattiva la sessione audio (solo iOS).
getPluginVersionRestituisce la versione del plugin nativo.
addListenerAscolta quando inizia la pronuncia di un utterance.
addListenerAscolta quando termina la pronuncia di un utterance.
addListenerAscolta i confini di parola durante la sintesi vocale.
addListenerAscolta gli errori di sintesi.
removeAllListenersRimuove tutti gli event listener.

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-speech-synthesis.

Se stai usando @capgo/capacitor-speech-synthesis per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo di @capgo/capacitor-speech-synthesis per la funzionalità nativa in Utilizzo di @capgo/capacitor-speech-synthesis, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.