Langkah ke Konten Utama
@capgo/capacitor-native-audio Diubah Diubah dari @capgo/native-audio menjadi @capgo/capacitor-native-audio. Media Buka

Plugin Audio Nadi __CAPGO_KEEP_0__ Plugin Capacitor

Bermain file audio pendek dengan latensi rendah menggunakan mesin audio native untuk permainan dan aplikasi

Install

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

Berguna untuk Menggunakan Audio Nativ di Capacitor

Menggunakan @capgo/capacitor-native-audio

Plugin natif untuk mesin audio natif.

Pasang

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

Apa yang Dibuka oleh Plugin Ini

  • configure - Konfigurasi pemutar audio.
  • preload - Muat file audio.
  • playOnce - Mainkan file audio sekali dengan membersihkan secara otomatis.
  • isPreloaded - Periksa jika file audio telah dimuat sebelumnya.

Penggunaan Contoh

configure

Konfigurasi pemutar audio.

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

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

preload

Pemuatan file audio.

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

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

playOnce

Mainkan 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

Periksa jika file audio telah dipemuat.

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

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

Pengacuan Lengkap

Teruskan dari Menggunakan @capgo/capacitor-native-audio

Jika Anda menggunakan Menggunakan @capgo/capacitor-native-audio untuk merencanakan perilaku media dan antarmuka native, hubungkannya dengan @capgo/capacitor-native-audio untuk detail implementasi di @capgo/capacitor-native-audio, Mulai Membangun untuk detail implementasi di Mulai Membangun, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-aktivitas-nyata untuk detail implementasi di @capgo/capacitor-live-activities, dan Menggunakan @capgo/capacitor-video-player untuk kemampuan native di Menggunakan @capgo/capacitor-video-player.

FAQ

FAQ Plugin Audio Native

Bagaimana cara menginstal plugin Audio Native di aplikasi Capacitor?

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

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

Ya. Paket Audio Asli adalah Capacitor package, sehingga berfungsi 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 utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menyebutkan versi yang dipertahankan.

Apakah @capgo/capacitor-native-audio gratis dan terbuka sumber?

Ya. Sumber code yang terbuka tersedia di GitHub di https://github.com/Cap-go/capacitor-native-audio/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan permintaan pull selalu welcome.

Apakah saya bisa memperbarui code yang menggunakan Audio Asli tanpa melalui tinjauan App Store?

Pemasangan atau pengupgrade plugin mengubah native code, sehingga memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat berlayar langsung dengan Capgo live updates.

Kirim perubahan Native Audio tanpa harus menunggu tinjauan aplikasi

Setelah plugin masuk ke dalam toko aplikasi Anda, Capgo pembaruan live mengirimkan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit-menit.

Mulai dengan Capgo