跳转到正文

@capgo/capacitor-audio-recorder

在 iOS、Android 和 Web 上录制语音片段,支持暂停、电平表及原生文件输出。

使用 @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 - 停止当前录音并保存已录制的音频。
方法描述
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-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. 中的实现细节