Panduan
Cara menggunakan Speech Synthesis di Capacitor
Menggunakan @capgo/capacitor-speech-synthesis
Plugin Speech Synthesis untuk mengubah teks menjadi suara.
Instal
bun add @capgo/capacitor-speech-synthesis
bunx cap sync
bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.
Impor
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
Sekilas tentang API
| Metode | Deskripsi |
|---|---|
speak |
Mengucapkan teks yang diberikan dengan opsi tertentu. Ucapan akan ditambahkan ke antrean suara. |
synthesizeToFile |
Mensintesis suara ke dalam file audio (hanya Android/iOS). Mengembalikan path file tempat audio disimpan. |
cancel |
Membatalkan semua antrean ucapan dan menghentikan suara yang sedang berjalan. |
pause |
Menunda suara secara instan. |
resume |
Melanjutkan suara yang ditunda. |
isSpeaking |
Memeriksa apakah sintesis suara sedang aktif berbicara. |
isAvailable |
Memeriksa apakah sintesis suara tersedia di perangkat. |
getVoices |
Mendapatkan semua pilihan suara yang tersedia. |
getLanguages |
Mendapatkan semua pilihan bahasa yang tersedia. |
isLanguageAvailable |
Memeriksa apakah bahasa tertentu tersedia. |
isVoiceAvailable |
Memeriksa apakah suara tertentu tersedia. |
initialize |
Menginisialisasi engine speech synthesis (optimasi iOS). Ini dapat mengurangi latensi pada request suara pertama. |
activateAudioSession |
Mengaktifkan audio session dengan kategori tertentu (khusus iOS). |
deactivateAudioSession |
Menonaktifkan audio session (khusus iOS). |
Contoh
speak()
Mengucapkan teks yang diberikan dengan opsi tertentu. Utterance akan ditambahkan ke antrean suara.
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()
Melakukan sintesis suara ke file audio (khusus Android/iOS). Mengembalikan path file tempat audio disimpan.
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()
Membatalkan semua antrean utterance dan menghentikan suara yang sedang berjalan.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.cancel();
pause()
Menunda (pause) suara secara instan.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.pause();
resume()
Melanjutkan kembali suara yang sedang dijeda.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.resume();
isSpeaking()
Memeriksa apakah speech synthesis sedang berbicara.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const { isSpeaking } = await SpeechSynthesis.isSpeaking();
console.log('Is speaking:', isSpeaking);
Tabel di atas mencantumkan 14 metode inti. Listener, helper versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.
Dengarkan event
addListener mengembalikan sebuah handle. Panggil handle.remove() saat screen unmount, atau SpeechSynthesis.removeAllListeners() untuk menghapus semua listener.
Referensi lengkap
Lanjutkan dari Menggunakan @capgo/capacitor-speech-synthesis
Jika Anda menggunakan Menggunakan @capgo/capacitor-speech-synthesis untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-speech-synthesis untuk detail implementasi di @capgo/capacitor-speech-synthesis, Panduan Memulai untuk detail implementasi di Getting Started, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin Capacitor oleh Capgo, dan Menambahkan atau Memperbarui Plugin untuk detail implementasi di bagian Menambahkan atau Memperbarui Plugin.