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의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항은, 그리고 @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player. 사용하기에서의 네이티브 기능은