Compétence Edge-TTS
Vue d'ensemble
Générez un audio texte-parole de haute qualité en utilisant le service TTS neuronal de Microsoft Edge via le package npm node-edge-tts. Prend en charge plusieurs langues, voix, ajustement de la vitesse/hauteur et génération de sous-titres.
Démarrage rapide
Lorsque vous détectez une intention TTS à partir de déclencheurs ou d'une demande utilisateur :
- Appelez l'outil tts (intégré à Clawdbot) pour convertir le texte en parole
- L'outil renvoie un chemin MEDIA:
- Clawdbot achemine l'audio vers le canal actuel
// Exemple : Utilisation de l'outil tts intégré
tts("Votre texte à convertir en parole")
// Retourne : MEDIA: /chemin/vers/audio.mp3
Détection des déclencheurs
Reconnaissez le mot-clé "tts" comme demande TTS. La compétence filtre automatiquement les mots-clés liés au TTS du texte avant conversion pour éviter de convertir les mots déclencheurs eux-mêmes en audio.
Personnalisation avancée
Utilisation des scripts Node.js
Pour plus de contrôle, utilisez directement les scripts inclus :
Convertisseur TTS
cd scripts
npm install
node tts-converter.js "Votre texte" --voice fr-FR-DeniseNeural --rate +10% --output sortie.mp3
Options :
--voice, -v: Nom de la voix (par défaut : en-US-AriaNeural)--lang, -l: Code langue (ex. en-US, es-ES)--format, -o: Format de sortie (par défaut : audio-24khz-48kbitrate-mono-mp3)--pitch: Ajustement de hauteur (ex. +10%, -20%, default)--rate, -r: Ajustement du débit (ex. +10%, -20%, default)--volume: Ajustement du volume (ex. +0%, -10%, default)--save-subtitles, -s: Sauvegarder les sous-titres en fichier JSON--output, -f: Chemin du fichier de sortie (par défaut : tts_output.mp3)--proxy, -p: URL du proxy (ex. http://localhost:7890)--timeout: Délai d'attente de la requête en millisecondes (par défaut : 10000)--list-voices, -L: Lister les voix disponibles
Gestionnaire de configuration
cd scripts
npm install
node config-manager.js --set-voice fr-FR-DeniseNeural
node config-manager.js --set-rate +10%
node config-manager.js --get
node config-manager.js --reset
Sélection de voix
Voix courantes (utilisez --list-voices pour la liste complète) :
Anglais :
en-US-MichelleNeural(féminine, naturelle, par défaut)en-US-AriaNeural(féminine, naturelle)en-US-GuyNeural(masculine, naturelle)en-GB-SoniaNeural(féminine, britannique)en-GB-RyanNeural(masculine, britannique)
Autres langues :
es-ES-ElviraNeural(espagnol, Espagne)fr-FR-DeniseNeural(français)de-DE-KatjaNeural(allemand)ja-JP-NanamiNeural(japonais)zh-CN-XiaoxiaoNeural(chinois)ar-SA-ZariyahNeural(arabe)
Directives de débit
Les valeurs de débit utilisent le format pourcentage :
"default": Vitesse normale"-20%"à"-10%": Lent, clair (tutoriels, histoires, accessibilité)"+10%"à"+20%": Légèrement rapide (résumés)"+30%"à"+50%": Rapide (actualités, efficacité)
Formats de sortie
Choisissez la qualité audio en fonction du cas d'utilisation :
audio-24khz-48kbitrate-mono-mp3: Qualité standard (notes vocales, messages)audio-24khz-96kbitrate-mono-mp3: Haute qualité (présentations, contenu)audio-48khz-96kbitrate-stereo-mp3: Très haute qualité (audio professionnel, musique)
Ressources
scripts/tts-converter.js
Script principal de conversion TTS utilisant node-edge-tts. Génère des fichiers audio avec voix, débit, volume, hauteur et format personnalisables. Prend en charge la génération de sous-titres et le listage des voix.
scripts/config-manager.js
Gère les préférences utilisateur persistantes pour les paramètres TTS (voix, langue, format, hauteur, débit, volume). Stocke la configuration dans ~/.tts-config.json.
scripts/package.json
Configuration du package NPM avec dépendance node-edge-tts.
references/node_edge_tts_guide.md
Documentation complète du package npm node-edge-tts comprenant :
- Liste complète des voix par langue
- Options de prosodie (débit, hauteur, volume)
- Exemples d'utilisation (CLI et Module)
- Génération de sous-titres
- Formats de sortie
- Bonnes pratiques et limitations
Test de voix
Testez différentes voix et prévisualisez la qualité audio sur : https://tts.travisvn.com/
Référez-vous à cela lorsque vous avez besoin de détails spécifiques sur les voix ou de fonctionnalités avancées.
Installation
Pour utiliser les scripts fournis :
cd /home/user/clawd/skills/public/tts-skill/scripts
npm install
Ceci installe :
node-edge-tts- Bibliothèque TTScommander- Analyse d'arguments CLI
Workflow
- Détection d'intention : Vérifiez la présence du mot-clé "tts" dans le message utilisateur
- Choix de la méthode : Utilisez l'outil intégré
ttspour les requêtes simples, ouscripts/tts-converter.jspour la personnalisation - Génération audio : Convertissez le texte cible (message, résultats de recherche, résumé)
- Retour à l'utilisateur : L'outil tts renvoie un chemin MEDIA: ; Clawdbot gère la livraison
Test
Test basique
Exécutez le script de test pour vérifier le fonctionnement du TTS :
cd /home/user/clawd/skills/public/edge-tts/scripts
npm test
Ceci génère un fichier audio de test et vérifie que le service TTS fonctionne.
Test de voix
Testez différentes voix et prévisualisez la qualité audio sur : https://tts.travisvn.com/
Test d'intégration
Utilisez l'outil intégré tts pour un test rapide :
// Exemple : Test TTS avec les paramètres par défaut
tts("Ceci est un test de la fonctionnalité TTS.")
Test de configuration
Vérifiez la persistance de la configuration :
cd /home/user/clawd/skills/public/edge-tts/scripts
node config-manager.js --get
node config-manager.js --set-voice en-US-GuyNeural
node config-manager.js --get
Dépannage
- Testez la connectivité : Exécutez
npm testpour vérifier si le service TTS est accessible - Vérifiez la disponibilité des voix : Utilisez
node tts-converter.js --list-voicespour voir les voix disponibles - Vérifiez les paramètres de proxy : Si vous utilisez un proxy, testez avec
node tts-converter.js "test" --proxy http://localhost:7890 - Vérifiez la sortie audio : Le test doit générer
test-output.mp3dans le répertoire des scripts
Remarques
- node-edge-tts utilise le service TTS en ligne de Microsoft Edge (authentification mise à jour et fonctionnelle)
- Aucune clé API nécessaire (service gratuit)
- La sortie est au format MP3 par défaut
- Nécessite une connexion Internet
- Prend en charge la génération de sous-titres (format JSON avec chronométrage mot par mot)
- Gestion des fichiers temporaires : Par défaut, les fichiers audio sont sauvegardés dans le répertoire temporaire du système (
/tmp/edge-tts-temp/sur Unix,C:\Users\<utilisateur>\AppData\Local\Temp\edge-tts-temp\sur Windows) avec des noms de fichiers uniques (ex.tts_1234567890_abc123.mp3). Les fichiers ne sont pas supprimés automatiquement - l'application appelante (Clawdbot) doit gérer le nettoyage après utilisation. Vous pouvez spécifier un chemin de sortie personnalisé avec l'option--outputsi un stockage permanent est nécessaire. - Filtrage des mots-clés TTS : La compétence filtre automatiquement les mots-clés liés au TTS (tts, TTS, text-to-speech) du texte avant conversion pour éviter de convertir les mots déclencheurs eux-mêmes en audio
- Pour des préférences récurrentes, utilisez
config-manager.jspour définir les valeurs par défaut - Voix par défaut :
en-US-MichelleNeural(féminine, naturelle) - Les voix neuronales (se terminant par
Neural) offrent une qualité supérieure aux voix Standard