Utilizzo di @capgo/capacitor-speech-synthesis
Plugin Speech Synthesis per la sintesi vocale da testo.
Installa
bun add @capgo/capacitor-speech-synthesis
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
API in breve
| Metodo | Descrizione |
|---|---|
speak |
Riproduce il testo fornito con le opzioni specificate. L'utterance viene aggiunta alla coda di riproduzione. |
synthesizeToFile |
Sintetizza il parlato in un file audio (solo Android/iOS). Restituisce il percorso in cui è stato salvato l'audio. |
cancel |
Annulla tutte le utterance in coda e interrompe la riproduzione in corso. |
pause |
Mette subito in pausa la riproduzione. |
resume |
Riprende la riproduzione dopo la pausa. |
isSpeaking |
Verifica se la sintesi vocale è in corso. |
isAvailable |
Verifica se la sintesi vocale è disponibile sul dispositivo. |
getVoices |
Recupera tutte le voci disponibili. |
getLanguages |
Recupera tutte le lingue disponibili. |
isLanguageAvailable |
Verifica se una lingua specifica è disponibile. |
isVoiceAvailable |
Verifica se una voce specifica è disponibile. |
initialize |
Inizializza il motore di sintesi vocale (ottimizzazione iOS). Può ridurre la latenza della prima richiesta vocale. |
activateAudioSession |
Attiva la sessione audio con una categoria specifica (solo iOS). |
deactivateAudioSession |
Disattiva la sessione audio (solo iOS). |
Esempi
speak()
Riproduce il testo fornito con le opzioni specificate. L'utterance viene aggiunta alla coda di riproduzione.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const result = await SpeechSynthesis.speak({
text: 'Hello, world!',
language: 'en-US',
rate: 1.0,
pitch: 1.0,
volume: 1.0,
queueStrategy: 'Add'
});
console.log('Utterance ID:', result.utteranceId);
synthesizeToFile()
Sintetizza il parlato in un file audio (solo Android/iOS). Restituisce il percorso in cui è stato salvato l'audio.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const result = await SpeechSynthesis.synthesizeToFile({
text: 'Hello, world!',
language: 'en-US'
});
console.log('Audio file saved at:', result.filePath);
cancel()
Annulla tutte le utterance in coda e interrompe la riproduzione in corso.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.cancel();
pause()
Mette subito in pausa la riproduzione.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.pause();
resume()
Riprende la riproduzione dopo la pausa.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.resume();
isSpeaking()
Verifica se la sintesi vocale è in corso.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const { isSpeaking } = await SpeechSynthesis.isSpeaking();
console.log('Is speaking:', isSpeaking);
La tabella sopra elenca i 14 metodi principali. I listener e gli helper di versione, insieme al contratto completo di ogni metodo, sono documentati nella repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o SpeechSynthesis.removeAllListeners() per rimuovere tutti i listener.
Riferimento completo
Continua dall'utilizzo di @capgo/capacitor-speech-synthesis
Se stai usando Utilizzo di @capgo/capacitor-speech-synthesis per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-speech-synthesis per i dettagli di implementazione in @capgo/capacitor-speech-synthesis, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.