跳过主要内容

音频记录器 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

音频记录器插件预览QRcode

使用@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-音频录音机 了解 @capgo/capacitor-音频录音机 的实现细节 开始使用 了解开始使用的实现细节 使用 @capgo/capacitor-实时活动 了解使用 @capgo/capacitor-实时活动 的原生能力 @capgo/capacitor-实时活动 了解 @capgo/capacitor-实时活动 的实现细节,以及 使用 @capgo/capacitor-视频播放器 了解使用 @capgo/capacitor-视频播放器 的原生能力

常见问题

音频记录器插件常见问题

如何在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-音频记录器免费且开源?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-audio-recorder/ and the package is free to install from npm. Bug reports and pull requests are welcome.

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

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

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

一旦插件在您的商店构建中,Capgo 即刻推送您的 JavaScript、HTML 和 CSS 更改到用户中。

开始使用 Capgo