Native Audio Capacitor 插件

使用 @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({
  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

播放一次音频文件并自动清理。

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.”中的原生能力