Guide
Comment utiliser Speech Synthesis dans Capacitor
Utilisation de @capgo/capacitor-speech-synthesis
Plugin Speech Synthesis pour la synthèse vocale à partir de texte.
Installer
bun add @capgo/capacitor-speech-synthesis
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.
Importer
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
Aperçu de API
| Méthode | Description |
|---|---|
speak |
Lit le texte fourni avec les options spécifiées. L'énoncé est ajouté à la file d'attente de synthèse vocale. |
synthesizeToFile |
Synthétise la parole dans un fichier audio (Android/iOS uniquement). Renvoie le chemin du fichier où l'audio a été sauvegardé. |
cancel |
Annule toutes les expressions en attente et arrête la lecture en cours. |
pause |
Met la lecture en pause immédiatement. |
resume |
Reprend la lecture en pause. |
isSpeaking |
Vérifie si la synthèse vocale est en cours de lecture. |
isAvailable |
Vérifie si la synthèse vocale est disponible sur l'appareil. |
getVoices |
Récupère toutes les voix disponibles. |
getLanguages |
Récupère toutes les langues disponibles. |
isLanguageAvailable |
Vérifie si une langue spécifique est disponible. |
isVoiceAvailable |
Vérifie si une voix spécifique est disponible. |
initialize |
Initialise le moteur de synthèse vocale (optimisation iOS). Cela peut réduire la latence lors de la première requête vocale. |
activateAudioSession |
Active la session audio avec une catégorie spécifique (iOS uniquement). |
deactivateAudioSession |
Désactive la session audio (iOS uniquement). |
Exemples
speak()
Prononce le texte fourni avec les options spécifiées. L'énoncé est ajouté à la file d'attente vocale.
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()
Synthétise la parole dans un fichier audio (Android/iOS uniquement). Renvoie le chemin du fichier où l'audio a été sauvegardé.
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()
Annule toutes les expressions en attente et arrête la lecture en cours.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.cancel();
pause()
Met la parole en pause immédiatement.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.pause();
resume()
Reprend la parole en pause.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.resume();
isSpeaking()
Vérifie si la synthèse vocale est en train de parler.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const { isSpeaking } = await SpeechSynthesis.isSpeaking();
console.log('Is speaking:', isSpeaking);
Le tableau ci-dessus liste les 14 méthodes principales. Les helpers de version et de listener, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.
Écouter les événements
addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou SpeechSynthesis.removeAllListeners() pour supprimer tous les listeners.
Référence complète
Continuer à partir de « Utiliser @capgo/capacitor-speech-synthesis »
Si vous utilisez Utiliser @capgo/capacitor-speech-synthesis pour planifier le travail sur les plugins natifs, connectez-l’à @capgo/capacitor-speech-synthesis pour les détails d'implémentation dans @capgo/capacitor-speech-synthesis, Prise en main pour les détails d'implémentation dans Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.