指南
本地音频教程
使用 @capgo/capacitor-native-audio
本地音频插件
安装
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);
全局参考
- 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 中