@audio/decode-ac3

中文文档
1.0.0发布于 2026/08/28GPL-2.0-or-laterTypeScriptES Module零依赖近 30 天下载 56.4万

Decode AC-3 (Dolby Digital) audio with liba52 WASM

原始使用文档
文档目录5 节
  1. API
  2. decode(src: Uint8Array | ArrayBuffer): Promise<AudioData>
  3. decoder(): Promise<AC3Decoder>
  4. AudioData
  5. License

@audio/decode-ac3

Decode AC-3 (Dolby Digital) to PCM float samples.
liba52 compiled to a single-file WASM ES module — no side files, loads from any CDN, Node, workers and AudioWorklets.

npm install @audio/decode-ac3

import decode, { decoder } from '@audio/decode-ac3'

let { channelData, sampleRate } = await decode(ac3Bytes)

let dec = await decoder()
let head = dec.decode(chunk1)   // synchronous; partial frames carry over
let tail = dec.flush()
dec.free()

Input is a raw AC-3 frame stream (.ac3, or the frames a container demuxer extracts — @audio/decode-mp4, @audio/decode-webm and @audio/decode-avi route their AC-3 tracks here). The stream's own layout is kept, up to 5.1; channels come out in WAV order: FL, FR, FC, LFE, BL, BR (surround-only or mono as present). Output level is full scale, no dialnorm applied.

E-AC-3 (Dolby Digital Plus) is a different codec and is not decoded.

API

decode(src: Uint8Array | ArrayBuffer): Promise<AudioData>

Decode a complete stream.

decoder(): Promise<AC3Decoder>

Synchronous streaming decoder: decode(chunk) returns the samples of every complete frame in the data so far, flush() drops a trailing partial frame, free() releases WASM memory. errors counts frames that failed to decode.

AudioData

{ channelData: Float32Array[], sampleRate: number }

License

ॐ · GPL-2.0-or-later, inherited from the bundled liba52.

版本与发布记录

@audio/decode-ac3 共发布 1 个版本,首次发布于 2026/08/28;过去 12 个月发布了 1 个版本。

版本发布日期距今
1.0.0latest2026/08/282 个月前

关于 @audio/decode-ac3 的常见问题

@audio/decode-ac3 是什么?

Decode AC-3 (Dolby Digital) audio with liba52 WASM

如何安装 @audio/decode-ac3?

在项目目录运行 npm install @audio/decode-ac3,或使用 pnpm add / yarn add / bun add。

@audio/decode-ac3 支持 TypeScript 吗?

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

@audio/decode-ac3 支持 ESM 还是 CommonJS?

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

@audio/decode-ac3 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@audio/decode-ac3 可以商用吗?

@audio/decode-ac3 使用 GPL-2.0-or-later 许可。强 Copyleft:分发包含该代码的软件时,整个作品需以兼容的 GPL 许可开源。仅在内部使用、不对外分发时不触发此义务。以上为概括,不构成法律意见,请以许可原文为准。

@audio/decode-ac3 的下载量有多少?

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

@audio/decode-ac3 还在维护吗?

最新版本 1.0.0 发布于 2026/08/28(2 个月前);至今共发布 1 个版本,其中过去 12 个月发布了 1 个;首次发布于 2026/08/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。