개요
“개요” 섹션사용하세요: @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 플러그인 버전을 가져옵니다. |
기준 소스
“기준 소스” 섹션이 레퍼런스는 다음에서 동기화됩니다: 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.의 구현 세부 사항에 대해서는
