Langsung ke konten utama
@capgo/capacitor-native-audio Diubah namanya Diubah dari @capgo/native-audio menjadi @capgo/capacitor-native-audio. Media Open source

Native Audio plugin Capacitor

Putar file audio pendek dengan latensi rendah menggunakan native audio engine untuk game dan aplikasi

Instal

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

Panduan

Cara menggunakan Native Audio di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

QR pratinjau plugin Native Audio code

Menggunakan @capgo/capacitor-native-audio

Plugin native untuk native audio engine.

Instal

npm install @capgo/capacitor-native-audio
npx cap sync

Apa yang Diekspos Plugin Ini

  • configure - Konfigurasi audio player.
  • preload - Load file audio.
  • playOnce - Play file audio sekali dengan automatic cleanup.
  • isPreloaded - Cek apakah file audio sudah di-preload.

Contoh Penggunaan

configure

Konfigurasi audio player.

import { NativeAudio } from '@capgo/capacitor-native-audio';

await NativeAudio.configure({
  focus: false,
  background: false,
  ignoreSilent: false,
  showNotification: false,
  backgroundPlayback: false,
});

preload

Muat file audio.

import { NativeAudio } from '@capgo/capacitor-native-audio';

await NativeAudio.preload({
  assetPath: 'path/to/file',
  assetId: 'asset-id-123',
});

playOnce

Putar file audio sekali dengan pembersihan otomatis.

import { NativeAudio } from '@capgo/capacitor-native-audio';

// Simple one-shot playback
await NativeAudio.playOnce({ assetPath: 'audio/notification.mp3' });

// Play and delete the file after completion
await NativeAudio.playOnce({
  assetPath: 'file:///path/to/temp/audio.mp3',
  isUrl: true,
  deleteAfterPlay: true
});

// Get the assetId to control playback
const { assetId } = await NativeAudio.playOnce({
  assetPath: 'audio/long-track.mp3',
  autoPlay: true
});
// Later, you can stop it manually if needed
await NativeAudio.stop({ assetId });

isPreloaded

Cek apakah file audio sudah di-preload.

import { NativeAudio } from '@capgo/capacitor-native-audio';

const result = await NativeAudio.isPreloaded({
  assetPath: 'path/to/file',
  assetId: 'asset-id-123',
});
console.log(result);

Referensi Lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-native-audio

Jika Anda menggunakan Menggunakan @capgo/capacitor-native-audio untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan @capgo/capacitor-native-audio untuk detail implementasi di @capgo/capacitor-native-audio, 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 Native Audio

Bagaimana cara install plugin Native Audio di aplikasi Capacitor?

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

Apakah @capgo/capacitor-native-audio mendukung React, Vue, dan Angular?

Ya. Native Audio adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-native-audio?

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

Ya. Source code tersedia publik di GitHub pada https://github.com/Cap-go/capacitor-native-audio/ dan package ini gratis diinstall dari npm. Laporan bug dan pull request sangat kami terima.

Bisakah saya update code yang menggunakan Native Audio 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 Native Audio 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