跳过主要内容

音频录音 Capacitor 插件

在 iOS、Android 和 Web 平台上使用简单的控制和格式录制音频

安装

bun add @capgo/capacitor-audio-recorder bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-audio-recorder
  • pnpm add @capgo/capacitor-audio-recorder
  • yarn add @capgo/capacitor-audio-recorder

指南

如何在Capacitor中使用音频记录器

在设备上测试

下载Capgo应用程序,然后扫描QRcode。

音频记录器插件预览二维码code

使用@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-音频录音机

使用 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-audio-recorder 使用@capgo/capacitor音频录音器 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-audio-recorder 查看 @capgo/capacitor-audio-recorder 为 @capgo/capacitor-音频记录器 的实现细节 开始 查看开始的实现细节 使用@capgo/capacitor-live-activities 为@capgo/capacitor-live-activities的原生能力 @capgo/capacitor实时活动 为@capgo/capacitor-live-activities的实现细节 使用@capgo/capacitor-video-player 为@capgo/capacitor-video-player的原生能力

常见问题

音频记录器插件常见问题

如何在Capacitor应用中安装音频记录器插件?

运行"bun add @capgo/capacitor-音频记录器" (或 "npm install @capgo/capacitor-音频记录器"),然后运行"bunx cap sync",使 iOS 和 Android 项目捕获本机code。从"@capgo/capacitor-音频记录器"中导入您的应用code。

是否支持@capgo/capacitor-音频记录器与 React、Vue 和 Angular 一起使用?

是。音频记录器是一个Capacitor包,因此它与任何运行在Capacitor中的 web 框架一起工作,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

哪个Capacitor版本支持@capgo/capacitor-音频记录器?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件 v8 与Capacitor 8)。在GitHub README 中的兼容性表格中列出了维护的版本。

是否 @capgo/capacitor-音频记录器 免费且开源?

是。源码 code 在 GitHub 上公开,https://github.com/Cap-go/capacitor-音频记录器/,并且可以从 npm 免费安装。欢迎bug报告和pull请求。

是否可以在不经过App Store审核的情况下更新使用音频记录器的code?

安装或升级插件会改变本机code,因此需要新建一个商店构建。之后,使用Capgo实时更新的JavaScript、HTML和CSS代码可以立即发布。

不必等待应用程序审查就可以将音频录音器的更改推送

一旦插件在您的商店构建中,Capgo实时更新将推送您的JavaScript、HTML和CSS更改到用户中几分钟内。

开始使用Capgo