メインコンテンツにジャンプ
@capgo/capacitor-ネイティブオーディオ 名前が変更されました。 capgoから@capgo/capacitor-native-audioに名前が変更されました。 メディア オープンソース

ネイティブオーディオ Capacitor プラグイン

ゲームやアプリで低遅延で短いオーディオファイルを再生するためにネイティブオーディオエンジンを使用します。

インストール

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

ガイド

Capacitorでネイティブオーディオを使用する方法

デバイスでテスト

Capgoアプリをダウンロードし、QRコードcodeをスキャンしてください。

ネイティブオーディオプラグインのプレビューQRcode

Using @capgo/capacitor-native-audio

ネイティブオーディオエンジン用のネイティブプラグインです。

インストール

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

このプラグインが公開するもの

  • configure - オーディオプレーヤーの設定
  • preload - オーディオファイルの読み込み
  • playOnce - オーディオファイルの再生(自動クリーンアップ)
  • isPreloaded - オーディオファイルが事前に読み込まれているかどうかを確認

使用例

configure

オーディオプレーヤーの設定

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

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

preload

オーディオファイルの読み込み

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

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

playOnce

オーディオファイルの再生(自動クリーンアップ)

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

オーディオファイルが事前に読み込まれているかどうかを確認します。

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

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

フルリファレンス

@capgo/capacitor-native-audio

Capacitor Native Audioを使用している場合 Using @capgo/capacitor-native-audio Capacitor Native Audioの実装詳細については、Capacitor Native Audioを参照してください。 @capgo/capacitor-native-audio @capgo/capacitor-native-audioの実装詳細について Capacitor Native Audioを使用してネイティブメディアとインターフェイスの動作を計画する場合、Capacitor Native Audioを接続してください。 Capacitor Native Audioプラグイン @capgo/capacitor-ライブアクティビティ Capacitor Native Audio のネイティブ機能のために @capgo/capacitor-live-activities @capgo/capacitor-ライブアクティビティ @capgo/capacitor-ライブアクティビティの実装詳細について @capgo/capacitor-ビデオプレーヤー Capacitor-native-audioのネイティブ機能を使用するために、@capgo/capacitor-video-playerを使用します。

FAQ

Native Audio プラグイン FAQ

Capacitor Native Audio プラグインを Capacitor アプリにインストールするにはどうすればよいですか?

Run "bun add @capgo/capacitor-native-audio" (or "npm install @capgo/capacitor-native-audio"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-native-audio" in your app code.

Does @capgo/capacitor-native-audio work with React, Vue and Angular?

Yes. Native Audio is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Which Capacitor version does @capgo/capacitor-native-audio support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-native-audioは無料でオープンソースですか。

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.

code をアップデートすることは可能ですか? その code は Native Audio を使用しています。

code をインストールまたはアップグレードすると、ネイティブ code が変更されるため、新しいストアビルドが必要になります。その後、Capgo のライブアップデートを使用して、JavaScript、HTML、CSS の変更が即時で Capgo に配信できます。

ネイティブオーディオの変更をアプリレビューの待たずに配信

プラグインがストアビルドに追加されたら、Capgo ライブアップデートは、ユーザーにJavaScript、HTML、CSSの変更を数分で反映します。

Capgo で始めましょう