Anleitung
Speech Synthesis in Capacitor nutzen
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 angegebenen Optionen. Die Äußerung wird der Sprachwarteschlange hinzugefügt. |
synthesizeToFile |
Synthetisiert Sprache in eine Audiodatei (nur Android/iOS). Gibt den Dateipfad zurück, unter dem das Audio gespeichert wurde. |
cancel |
Bricht alle wartenden Sprachausgaben ab und stoppt die aktuelle Ausgabe. |
pause |
Pausiert die Sprachausgabe sofort. |
resume |
Setzt die pausierte Sprachausgabe fort. |
isSpeaking |
Prüft, ob die Sprachausgabe gerade aktiv ist. |
isAvailable |
Prüft, ob Speech Synthesis 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). Das kann die Latenz bei der ersten Sprachausgabe-Anfrage reduzieren. |
activateAudioSession |
Aktiviert die Audio-Session mit einer bestimmten Kategorie (nur iOS). |
deactivateAudioSession |
Deaktiviert die Audio-Session (nur iOS). |
Beispiele
speak()
Spricht den angegebenen Text mit den angegebenen Optionen. Die Äußerung wird der Sprachwarteschlange 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()
Bricht alle wartenden Sprachausgaben ab und stoppt die aktuelle Ausgabe.
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 Sprachausgabe gerade aktiv ist.
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- und Versions-Helper sowie 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 das Implementierungsdetail 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.