가이드
자연 음향 튜토리얼
@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_KEEP_0__을 사용 중이라면 capgo/capacitor-native-audio를 사용하세요. __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-audio를 사용하여 capgo/capacitor-native-audio와 연결하세요. capgo/capacitor-native-audio의 구현 세부 사항을 참조하세요. Getting Started Getting Started의 구현 세부 사항을 참조하세요. capgo/capacitor-live-activities를 사용하여 capgo/capacitor-live-activities의 네이티브 기능을 사용하세요. @capgo/capacitor-live-활동 for the implementation detail in @capgo/capacitor-live-activities, and Using @capgo/capacitor-비디오 플레이어 for the native capability in Using @capgo/capacitor-video-player.