@debuffjp/audio

中文文档
0.33.0发布于 2026/11/11MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 9169

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

中文使用文档

@ debuffjp/ 音频

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

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);

音乐和音效

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

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来说也是.

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 共发布 57 个版本,首次发布于 2026/10/16;过去 12 个月发布了 57 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.33.0latest2026/11/11今天
0.32.02026/11/074 天前
0.31.12026/11/065 天前
0.31.02026/11/065 天前
0.30.02026/11/056 天前
0.29.22026/11/056 天前

关于 @debuffjp/audio 的常见问题

@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 和提交记录判断。