Panduan
Cara menggunakan Sintesis Suara di Capacitor
Menggunakan @capgo/capacitor-sintesis-suara
Plugin Sintesis Suara untuk mensintesis suara dari teks.
Install
bun add @capgo/capacitor-speech-synthesis
bunx cap sync
bunx cap sync mengcopy kode native code plugin ke proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.
Import
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
Panduan API
| Metode | Deskripsi |
|---|---|
speak |
Mengucapkan teks yang diberikan dengan pilihan tertentu. Utaranya ditambahkan ke dalam antrian bicara. |
synthesizeToFile |
Menghasilkan suara bicara ke dalam file audio (hanya Android/iOS). Mengembalikan jalur file tempat suara disimpan. |
cancel |
Membatalkan semua pernyataan yang ditunggu dan menghentikan percakapan saat ini. |
pause |
Menghentikan bicara secara langsung. |
resume |
Mengaktifkan kembali bicara yang telah dihentikan. |
isSpeaking |
Memeriksa apakah sintesis bicara sedang berbicara. |
isAvailable |
Memeriksa apakah sintesis bicara tersedia di perangkat. |
getVoices |
Mengambil semua suara yang tersedia. |
getLanguages |
Mengambil semua bahasa yang tersedia. |
isLanguageAvailable |
Memeriksa apakah bahasa tertentu tersedia. |
isVoiceAvailable |
Memeriksa apakah suara tertentu tersedia. |
initialize |
Menginisialisasi mesin sintesis suara (optimasi iOS). Ini dapat mengurangi latensi untuk permintaan suara pertama. |
activateAudioSession |
Mengaktifkan sesi audio dengan kategori tertentu (hanya iOS). |
deactivateAudioSession |
Menghentikan sesi audio (hanya iOS). |
Contoh
speak()
Mengucapkan teks yang diberikan dengan pilihan tertentu. Utterance ditambahkan ke antrian 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()
Menghasilkan suara ke dalam file audio (hanya Android dan iOS). Mengembalikan jalur 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 utterance yang ditunggu dan menghentikan suara saat ini.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.cancel();
pause()
Menghentikan suara secara langsung.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.pause();
resume()
Mengaktifkan kembali suara yang terhenti.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.resume();
isSpeaking()
Mengecek apakah sintesis suara sedang berbicara.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const { isSpeaking } = await SpeechSynthesis.isSpeaking();
console.log('Is speaking:', isSpeaking);
Daftar di atas menampilkan 14 metode inti. Bantuan listener dan versi, serta kontrak lengkap dari setiap metode, dapat dilihat dalam repository GitHub.
Dengarkan event
addListener mengembalikan sebuah handle. Panggil handle.remove() ketika layar dihapus, atau SpeechSynthesis.removeAllListeners() untuk menghapus setiap pendengar.
Referensi lengkap
Teruskan dari Menggunakan @capgo/capacitor-speech-synthesis
Menggunakan @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-speech-synthesis Menggunakan @capgo/capacitor-speech-synthesis untuk merencanakan pekerjaan plugin native, hubungkannya dengan di @capgo/capacitor-speech-synthesis untuk detail implementasi di @capgo/capacitor-speech-synthesis Mulai Menggunakan untuk detail implementasi di Pemula Daftar Plugin @Capgo untuk alur kerja produk di Daftar Plugin @Capgo Plugin @Capacitor oleh @Capgo untuk detail implementasi di Plugin @Capacitor oleh @Capgo, dan Menginstal atau Mengupdate Plugin untuk detail implementasi di Menginstal atau Mengupdate Plugin.