Langsung ke konten utama

Sintesis Ucapan plugin Capacitor

Ubah teks jadi suara dengan kontrol penuh atas bahasa, jenis suara, pitch, rate, dan volume.

Instal

bun add @capgo/capacitor-speech-synthesis bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-speech-synthesis
  • pnpm add @capgo/capacitor-speech-synthesis
  • yarn add @capgo/capacitor-speech-synthesis

Panduan

Cara menggunakan Speech Synthesis di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

Pratinjau plugin Speech Synthesis QR code

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 yang ditentukan. Utterance ditambahkan ke antrean speech.
synthesizeToFile Mensintesis ucapan 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 Menjeda speech saat itu juga.
resume Melanjutkan speech yang dijeda.
isSpeaking Memeriksa apakah speech synthesis sedang berbicara.
isAvailable Memeriksa apakah speech synthesis tersedia di perangkat.
getVoices Mendapatkan semua voice yang tersedia.
getLanguages Mendapatkan semua 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 speech pertama.
activateAudioSession Mengaktifkan audio session dengan kategori tertentu (khusus iOS).
deactivateAudioSession Menonaktifkan audio session (khusus iOS).

Contoh

speak()

Mengucapkan teks yang diberikan dengan opsi yang ditentukan. Utterance ditambahkan ke antrean speech.

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()

Mensintesis ucapan ke dalam file audio (hanya 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 speech yang sedang berjalan.

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

await SpeechSynthesis.cancel();

pause()

Menjeda speech saat itu juga.

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

await SpeechSynthesis.pause();

resume()

Melanjutkan speech yang 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. Helper listener, versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.

Mendengarkan event

addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-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.

FAQ

FAQ plugin Speech Synthesis

Bagaimana cara instal plugin Speech Synthesis di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-speech-synthesis" (atau "npm install @capgo/capacitor-speech-synthesis"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Impor dari "@capgo/capacitor-speech-synthesis" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-speech-synthesis bisa digunakan dengan React, Vue, dan Angular?

Ya. Speech Synthesis adalah paket Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-speech-synthesis?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-speech-synthesis gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-speech-synthesis/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan pull request sangat kami terima.

Bisakah saya memperbarui code yang menggunakan Speech Synthesis tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Speech Synthesis tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo