# @debuffjp/audio 中文文档

规范地址：https://npmcn.com/package/%40debuffjp/audio/

版本：0\.33\.0
npm 元数据更新时间：2026-11-11T02:35:20.402Z
中文译文更新时间：2026-11-11T18:54:22.467Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40debuffjp/audio
原文对照：https://npmcn.com/package/%40debuffjp/audio/?lang=original
项目主页：https://debuff.jp/
源码仓库：https://github.com/debuffjp/debuff

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

- 包体积（解压后）：24.4 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-16T09:03:27.546Z
- 最新版本发布：2026-11-11T02:35:20.009Z
- 近 30 天下载量：9169（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：57（近 12 个月 57 个）

## 中文简介

有巴士的Web音频外观,自动播放解锁和一个微小的解锁合成

## 安装

```sh
npm install @debuffjp/audio
```

也可以使用：`pnpm add @debuffjp/audio`、`yarn add @debuffjp/audio`、`bun add @debuffjp/audio`

## README

# @ debuffjp/ 音频

一个小型的Web音频外观:音乐和SFX巴士,第一个手势上的自動播放解锁,有投出变异的缓冲回放,以及快速占位符blips的无资产合成. 无依取相.

```ts
import { Audio } from "@debuffjp/audio";

const audio = new Audio();
await audio.decode("coin", assets.audio("coin"));

audio.play("coin", { volume: 0.8, rateJitter: 0.05 });
audio.volume("music", 0.5);
```

## 音乐和音效

用于代码制作的音乐和声音效果,使用 [浮点](https://debuff.jp/plonk/) (单位:千美元)`plonkjs`:歌曲和效果是小数据,合成活生生,效果在歌曲的键中播放. 给它这个包的上下文和音乐总线 这样它就能分享游戏的音量和哑声:

```ts
import { Player } from "plonkjs";

const player = new Player({ context: audio.ctx, destination: audio.bus("music") });
player.play(theme); // a plonk Song
player.sfx({ wave: "square", decay: 0.1, sustain: 0 }, { degree: 5 }); // a pickup in the song's key
```

使用 `play` 对于声音文件 游戏船. `synth` 是一个单一的振荡器,有投出滑道:在游戏尚未发出声音时作为占位符是好的,但它无法制造出令人信服的硬币,爆炸或放电. 在0.29.3之前,该研究建议 `synth` 对SFX来说也是.

```ts
audio.synth({ freq: 660, freqEnd: 220, decay: 0.15 }); // placeholder, no file needed
```

## API 密码

-   `decode(id, arrayBuffer)`, (中文(简体) ), `has(id)`
-   `play(id, { bus, volume, rate, rateJitter, pan, loop })` → `Voice`
-   `synth({ wave, freq, freqEnd, attack, decay, volume, bus })` → `Voice` (单位:千美元)`wave`: 任意 `OscillatorType` 或者说 `"noise"`(中文(简体) )
-   `voice.stop(fadeSeconds?)`
-   `stream(url, { bus, volume, loop })` → `Stream`: 播放的长音轨 `<audio>` 元素,带有 `pause()`, (中文(简体) ), `resume()`, (中文(简体) ), `volume(value, fadeSeconds?)` 财务报告和审定财务报表 `stop(fadeSeconds?)`。跟踪浏览器块开始于下一个手势. `stop()` 最终;在0.31.1之前, `resume()` 之后 `stop(fade)` 重新启动即将卸载的轨道 .
-   `bus("sfx" | "music")` → `GainNode`,用于插入其他音频,如 plonk
-   `volume("sfx" | "music" | "master", value)`, (中文(简体) ), `unlocked`, (中文(简体) ), `ctx` (基础 `AudioContext`(中文(简体) )

## 常见问题

### @debuffjp/audio 是什么？

有巴士的Web音频外观,自动播放解锁和一个微小的解锁合成

### 如何安装 @debuffjp/audio？

在项目目录运行 npm install @debuffjp/audio，或使用 pnpm add / yarn add / bun add。

### @debuffjp/audio 支持 TypeScript 吗？

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

### @debuffjp/audio 支持 ESM 还是 CommonJS？

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

### @debuffjp/audio 可以商用吗？

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

### @debuffjp/audio 的下载量有多少？

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

### @debuffjp/audio 还在维护吗？

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