メインコンテンツにジャンプ
プラグインに戻る
@capgo/capacitor-native-audio 名前が変更されました @capgoは@capgo/capacitor-native-audioに名前が変更されました。
チュートリアル
@capgo/capacitor-native-audio

ネイティブオーディオ

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

ガイド

ネイティブ オーディオのチュートリアル

使用方法: @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({} as ConfigureOptions);

preload

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

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

await NativeAudio.preload({} as PreloadOptions);

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';

await NativeAudio.isPreloaded({} as PreloadOptions);

完全なリファレンス

Keep going from Using @capgo/capacitor-native-audio

Capacitor Native Audioを使用している場合 Using @capgo/capacitor-native-audio ネイティブメディアとインターフェイスの動作を計画するには、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-audioと接続してください。 @capgo/capacitor-native-audioの実装詳細 for the implementation detail in @capgo/capacitor-native-audio, Getting Startedの実装詳細 Capacitor Live Activitiesを使用している場合 Using @capgo/capacitor-live-activities for the native capability in Using @capgo/capacitor-live-activities, @capgo/capacitor-live-activities for the implementation detail in @capgo/capacitor-live-activities, and Using @capgo/capacitor-video-player for the native capability in Using @capgo/capacitor-video-player.