Guida
Come usare Speech Synthesis in Capacitor
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 del file dove è stato salvato l'audio. |
cancel |
Cancella tutte le utterance in coda e interrompe la riproduzione corrente. |
pause |
Mette in pausa immediatamente la riproduzione. |
resume |
Riprende la riproduzione in pausa. |
isSpeaking |
Verifica se la sintesi vocale è attualmente in riproduzione. |
isAvailable |
Verifica se la sintesi vocale è disponibile sul dispositivo. |
getVoices |
Ottiene tutte le voci disponibili. |
getLanguages |
Ottiene tutte le lingue disponibili. |
isLanguageAvailable |
Verifica se una lingua specifica è disponibile. |
isVoiceAvailable |
Verifica se una voce specifica è disponibile. |
initialize |
Inizializza il motore di speech synthesis (ottimizzato per iOS). Riduce 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.
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 del file salvato.
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()
Cancella tutte le utterance in coda e interrompe il parlato corrente.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.cancel();
pause()
Mette in pausa immediatamente il parlato.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.pause();
resume()
Riprende il parlato in pausa.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.resume();
isSpeaking()
Verifica se la speech synthesis è attualmente in esecuzione.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const { isSpeaking } = await SpeechSynthesis.isSpeaking();
console.log('Is speaking:', isSpeaking);
La tabella sopra elenca i 14 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati nel repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando lo schermo viene smontato, o SpeechSynthesis.removeAllListeners() per rimuovere ogni listener.
Riferimento completo
Continua da Usare @capgo/capacitor-speech-synthesis
Se stai usando Usare @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.