Salta al contenuto principale

Sintesi vocale Plugin Capacitor

Sintetizza il parlato dal testo con controllo completo su lingua, voce, tono, velocità e volume.

Installa

bun add @capgo/capacitor-speech-synthesis bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-speech-synthesis
  • pnpm add @capgo/capacitor-speech-synthesis
  • yarn add @capgo/capacitor-speech-synthesis

Guida

Come usare Speech Synthesis in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

Anteprima plugin Speech Synthesis QR code

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.

FAQ

FAQ sul plugin Speech Synthesis

Come installo il plugin Speech Synthesis in un'app Capacitor?

Esegui "bun add @capgo/capacitor-speech-synthesis" (o "npm install @capgo/capacitor-speech-synthesis"), poi lancia "bunx cap sync" per aggiornare i progetti iOS e Android con le code native. Importalo da "@capgo/capacitor-speech-synthesis" nel code della tua app.

@capgo/capacitor-speech-synthesis funziona con React, Vue e Angular?

Sì. Speech Synthesis è un pacchetto Capacitor, quindi funziona con qualsiasi framework web in esecuzione su Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-speech-synthesis?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-speech-synthesis è free e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-speech-synthesis/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa Speech Synthesis senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica le modifiche a Speech Synthesis senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo