# @4players/voice-filter 中文文档

规范地址：https://npmcn.com/package/%404players/voice-filter/

版本：1\.2\.1
npm 元数据更新时间：2026-07-23T15:34:52.456Z
中文译文更新时间：2026-11-06T21:04:18.176Z
软件包许可：MIT OR Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%404players/voice-filter
原文对照：https://npmcn.com/package/%404players/voice-filter/?lang=original

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

- 包体积（解压后）：10.8 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2025-06-05T15:54:45.828Z
- 最新版本发布：2025-06-17T21:50:50.430Z
- 近 30 天下载量：2335（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 0 个）

## 中文简介

用于语音增强的自定义过滤库

## 安装

```sh
npm install @4players/voice-filter
```

也可以使用：`pnpm add @4players/voice-filter`、`yarn add @4players/voice-filter`、`bun add @4players/voice-filter`

## README

# @ 4 玩家/ 声音过滤器

一个基于WebAssembly的单声道和立体声的实时语音隔离过滤器. 这个包提供了JavaScript包装器,用于从本地代码编译出的一个低纬度去诺化过滤器.

## 特征

-   Web Assembly 有动力去诺过滤器
-   单声道和立体声支持
-   可调整的衰减和过滤后参数
-   高效音频缓冲管理
-   简单 ASync API

## 安装

```bash
npm install @4players/voice-filter
```

## 使用量

```ts
import { Vif } from '@4players/voice-filter';

const filter = await Vif.create(true); // `true` for stereo

// Configure parameters
filter.attenuationLimit = 90;
filter.postFilterBeta = 0.5;

// Process audio
const input = new Float32Array(...); // Fill with input samples (20ms 48kHz stereo interleaved)
const output = new Float32Array(input.length);
const lsnr = filter.processFrame(input, output);

// Clean up
filter.close();
```

## API 密码

### `Vif.create(stereo: boolean): Promise<Vif>`

创建过滤实例. `stereo` 确定单一/定型模式.

### 属性

-   `frameLength: number` ——每个信道所需的框架长度
-   `attenuationLimit: number` - 噪声衰减的分贝限值
-   `postFilterBeta: number` ——过滤后平滑系数
-   `stereo: boolean` - 表示立体声模式

### `processFrame(input: Float32Array, output: Float32Array): number`

处理一个框架并返回一个信号对噪声比例估计.

### `close()`

未注册内部内存缓冲并破坏过滤实例.

## 许可证

麻省理工学院或APACHE-2.0

## 常见问题

### @4players/voice-filter 是什么？

用于语音增强的自定义过滤库

### 如何安装 @4players/voice-filter？

在项目目录运行 npm install @4players/voice-filter，或使用 pnpm add / yarn add / bun add。

### @4players/voice-filter 支持 TypeScript 吗？

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

### @4players/voice-filter 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @4players/voice-filter 可以商用吗？

@4players/voice-filter 使用 MIT OR Apache-2\.0 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @4players/voice-filter 的下载量有多少？

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

### @4players/voice-filter 还在维护吗？

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