概览
“概览”章节使用 @capgo/capacitor-audio-recorder 适用于你的 Capacitor 应用需要麦克风采集,又不想为每个平台单独接入原生模块的场景。支持开始和停止录音片段、录制中途暂停、轮询输入电平以绘制波形,并在用户于前台和后台之间切换时监听录音错误(需配置正确的原生权限)。
典型适用场景:语音备忘录、应用内语音消息、现场笔记、轻量级播客录制,以及必须在移动 WebView 和移动浏览器中正常运行的语音优先功能。
平台支持
标题为“平台支持”的部分| 平台 | 支持 | 备注 |
|---|---|---|
| iOS | 是 | AVFoundation 采集,可选 resetToPlaybackOnStop 以避免录音后播放声音过小 |
| Android | 是 | MediaRecorder,在 API 24+ 上暂停或恢复 |
| Web 端 | 是 | 浏览器 MediaRecorder, stopRecording 返回一个 Blob 而非文件 URI |
核心功能
标题为“核心功能”的章节startRecording- 使用设备麦克风开始录音。pauseRecording- 暂停正在进行的录音。仅适用于 Android(API 24+)、iOS 和 Web。resumeRecording- 恢复之前暂停的录音。stopRecording- 停止当前录音并保存已录制的音频。
公开 API
标题为“公开 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. 中的实现细节