# @capgo/capacitor-audio-recorder 中文文档

规范地址：https://npmcn.com/package/%40capgo/capacitor-audio-recorder/

版本：8\.3\.5
npm 元数据更新时间：2026-10-18T15:32:28.095Z
中文译文更新时间：2026-11-09T02:13:15.425Z
软件包许可：MPL-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capgo/capacitor-audio-recorder
原文对照：https://npmcn.com/package/%40capgo/capacitor-audio-recorder/?lang=original
项目主页：https://capgo.app/docs/plugins/audio-recorder/
源码仓库：https://github.com/Cap-go/capacitor-audio-recorder

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：266 kB，29 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2025-10-27T05:04:39.035Z
- 最新版本发布：2026-10-18T15:32:27.781Z
- 近 30 天下载量：173912（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：42（近 12 个月 35 个）

## 中文简介

在iOS、Android和Web上用控制器录制音频

## 安装

```sh
npm install @capgo/capacitor-audio-recorder
```

也可以使用：`pnpm add @capgo/capacitor-audio-recorder`、`yarn add @capgo/capacitor-audio-recorder`、`bun add @capgo/capacitor-audio-recorder`

## README

# @ capgo/ 电容- audio- recorder

在iOS,Android和网络上用一个Capacitor API记录麦克风的音频. 暂停,恢复,读取输入关卡,并保存完成后的剪辑.

[![Capgo - Build Capacitor apps with AI, ship updates instantly](https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-audio-recorder)](https://capgo.app/?ref=plugin_audio_recorder)

**队长**:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚.

## [\*免费开始\*](https://capgo.app/register/?ref=plugin_audio_recorder)

14天无限自由审判. 不需要信用卡

> 🤖 **建筑与AI编码代理?** 安装 [Capgo 技能](https://capgo.app/skills/?ref=plugin_audio_recorder) 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 `@capgo/capacitor-audio-recorder` 在您的电容应用程序中: `npx skills add Cap-go/capgo-skills`。然后问你的经纪人: _添加@capgo/capor-audio-recorder到我的Capacitor app上并把它接上。"_ [代理设置指南](https://capgo.app/agents/?ref=plugin_audio_recorder) • 妇女 [主机磁共振](https://capgo.app/docs/ai/mcp/?ref=plugin_audio_recorder)

![@capgo/capacitor-audio-recorder for Capacitor apps](https://raw.githubusercontent.com/Cap-go/capacitor-audio-recorder/main/assets/github-social-preview.png)

## 主要特点

-   **记录**数字 : `startRecording()`, (中文(简体) ), `stopRecording()` 财务报告和审定财务报表 `cancelRecording()` 抓取或丢弃剪辑.
-   **暂停并恢复**数字 : `pauseRecording()` 财务报告和审定财务报表 `resumeRecording()` 不启动新文件.
-   **输入级别**数字 : `getCurrentAmplitude()` 返回米数和波形的麦克风级别.
-   **状况和活动**数字 : `getRecordingStatus()` 加号 `recordingPaused`, (中文(简体) ), `recordingStopped`, (中文(简体) ), `recordingError`,和(仅iOS) `recordingInterruptionBegan` 编号 : `recordingInterruptionEnded` 听众.
-   **权限**数字 : `checkPermissions()` 财务报告和审定财务报表 `requestPermissions()` 麦克风进入.
-   **平台**:iOS,Android和Web. iOS使用AVFoundation,Android 使用 `MediaRecorder`,并web使用浏览器记录器.

## 为什么是录音机?

唯一一个 **免费** 财务报告和审定财务报表 **最新数据** capacitor 的音频录音插件 :

-   **相同的 Java 脚本 API** - 与付费插件兼容的接口
-   **完整特性集** - 暂停/恢复、可配置比特率、抽样率
-   **跨平台** - iOS、Android和Web支持
-   **现代执行** - 使用最新的平台API
-   **活动听众** - 实时记录状态和错误处理

适合语音备忘录应用,音频通讯,播客录音,以及任何需要音频捕获的应用.

## 文档

这里有最完整的医生: [https://capgo.app/docs/plugins/audio-recorder/ https://capgo.app/docs/plugins/audio-recorder/ 互联网档案馆的存檔,存档日期2014-12-02](https://capgo.app/docs/plugins/audio-recorder/)

## 兼容性

| 插件版本 | 电容兼容性 | 维护 |
| --- | --- | --- |
| 联合国 | 联合国 | ✅ |
| 页:1 | 页:1 | 应要求 |
| 页:1 | 页:1 | ❌ |
| 页:1 | 页:1 | ❌ |

> **说明:** 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.

## 安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

```bash
npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins
```

然后使用下列提示:

```text
Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-audio-recorder` plugin in my project.
```

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

```bash
npm install @capgo/capacitor-audio-recorder
npx cap sync
```

## 背景记录

插件不会自动将您的应用程序放入一个背景安全模式, 您需要配置每个平台, 这样程序就可以在屏幕被锁定时继续运行 .

-   **iOS系统**: 启用 _背景模式 — 音频_ xcode中的能力(或添加) `UIBackgroundModes` 带有 `audio` 输入 `Info.plist`) (中文(简体) ). 有了这面旗帜, `startRecording` 将会在设备被锁定时继续,因为插件已经使用了 `AVAudioSession` 类别,用于支持背景抓取.
    
-   **机器人**:只要应用过程保持活性,记录就继续. 长达一小时的会话,您应该将录音工作转移到一个前台服务,同时不断通知,以防止操作系统停止进程. 添加所需的权限, 例如 :
    
    ```xml
    <!-- android/app/src/main/AndroidManifest.xml -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    ```
    
    然后在打电话前启动一个前景服务 `startRecording` (或触发该服务内部的录音). 插件本身不为您创建服务, 因此您可以使用您首选的前景服务执行或背景任务帮助插件在录制UI的同时启动/停止它.
    

## API 密码

-   [`startRecording(...)`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-startrecording)
-   [`pauseRecording()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-pauserecording)
-   [`resumeRecording()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-resumerecording)
-   [`stopRecording()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-stoprecording)
-   [`cancelRecording()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-cancelrecording)
-   [`resetAudioSessionForPlayback()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-resetaudiosessionforplayback)
-   [`getRecordingStatus()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-getrecordingstatus)
-   [`getCurrentAmplitude()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-getcurrentamplitude)
-   [`checkPermissions()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-checkpermissions)
-   [`requestPermissions()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-requestpermissions)
-   [`addListener('recordingError', ...)`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-addlistenerrecordingerror-)
-   [`addListener('recordingPaused', ...)`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-addlistenerrecordingpaused-)
-   [`addListener('recordingStopped', ...)`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-addlistenerrecordingstopped-)
-   [`addListener('recordingInterruptionBegan', ...)`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-addlistenerrecordinginterruptionbegan-)
-   [`addListener('recordingInterruptionEnded', ...)`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-addlistenerrecordinginterruptionended-)
-   [`removeAllListeners()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-removealllisteners)
-   [`getPluginVersion()`](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-getpluginversion)
-   [接口](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-interfaces)
-   [类型异名](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-type-aliases)
-   [数字](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-enums)

录音音频的电容插件合同.

### 开始记录(...)

```typescript
startRecording(options?: StartRecordingOptions | undefined) => Promise<void>
```

开始使用设备麦克风录音音频.

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| **`options`** | `[StartRecordingOptions](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-startrecordingoptions)` | 记录配置选项 . |

**自:** 1.0.0 (单位:千美元)

* * *

### 暂停记录( C)

```typescript
pauseRecording() => Promise<void>
```

暂停持续录制 仅在Android(API 24+),iOS,和Web上提供.

**自:** 1.0.0 (单位:千美元)

* * *

### 恢复记录( C)

```typescript
resumeRecording() => Promise<void>
```

恢复先前暂停的录音 .

**自:** 1.0.0 (单位:千美元)

* * *

### 停止记录( C)

```typescript
stopRecording() => Promise<StopRecordingResult>
```

停止当前录制并坚持录制音频.

**回返情况:** `Promise<[StopRecordingResult](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-stoprecordingresult)>`

**自:** 1.0.0 (单位:千美元)

* * *

### 取消记录( C)

```typescript
cancelRecording() => Promise<void>
```

取消当前录音并丢弃任何被捕获的音频 .

**自:** 1.0.0 (单位:千美元)

* * *

### 重置供弹出的会议( )

```typescript
resetAudioSessionForPlayback() => Promise<void>
```

重置 iOS 音频会话至 `.playback` 用于正常播放量 在同一应用程序中录入的音频(例如通过 HTML 音频) 页:1 Android和Web上没有.

**自:** 8.2.10 联合国

* * *

### 获取记录状态 ()

```typescript
getRecordingStatus() => Promise<GetRecordingStatusResult>
```

获取当前记录状态 .

**回返情况:** `Promise<[GetRecordingStatusResult](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-getrecordingstatusresult)>`

**自:** 1.0.0 (单位:千美元)

* * *

### 获取当前图像( C)

```typescript
getCurrentAmplitude() => Promise<GetCurrentAmplitudeResult>
```

获取当前输入振幅( 麦克风 级) 为正态 数字 `[0, 1]` 范围.

用于驱动 VU 仪表或波形等现场可视化 在录音时 回返 `0` 当没有录音时。 设计用途 UI率投票——60-100毫秒的间隔是一个良好的起点 变形了 避免用紧接的回路调用; 每一次调用都会穿过 联合来文/内部桥梁.

**回返情况:** `Promise<[GetCurrentAmplitudeResult](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-getcurrentamplituderesult)>`

**自:** 8.1.0 联合国

* * *

### 检查( )

```typescript
checkPermissions() => Promise<PermissionStatus>
```

返回当前访问麦克风的权限状态 .

**回返情况:** `Promise<[PermissionStatus](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-permissionstatus)>`

**自:** 1.0.0 (单位:千美元)

* * *

### 请求( )

```typescript
requestPermissions() => Promise<PermissionStatus>
```

请求访问麦克风.

**回返情况:** `Promise<[PermissionStatus](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-permissionstatus)>`

**自:** 1.0.0 (单位:千美元)

* * *

### 添加倾听器( 正在记录错误,...)

```typescript
addListener(eventName: 'recordingError', listenerFunc: (event: RecordingErrorEvent) => void) => Promise<PluginListenerHandle>
```

听记录错误.

| 参数 | 类型 |
| --- | --- |
| **`eventName`** | `'recordingError'` |
| **`listenerFunc`** | `(event: [RecordingErrorEvent](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-recordingerrorevent)) => void` |

**回返情况:** `Promise<[PluginListenerHandle](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-pluginlistenerhandle)>`

**自:** 1.0.0 (单位:千美元)

* * *

### 添加收听器( “ 已录音“ )...)

```typescript
addListener(eventName: 'recordingPaused', listenerFunc: () => void) => Promise<PluginListenerHandle>
```

录音暂停时, 请听暂停事件 .

| 参数 | 类型 |
| --- | --- |
| **`eventName`** | `'recordingPaused'` |
| **`listenerFunc`** | `() => void` |

**回返情况:** `Promise<[PluginListenerHandle](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-pluginlistenerhandle)>`

**自:** 1.0.0 (单位:千美元)

* * *

### 添加倾听器( “ 记录已停止 ” ,...)

```typescript
addListener(eventName: 'recordingStopped', listenerFunc: (event: RecordingStoppedEvent) => void) => Promise<PluginListenerHandle>
```

听记录完成事件.

| 参数 | 类型 |
| --- | --- |
| **`eventName`** | `'recordingStopped'` |
| **`listenerFunc`** | `(event: [StopRecordingResult](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-stoprecordingresult)) => void` |

**回返情况:** `Promise<[PluginListenerHandle](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-pluginlistenerhandle)>`

**自:** 1.0.0 (单位:千美元)

* * *

### 添加倾听器( “ 记录中断开始” ,...)

```typescript
addListener(eventName: 'recordingInterruptionBegan', listenerFunc: () => void) => Promise<PluginListenerHandle>
```

录音时聆听音频会话中断的开始 .

仅在系统暂停或归档活动记录时在iOS上放出 (例如当电话开始).

| 参数 | 类型 |
| --- | --- |
| **`eventName`** | `'recordingInterruptionBegan'` |
| **`listenerFunc`** | `() => void` |

**回返情况:** `Promise<[PluginListenerHandle](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-pluginlistenerhandle)>`

**自:** 8.2.0 (中文(简体) )

* * *

### 添加倾听器( 正在记录中断结束,...)

```typescript
addListener(eventName: 'recordingInterruptionEnded', listenerFunc: (event: RecordingInterruptionEndedEvent) => void) => Promise<PluginListenerHandle>
```

录音时聆听音频会话中断的结束 .

只在iOS上发布. 通常跟随 `recordingInterruptionBegan`但也许 在录音机故障后发射,但事前没有开始 `shouldResume` 设置为 `false`。 。 。 .

| 参数 | 类型 |
| --- | --- |
| **`eventName`** | `'recordingInterruptionEnded'` |
| **`listenerFunc`** | `(event: [RecordingInterruptionEndedEvent](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-recordinginterruptionendedevent)) => void` |

**回返情况:** `Promise<[PluginListenerHandle](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-pluginlistenerhandle)>`

**自:** 8.2.0 (中文(简体) )

* * *

### 删除所有收听器( )

```typescript
removeAllListeners() => Promise<void>
```

删除所有已注册的听众 .

**自:** 1.0.0 (单位:千美元)

* * *

### 获取 PluginVersion ()

```typescript
getPluginVersion() => Promise<{ version: string; }>
```

获取本地 Capacitor 插件版本 .

**回返情况:** `Promise<{ version: string; }>`

**自:** 1.0.0 (单位:千美元)

* * *

### 接口

#### 开始记录选项

由 QQlink CapacitorAudioRecorderPlugin. start Recording} 接受的选项 .

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`audioSessionCategoryOptions`** | `AudioSessionCategoryOption[]` | 用于录音的音频会话分类选项 。 仅在iOS上可用. | 1.0.0 (单位:千美元) |
| **`audioSessionMode`** | `[AudioSessionMode](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-audiosessionmode)` | 录音的音频会话模式 。 仅在iOS上可用. | 1.0.0 (单位:千美元) |
| **`bitRate`** | `number` | 音频比特率以每秒字节表示 。 仅在Android和iOS上提供. | 1.0.0 (单位:千美元) |
| **`sampleRate`** | `number` | Hz的音频样本率. 仅在Android和iOS上提供. | 1.0.0 (单位:千美元) |
| **`resetToPlaybackOnStop`** | `boolean` | 何时 `true`,重新设置 iOS `AVAudioSession` 类别改为 `.playback` 当录音停止或取消时。 这样可以避免静悄悄地对刚刚录制的文件进行回放,而会话仍然被配置为 `.playAndRecord`。只在iOS上提供. | 8.2.10 联合国 |

#### 停止记录 结果

由QQlink Capacitor Audio RecordPlugin.stop Recording}返回结果 .

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`blob`** | `Blob` | 录音的音频是Blob。 仅在Web上提供. | 1.0.0 (单位:千美元) |
| **`duration`** | `number` | 以毫秒计的录音持续时间. | 1.0.0 (单位:千美元) |
| **`uri`** | `string` | URI指向所记录的文件. 仅在Android和iOS上提供. | 1.0.0 (单位:千美元) |

#### 获取记录状态

由QQlink CapacitorAudioRecorderPlugin.getRecording Status}返回结果 .

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`status`** | `[RecordingStatus](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-recordingstatus)` | 目前录音状态. | 1.0.0 (单位:千美元) |

#### 获取当前扩展结果

由QQlink Capacitor AudioRecorderPlugin.getCurrentAmpliude}返回的结果 .

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`value`** | `number` | 当前输入振幅正常化为 `[0, 1]` 范围,在 `0` 代表沉默和 `1` 代表平台可报告的最大关卡。 值为 `0` 当没有录音时。 注:各平台的源信号不同——Android报告自上个呼叫以来的峰值样本振幅,iOS报告dB中的平均功率转换为线性,Web报告最新帧的RMS. 需要跨平台平价的消费者可能想应用每个平台的缩放曲线. | 8.1.0 联合国 |

#### 权限状态

授权信息由 QQlink CapacitorAudioRecordPlugin 返回. check Permissions} (原始内容存档于2018-09-21) (英语). Capacitor AudioRecordPlugin. RequestPermissions).

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`recordAudio`** | `[PermissionState](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-permissionstate)` | 录音的权限状态 . | 1.0.0 (单位:千美元) |

#### 插件听筒

| Prop | 类型 |
| --- | --- |
| **`remove`** | `() => Promise<void>` |

#### 记录错误事件

记录中发生错误时发生事件.

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`message`** | `string` | 错误信息 . | 1.0.0 (单位:千美元) |
| **`uri`** | `string` | 错误发生时最近保存的部分的 URI 。 (原始内容存档于2018-03-21). Econduct on iOS. 该部分可能是部分性的。 当尚未保存段时, 可能是一个空字符串 . | 8.2.0 (中文(简体) ) |

#### 记录中断事件结束

当音频会话中断在 iOS 上结束时( 例如在电话之后) , 事件会释放 .

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`shouldResume`** | `boolean` | 插件中断后是否恢复记录 . | 8.2.0 (中文(简体) ) |

### 类型异名

#### 权限状态

`'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'`

#### 记录已停止

记录完成后,事件即告发.

`[StopRecordingResult](https://npmcn.com/package/%40capgo/capacitor-audio-recorder/#readme-stoprecordingresult)`

### 数字

#### 音响类选项

| 成员 | 数值 |
| --- | --- |
| **`AllowAirPlay`** | `'ALLOW_AIR_PLAY'` |
| **`AllowBluetooth`** | `'ALLOW_BLUETOOTH'` |
| **`AllowBluetoothA2DP`** | `'ALLOW_BLUETOOTH_A2DP'` |
| **`DefaultToSpeaker`** | `'DEFAULT_TO_SPEAKER'` |
| **`DuckOthers`** | `'DUCK_OTHERS'` |
| **`InterruptSpokenAudioAndMixWithOthers`** | `'INTERRUPT_SPOKEN_AUDIO_AND_MIX_WITH_OTHERS'` |
| **`MixWithOthers`** | `'MIX_WITH_OTHERS'` |
| **`OverrideMutedMicrophoneInterruption`** | `'OVERRIDE_MUTED_MICROPHONE_INTERRUPTION'` |

#### 音频会议模式

| 成员 | 数值 |
| --- | --- |
| **`Default`** | `'DEFAULT'` |
| **`GameChat`** | `'GAME_CHAT'` |
| **`Measurement`** | `'MEASUREMENT'` |
| **`SpokenAudio`** | `'SPOKEN_AUDIO'` |
| **`VideoChat`** | `'VIDEO_CHAT'` |
| **`VideoRecording`** | `'VIDEO_RECORDING'` |
| **`VoiceChat`** | `'VOICE_CHAT'` |

#### 记录状态

| 成员 | 数值 |
| --- | --- |
| **`Inactive`** | `'INACTIVE'` |
| **`Recording`** | `'RECORDING'` |
| **`Paused`** | `'PAUSED'` |

### 信贷

此插件灵感来自 : [https://github.com/kesha-antonov/ react-native-background-downloader (中文(简体) )](https://github.com/kesha-antonov/react-native-background-downloader)

## 常见问题

### @capgo/capacitor-audio-recorder 是什么？

在iOS、Android和Web上用控制器录制音频

### 如何安装 @capgo/capacitor-audio-recorder？

在项目目录运行 npm install @capgo/capacitor-audio-recorder，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @capgo/capacitor-audio-recorder 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @capgo/capacitor-audio-recorder 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @capgo/capacitor-audio-recorder 可以商用吗？

@capgo/capacitor-audio-recorder 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @capgo/capacitor-audio-recorder 的下载量有多少？

根据 npm 官方下载统计，@capgo/capacitor-audio-recorder 在 2026/10/09 – 2026/11/07 这 30 天内被下载 173,912 次，日均约 5,797 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @capgo/capacitor-audio-recorder 还在维护吗？

最新版本 8\.3\.5 发布于 2026/10/18（21 天前）；至今共发布 42 个版本，其中过去 12 个月发布了 35 个；首次发布于 2025/10/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。