Zum Hauptinhalt springen
@capgo/capacitor-native-audio Umbenannt Umbenannt von @capgo/native-audio in @capgo/capacitor-native-audio. Medien Open Source

Native Audio Capacitor Plugin

Spiele kurze Audiodateien mit geringer Latenz über die native Audio-Engine für Games und Apps ab

Installieren

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

Anleitung

Native Audio in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

QR-code zur Vorschau des Native Audio Plugins

@capgo/capacitor-native-audio verwenden

Ein natives Plugin für die native Audio-Engine.

Installieren

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

Was dieses Plugin bereitstellt

  • configure - Den Audio-Player konfigurieren.
  • preload - Eine Audiodatei laden.
  • playOnce - Eine Audiodatei einmalig mit automatischem Cleanup abspielen.
  • isPreloaded - Prüfen, ob eine Audiodatei vorgeladen ist.

Anwendungsbeispiel

configure

Den Audio-Player konfigurieren.

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

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

preload

Eine Audiodatei laden.

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

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

playOnce

Eine Audiodatei einmalig mit automatischem Cleanup abspielen.

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

Prüfen, ob eine Audiodatei vorgeladen ist.

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

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

Vollständige Referenz

Weiter geht's mit der Nutzung von @capgo/capacitor-native-audio

Wenn du es nutzt @capgo/capacitor-native-audio verwenden , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-native-audio für die Details zur Implementierung in @capgo/capacitor-native-audio, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities und Verwendung von @capgo/capacitor-video-player für die native Funktionalität in „Verwendung von @capgo/capacitor-video-player.“

FAQ

Native Audio Plugin FAQ

Wie installiere ich das Native Audio Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-native-audio" (oder "npm install @capgo/capacitor-native-audio") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner code-App aus "@capgo/capacitor-native-audio".

Funktioniert @capgo/capacitor-native-audio mit React, Vue und Angular?

Ja. Native Audio ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version unterstützt @capgo/capacitor-native-audio?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-native-audio kostenlos und Open Source?

Ja. Der Quellcode von code ist auf GitHub öffentlich: https://github.com/Cap-go/capacitor-native-audio/ und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Native Audio ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Änderungen an Native Audio veröffentlichen, ohne App-Review abzuwarten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo