Anleitung
Speech Synthesis in Capacitor nutzen
Auf dem Gerät testen
Lade die Capgo App herunter und scanne den QR code.
Verwendung von @capgo/capacitor-speech-synthesis
Speech Synthesis Plugin zur Sprachsynthese aus Text.
Installieren
bun add @capgo/capacitor-speech-synthesis
bunx cap sync
bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.
Importieren
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
speak |
Spricht den angegebenen Text mit den gewählten Optionen aus. Die Sprachausgabe wird der Warteschlange hinzugefügt. |
synthesizeToFile |
Synthetisiert Sprache in eine Audiodatei (nur Android/iOS). Gibt den Pfad der gespeicherten Datei zurück. |
cancel |
Bricht alle geplanten Sprachausgaben ab und stoppt die aktuelle Sprachausgabe. |
pause |
Pausiert die Sprachausgabe sofort. |
resume |
Setzt die pausierte Sprachausgabe fort. |
isSpeaking |
Prüft, ob die Sprachausgabe gerade aktiv ist. |
isAvailable |
Prüft, ob die Sprachausgabe auf dem Gerät verfügbar ist. |
getVoices |
Ruft alle verfügbaren Stimmen ab. |
getLanguages |
Ruft alle verfügbaren Sprachen ab. |
isLanguageAvailable |
Prüft, ob eine bestimmte Sprache verfügbar ist. |
isVoiceAvailable |
Prüft, ob eine bestimmte Stimme verfügbar ist. |
initialize |
Initialisiert die Speech-Synthesis-Engine (iOS-Optimierung). Dies kann die Latenz bei der ersten Sprachausgabe verringern. |
activateAudioSession |
Aktiviert die Audio-Session mit einer spezifischen Kategorie (nur iOS). |
deactivateAudioSession |
Deaktiviert die Audio-Session (nur iOS). |
Beispiele
speak()
Spricht den angegebenen Text mit den gewählten Optionen aus. Die Sprachausgabe wird der Queue hinzugefügt.
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()
Synthetisiert Sprache in eine Audiodatei (nur Android/iOS). Gibt den Dateipfad zurück, unter dem das Audio gespeichert wurde.
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()
Cancels all queued utterances and stops current speech.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.cancel();
pause()
Pausiert die Sprachausgabe sofort.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.pause();
resume()
Setzt die pausierte Sprachausgabe fort.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.resume();
isSpeaking()
Prüft, ob die Speech-Synthesis gerade eine Sprachausgabe tätigt.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const { isSpeaking } = await SpeechSynthesis.isSpeaking();
console.log('Is speaking:', isSpeaking);
Die obige Tabelle listet die 14 Kernmethoden auf. Listener, Version-Helper und der vollständige Contract jeder Methode sind in der GitHub Repository.
Events abonnieren
addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder SpeechSynthesis.removeAllListeners() auf, um alle Listener zu entfernen.
Vollständige Referenz
Weiter mit „Using @capgo/capacitor-speech-synthesis“
Wenn du es nutzt Verwendung von @capgo/capacitor-speech-synthesis Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-speech-synthesis für die Implementierungsdetails in @capgo/capacitor-speech-synthesis, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.