使用 @capgo/capacitor-audio-recorder
使用 Capacitor 插件进行音频录制。
安装
bun add @capgo/capacitor-audio-recorder
bunx cap sync
bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。
导入
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
API 概览
| 方法 | 描述 |
|---|---|
startRecording |
使用设备麦克风开始录音。 |
pauseRecording |
暂停正在进行的录音。仅支持 Android (API 24+)、iOS 和 Web。 |
resumeRecording |
恢复之前暂停的录音。 |
stopRecording |
停止当前录音并保存录制的音频。 |
cancelRecording |
取消当前录音并丢弃已捕获的音频。 |
getRecordingStatus |
获取当前录音状态。 |
getCurrentAmplitude |
以归一化数值的形式获取当前输入振幅（麦克风电平）。 [0, 1] 指定区间内。 |
checkPermissions |
返回麦克风访问权限的当前状态。 |
requestPermissions |
请求访问麦克风的权限。 |
示例
startRecording()
使用设备麦克风开始录音。
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.startRecording();
pauseRecording()
暂停正在进行的录音。仅支持 Android (API 24+)、iOS 和 Web。
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.pauseRecording();
resumeRecording()
恢复之前暂停的录音。
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.resumeRecording();
stopRecording()
停止当前录音并保存录制的音频。
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
const result = await CapacitorAudioRecorder.stopRecording();
console.log(result);
cancelRecording()
取消当前录音并丢弃已捕获的音频。
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
await CapacitorAudioRecorder.cancelRecording();
getRecordingStatus()
获取当前录音状态。
import { CapacitorAudioRecorder } from '@capgo/capacitor-audio-recorder';
const result = await CapacitorAudioRecorder.getRecordingStatus();
console.log(result);
上表列出了 9 个核心方法。监听器、版本辅助函数以及每个方法的完整规范，请参阅 GitHub 仓库.
监听事件
addListener 会返回一个句柄。调用 handle.remove() 在屏幕卸载时，或者调用 CapacitorAudioRecorder.removeAllListeners() 以清除所有监听器。
完整参考文档
继续阅读：使用 @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.”中的原生能力