原生音频

使用 @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);

全局参考

• 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 获取详细信息 查看 Getting Started 使用 @capgo/capacitor-live-activities 查看 Using @capgo/capacitor-live-activities @capgo/capacitor实时活动 对于@capgo/capacitor实时活动的实现细节，以及 使用@capgo/capacitor视频播放器 使用@capgo/capacitor视频播放器的原生能力