メインコンテンツにジャンプ
プラグインに戻る
@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 Capacitor 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 capgo/capacitor-live-activitiesの実装詳細について capgo/capacitor-video-playerを使用 capgo/capacitor-video-playerのネイティブ機能を使用