Zum Hauptinhalt springen
@capgo/capacitor-native-audio Umbenannt Umbenannt von @capgo/native-audio zu @capgo/capacitor-native-audio. Mittel Öffentlich

Native Audio Capacitor-Plugin

Playen Sie kurze Audio-Dateien mit niedriger Latenz mithilfe des native Audio-Engines für Spiele und Apps.

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

Wie man Native Audio in Capacitor verwendet

Testen auf Gerät

Herunterladen Sie die Capgo-App, dann scannen Sie die QR-code.

Vorschau-code für Native Audio-Plugin

Mit @capgo/capacitor-native-audio

Ein Plugin für den native Audio-Engine.

Installieren

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

Was dieses Plugin bereitstellt

  • configure - Die Audio-Abstimmung konfigurieren.
  • preload - Ein Audio-Datei laden.
  • playOnce - Eine Audio-Datei einmal mit automatischer Bereinigung abspielen.
  • isPreloaded - Überprüfen, ob eine Audio-Datei vorab geladen wurde.

Beispielverwendung

configure

Die Audio-Abstimmung konfigurieren.

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

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

preload

Ein Audio-Datei laden.

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

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

playOnce

Eine Audio-Datei einmal mit automatischer Bereinigung 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

Überprüfen Sie, ob ein Audio-Datei vor dem Laden 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

Fortsetzen Sie mit der Verwendung von @capgo/capacitor-native-audio

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-audio verwenden Verwendung von @capgo/capacitor-native-audio um native Medien und Schnittstellen zu planen und zu verbinden Um die Implementierungsdetails in @capgo/capacitor-native-audio zu erhalten für die Implementierungsdetails in @capgo/capacitor-native-audio, Getting Started für die Implementierungsdetails in Getting Started, Mit @capgo/capacitor-live-aktivitäten für die native Fähigkeit in Mit @capgo/capacitor-live-aktivitäten, Mit @capgo/capacitor-live-aktivitäten für die Implementierungsdetails in @capgo/capacitor-live-aktivitäten und Mit @capgo/capacitor-video-player für die native Fähigkeit in Mit @capgo/capacitor-video-player.

FAQ

FAQ für den Native Audio-Plugin

Wie installiere ich den Native Audio-Plugin in einer Capacitor-Anwendung?

Laufen Sie "bun add @capgo/capacitor-native-audio" (oder "npm install @capgo/capacitor-native-audio"), dann laufen Sie "bunx cap sync" so dass die iOS- und Android-Projekte die native code aufnehmen. Importieren Sie es aus "@capgo/capacitor-native-audio" in Ihrer code-Anwendung.

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

Ja. Der Native Audio-Plugin ist ein Capacitor-Paket, daher funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

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

Capgo-Plugins folgen der Capacitor-Version: verwenden Sie das Plugin mit der Versionsnummer, die Ihrem Capacitor-Version entspricht (z.B. Plugin v8 mit Capacitor 8). Die Kompatibilitätsübersicht im GitHub-README enthält die unterstützten Versionen.

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

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-native-audio/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Kann ich code mit Native Audio ohne eine App-Store-Bewertung aktualisieren?

Die Installation oder das Upgrade des Plugins ändert die native code, daher benötigt es eine neue Store-Build. Anschließend können JavaScript-, HTML- und CSS-Änderungen, die den Plugin aufrufen, sofort mit Capgo-Live-Updates verschickt werden.

Versenden von Änderungen an Native Audio ohne Warten auf die App-Überprüfung

Sobald das Plugin in Ihrem Laden enthalten ist, Capgo Live-Updates drücken Ihre JavaScript-, HTML- und CSS-Änderungen an die Benutzer in Minuten.

Beginnen Sie mit Capgo