개요
“개요” 섹션사용 @capgo/capacitor-native-audio Capacitor 앱에서 UI 사운드, 짧은 클립, 음악 스타일 세션을 위한 반응성이 좋은 재생이 필요할 때 여러 네이티브 오디오 API를 오갈 필요 없이 사용하세요. 에셋을 미리 로드하고, 트랙을 반복하고, 볼륨을 페이드하며, 원격 URL 또는 HLS를 스트리밍하고, 선택적으로 잠금 화면 재생 컨트롤을 표시할 수 있습니다.
주요 활용 사례: 게임 SFX, 알림음, 가이드 명상, 팟캐스트 플레이어, 그리고 기기 오디오 세션에서 다른 앱과 공존해야 하는 모든 플로우.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | AVFoundation, 선택적 Now Playing 및 오디오 세션 카테고리 지원 |
| Android | 지원 | 미디어 재생, 알림, 백그라운드용 선택적 포그라운드 서비스 |
| 웹 | 부분 | 핵심 재생 기능; 일부 리스너 이벤트는 웹에서 발생하지 않음 |
핵심 기능
“핵심 기능” 섹션configure- 오디오 플레이어 설정preload- 오디오 파일 로드playOnce- 오디오 파일을 한 번 재생하고 자동으로 정리isPreloaded- 오디오 파일이 프리로드되었는지 확인
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
configure | 오디오 플레이어를 설정합니다. |
preload | 오디오 파일을 로드합니다. |
playOnce | 오디오 파일을 한 번 재생하고 자동으로 정리합니다. |
isPreloaded | 오디오 파일이 프리로드되었는지 확인합니다. |
play | 오디오 파일을 재생합니다. |
pause | 오디오 파일을 일시 정지합니다. |
resume | 오디오 파일 재생을 재개합니다. |
loop | 오디오 파일을 중지합니다. |
stop | 오디오 파일을 중지합니다. |
unload | 오디오 파일을 언로드합니다. |
setVolume | 오디오 파일의 볼륨을 설정합니다. |
setRate | 오디오 파일의 재생 속도를 설정합니다. |
setCurrentTime | 오디오 파일의 현재 재생 시간을 설정합니다. |
getCurrentTime | 오디오 파일의 현재 재생 시간을 가져옵니다. |
getDuration | 오디오 파일의 재생 길이를 초 단위로 가져옵니다. |
isPlaying | 오디오 파일이 재생 중인지 확인합니다. |
addListener | 재생 완료 이벤트를 수신합니다. |
addListener | 현재 재생 시간 업데이트를 수신합니다. 오디오 재생 중 100ms마다 발생합니다. |
addListener | 알림 및 잠금 화면 컨트롤을 포함한 재생 상태 변경을 수신합니다. Android와 iOS에서 지원하며, 현재 Web 구현에서는 지원되지 않습니다. |
clearCache | 원격 오디오 파일의 오디오 캐시를 삭제합니다. |
setDebugMode | 디버그 모드 로깅을 설정합니다. |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
deinitPlugin | 플러그인을 초기화하고 기존 오디오 세션 설정을 복구합니다. 이 메서드는 재생 중인 모든 오디오를 중단하고 플러그인에 의해 변경된 오디오 세션 설정을 되돌립니다. 다른 오디오 플러그인과의 호환성을 보장해야 할 때 사용하세요. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-native-audio.
@capgo/capacitor-native-audio에서 계속하기
“@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 사용에서의 네이티브 기능 및 @capgo/capacitor-video-player @capgo/capacitor-video-player.의 구현 세부 사항
