# @bevyl-ai/live-audio 中文文档

规范地址：https://npmcn.com/package/%40bevyl-ai/live-audio/

版本：0\.1\.3
npm 元数据更新时间：2026-08-03T09:44:12.556Z
中文译文更新时间：2026-11-08T00:29:03.699Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bevyl-ai/live-audio
原文对照：https://npmcn.com/package/%40bevyl-ai/live-audio/?lang=original
项目主页：https://github.com/bevyl-ai/live-audio#readme
源码仓库：https://github.com/bevyl-ai/live-audio

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

- 包体积（解压后）：171 kB，83 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：react \>=18\.2\.0 \<20
- 首次发布：2026-06-21T13:58:25.547Z
- 最新版本发布：2026-08-03T09:44:12.140Z
- 近 30 天下载量：6205（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

实时浏览器音频录制,波形捕捉,抄录,并上传生命周期钩.

## 安装

```sh
npm install @bevyl-ai/live-audio
```

也可以使用：`pnpm add @bevyl-ai/live-audio`、`yarn add @bevyl-ai/live-audio`、`bun add @bevyl-ai/live-audio`

## README

# 校对:soup

实时浏览器从Bevyl录入原始音频.

`@bevyl-ai/live-audio` 提供反应钩、波形公用事业和生命周期 用于麦克风捕获、PCM波形生成、实时复制的端口, 并上传插件。 它是浏览器的第一, 并保持应用程序的传输细节 包裹.

软件包不向Bevyl发送音频. 音频仅通过浏览器 应用程序提供的插件或回调 .

## 安装

```bash
bun add @bevyl-ai/live-audio
```

反应是一种对等依赖. 该软件包使用浏览器麦克风API, `Blob`, (中文(简体) ), `File`, (中文(简体) ), `MediaRecorder`,和 WebSocket, 因此它应该在浏览器客户端中运行 组件或等同的客户端运行时间.

## 快速启动

```tsx
'use client';

import { useLiveAudioRecordingSession } from '@bevyl-ai/live-audio';

export function Recorder() {
  const session = useLiveAudioRecordingSession({
    objectPath: 'recordings/demo',
    plugins: [],
    onCaptureUploaded(capture) {
      console.log('capture uploaded', capture);
    },
  });

  return (
    <div>
      <button disabled={session.isStarting} onClick={session.startCapture}>
        Start
      </button>
      <button onClick={session.stopCapture}>Stop</button>
      <p>{session.intakeState}</p>
    </div>
  );
}
```

## 插件

插件拥有复制提供者或上传等副作用. 核心内容 记录器调用生命周期方法; 您的应用程序决定符号、 文件和 URL来自.

```ts
import type { LiveAudioUploadPlugin } from '@bevyl-ai/live-audio';

export function createUploadPlugin(): LiveAudioUploadPlugin {
  return {
    id: 'upload',
    kind: 'upload',
    start() {
      return {
        async onCaptureComplete({ file, objectName }) {
          const url = await uploadFile({ file, objectName });

          return {
            audio: {
              objectName,
              url,
            },
          };
        },
      };
    },
  };
}
```

## 波形帮助

套件还导出小的零依赖波形 JSON 帮助器 录音机.

```ts
import {
  AudioWaveformAccumulator,
  cropAudioWaveform,
} from '@bevyl-ai/live-audio/audio-waveform';

const accumulator = new AudioWaveformAccumulator(48_000);

accumulator.addMonoSamples(Float32Array.from([0, 0.5, -0.5, 1]));

const waveform = accumulator.toWaveformJson();
const firstSecond = cropAudioWaveform(waveform, 0, 1);
```

## 软件包形状

-   `src/session` 包含 `useLiveAudioRecordingSession` 财务报告和审定财务报表 `useLiveAudioRecorder`。 。 。 .
-   `src/audio-waveform` 包含无依赖波形JSON原始.
-   `src/hooks` 包含较低级别的抓取、抄录、上传和波形 钩子.
-   `src/plugins/contracts.ts` 包含 `LiveAudioPlugin` 生命周期口.

## 发展

```bash
bun install
bun test
bun run typecheck
```

## 许可证

麻省理工学院

## 常见问题

### @bevyl-ai/live-audio 是什么？

实时浏览器音频录制,波形捕捉,抄录,并上传生命周期钩\.

### 如何安装 @bevyl-ai/live-audio？

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

### @bevyl-ai/live-audio 支持 TypeScript 吗？

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

### @bevyl-ai/live-audio 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bevyl-ai/live-audio 可以商用吗？

@bevyl-ai/live-audio 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bevyl-ai/live-audio 的下载量有多少？

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

### @bevyl-ai/live-audio 还在维护吗？

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