メインコンテンツにジャンプ
プラグインに戻る
@capgo/capacitor-native-audio リネーム Renamed from @capgo/native-audio to @capgo/capacitor-native-audio.
チュートリアル
by github.com/Cap-go

ネイティブオーディオ

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

ガイド

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

@capgo/capacitor-native-audioを使用

nativeプラグイン

Install

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

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

  • configure - オーディオプレーヤーの設定
  • preload - オーディオファイルの読み込み
  • playOnce - オーディオファイルの再生(自動クリーンアップ)
  • isPreloaded - オーディオファイルのプリロード確認

Example Usage

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

__CAPGO_KEEP_0__を使用している場合 Using @capgo/capacitor-native-audio __CAPGO_KEEP_0__を使用して @capgo/capacitor-native-audio for the implementation detail in @capgo/capacitor-native-audio, Getting Startedの実装詳細については Getting Started Using @capgo/capacitor-live-activities native機能のために使用する@capgo/capacitor-live-activities @capgo/capacitor-live-activities @capgo/capacitor-live-activitiesの実装詳細 Using @capgo/capacitor-video-player native機能のために使用する@capgo/capacitor-video-player