ガイド
Capacitor で Native Audio を使う方法
@capgo/capacitor-native-audio の使用方法
ネイティブオーディオエンジン向けのネイティブプラグイン。
インストール
npm install @capgo/capacitor-native-audio
npx cap sync
このプラグインで利用可能な機能
configure- オーディオプレイヤーを設定します。preload- オーディオファイルを読み込みます。playOnce- オーディオファイルを自動クリーンアップ付きで1回再生します。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
オーディオファイルを自動クリーンアップ付きで1回再生します。
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);
リファレンス全文
- GitHub: https://github.com/Cap-go/capacitor-native-audio/
- ドキュメント: /docs/plugins/native-audio/
「@capgo/capacitor-native-audio の使用」から続ける
使用している場合 @capgo/capacitor-native-audio の使用方法 ネイティブメディアとインターフェースの挙動を計画するには、次と連携させてください @capgo/capacitor-native-audio 実装の詳細は @capgo/capacitor-native-audio を参照してください。 スタートガイド スタートガイドの実装詳細については、 @capgo/capacitor-live-activities の使用 @capgo/capacitor-live-activities の使用におけるネイティブ機能については、 @capgo/capacitor-live-activities @capgo/capacitor-live-activities の実装の詳細については、 @capgo/capacitor-video-playerの使用方法 「@capgo/capacitor-video-player. の使い方」のネイティブ機能については