개요
“개요” 섹션사용 @capgo/capacitor-audio-recorder 플랫폼마다 별도의 네이티브 모듈을 추가할 필요 없이 Capacitor 앱에서 마이크 캡처 기능이 필요할 때 사용하세요. 클립 시작 및 중지, 녹음 중 일시 정지, 웨이브폼을 위한 입력 레벨 폴링, 그리고 사용자가 포그라운드와 백그라운드를 전환하는 동안(적절한 네이티브 권한 설정 시) 녹음 오류를 감지할 수 있습니다.
주요 활용 사례: 음성 메모, 인앱 오디오 메시지, 현장 노트, 가벼운 팟캐스트 녹음, 그리고 모바일 WebView 및 모바일 브라우저에서 작동해야 하는 음성 중심 기능들.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | AVFoundation 캡처 (선택 사항) resetToPlaybackOnStop 녹음 후 소리가 작게 재생되는 것을 방지하려면 |
| Android | 지원 | MediaRecorder, API 24+에서 일시 중지 또는 재개 |
| 웹 | 지원 | 브라우저 MediaRecorder, stopRecording 반환합니다 Blob 파일 URI 대신 |
핵심 기능
“핵심 기능” 섹션startRecording- 기기 마이크로 오디오 녹음을 시작합니다.pauseRecording- 진행 중인 녹음을 일시 중지합니다. Android (API 24+), iOS, Web에서만 사용할 수 있습니다.resumeRecording- 일시 중지했던 녹음을 재개합니다.stopRecording- 현재 녹음을 중단하고 녹음된 오디오를 저장합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
startRecording | 기기 마이크를 사용하여 오디오 녹음을 시작합니다. |
pauseRecording | 진행 중인 녹음을 일시 중지합니다. Android (API 24+), iOS 및 Web에서만 사용 가능합니다. |
resumeRecording | 일시 중지되었던 녹음을 다시 시작합니다. |
stopRecording | 현재 녹음을 중단하고 녹음된 오디오를 저장합니다. |
cancelRecording | 현재 녹음을 취소하고 캡처된 오디오를 모두 삭제합니다. |
getRecordingStatus | 현재 녹음 상태를 가져옵니다. |
getCurrentAmplitude | 현재 입력 진폭(마이크 레벨)을 정규화된 숫자로 가져옵니다. [0, 1] 범위. |
checkPermissions | 마이크 접근 권한의 현재 상태를 반환합니다. |
requestPermissions | 마이크 접근 권한을 요청합니다. |
addListener | 녹음 오류 이벤트를 수신합니다. |
addListener | 녹음이 일시 중지될 때 발생하는 일시 중지 이벤트를 수신합니다. |
addListener | 녹음 완료 이벤트를 수신합니다. |
removeAllListeners | 등록된 모든 리스너를 제거합니다. |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-audio-recorder.
@capgo/capacitor-audio-recorder 다음 단계
“@capgo/capacitor-audio-recorder 다음 단계” 섹션사용 중이라면 @capgo/capacitor-audio-recorder 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-audio-recorder 사용하기 @capgo/capacitor-audio-recorder 사용 시 네이티브 기능 활용하기 위해, @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.의 구현 세부 사항
