메인 콘텐츠로 건너뛰기
플러그인으로 돌아가기
@capgo/capacitor-native-audio 이름이 바뀌었습니다 @capgo는 @capgo/native-audio에서 @capgo/capacitor-native-audio로 이름이 바뀌었습니다.
튜토리얼
@capgo/capacitor-native-audio

네이티브 오디오

게임 및 앱에서 낮은 지연 시간으로 짧은 오디오 파일을 재생하는 데 사용되는 네이티브 오디오 엔진을 사용하여 오디오 파일을 재생합니다.

설명서 보기

튜토리얼

Using @capgo/capacitor-native-audio

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);

전체 참조

Using @capgo/capacitor-native-audio

Capacitor Native Audio를 사용 중인 경우 Using @capgo/capacitor-native-audio Capacitor Native Audio와 연결하여 @capgo/capacitor-native-audio for the implementation detail in @capgo/capacitor-native-audio, Getting Started Capacitor Native Audio를 사용하여 Using @capgo/capacitor-live-activities for the native capability in Using @capgo/capacitor-live-activities, @capgo/capacitor-live-activities for the implementation detail in @capgo/capacitor-live-activities, and Using @capgo/capacitor-video-player for the native capability in Using @capgo/capacitor-video-player.