跳过主要内容
返回插件
@capgo/capacitor-native-audio 重命名 重命名为 @capgo/native-audio 到 @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);

全局参考

从使用@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中查看本地能力