Langsung ke konten utama

Perekam Audio plugin Capacitor

Rekam audio di iOS, Android, dan Web dengan kontrol dan format yang simpel

Instal

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

Panduan

Cara menggunakan Audio Recorder di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

QR pratinjau plugin Audio Recorder code

Menggunakan @capgo/capacitor-audio-recorder

Kontrak plugin Capacitor untuk merekam audio.

Instal

bun add @capgo/capacitor-audio-recorder
bunx cap sync

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

Sekilas tentang API

Metode Deskripsi
startRecording Mulai merekam audio menggunakan mikrofon perangkat.
pauseRecording Jeda rekaman yang sedang berjalan. Hanya tersedia di Android (API 24+), iOS, dan Web.
resumeRecording Lanjutkan kembali rekaman yang sebelumnya dijeda.
stopRecording Hentikan rekaman saat ini dan simpan audio yang direkam.
cancelRecording Batalkan rekaman saat ini dan buang audio yang sudah terekam.
getRecordingStatus Ambil status rekaman saat ini.
getCurrentAmplitude Ambil amplitudo input saat ini (level mikrofon) sebagai angka ternormalisasi dalam [0, 1] range.
checkPermissions Kembalikan status izin saat ini untuk mengakses mikrofon.
requestPermissions Minta izin untuk mengakses mikrofon.

Contoh

startRecording()

Mulai merekam audio menggunakan mikrofon perangkat.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.startRecording();

pauseRecording()

Jeda rekaman yang sedang berjalan. Hanya tersedia di Android (API 24+), iOS, dan Web.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.pauseRecording();

resumeRecording()

Lanjutkan kembali rekaman yang sebelumnya dijeda.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.resumeRecording();

stopRecording()

Hentikan rekaman saat ini dan simpan audio yang direkam.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

const result = await CapacitorAudioRecorder.stopRecording();
console.log(result);

cancelRecording()

Batalkan rekaman saat ini dan buang audio yang sudah terekam.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

await CapacitorAudioRecorder.cancelRecording();

getRecordingStatus()

Dapatkan status rekaman saat ini.

import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';

const result = await CapacitorAudioRecorder.getRecordingStatus();
console.log(result);

Tabel di atas mencantumkan 9 metode inti. Listener, helper versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.

Mendengarkan event

addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-unmount, atau CapacitorAudioRecorder.removeAllListeners() untuk menghapus semua listener.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-audio-recorder

Jika Anda menggunakan Menggunakan @capgo/capacitor-audio-recorder untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan @capgo/capacitor-audio-recorder untuk detail implementasi di @capgo/capacitor-audio-recorder, Panduan Memulai untuk detail implementasi di Getting Started, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, dan Menggunakan @capgo/capacitor-video-player untuk kapabilitas native saat menggunakan @capgo/capacitor-video-player.

FAQ

FAQ plugin Audio Recorder

Bagaimana cara instal plugin Audio Recorder di aplikasi Capacitor?

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

Apakah @capgo/capacitor-audio-recorder kompatibel dengan React, Vue, dan Angular?

Ya. Audio Recorder adalah package 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-audio-recorder?

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-audio-recorder gratis dan open source?

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

Bisakah saya memperbarui code yang menggunakan Audio Recorder 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.

Deploy perubahan Audio Recorder 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