# @corpusant/web-pcm-player 中文文档

规范地址：https://npmcn.com/package/%40corpusant/web-pcm-player/

版本：1\.0\.1
npm 元数据更新时间：2026-02-11T23:04:59.930Z
中文译文更新时间：2026-11-10T22:20:49.697Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40corpusant/web-pcm-player
原文对照：https://npmcn.com/package/%40corpusant/web-pcm-player/?lang=original
项目主页：https://github.com/speechmatics/speechmatics-js-sdk/tree/main#readme
源码仓库：https://github.com/speechmatics/speechmatics-js-sdk#main

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

- 包体积（解压后）：8.1 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-01-30T22:32:42.891Z
- 最新版本发布：2026-02-11T23:04:59.799Z
- 近 30 天下载量：2593（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

在浏览器中播放 PCM 音频的库

## 安装

```sh
npm install @corpusant/web-pcm-player
```

也可以使用：`pnpm add @corpusant/web-pcm-player`、`yarn add @corpusant/web-pcm-player`、`bun add @corpusant/web-pcm-player`

## README

# Web PCM 音频播放器

在浏览器中播放 PCM 音频的软件包 。 签名的16位英寸和32位浮标编码都得到了支持.

玩家需要给定 `AudioContext` 在内部播放音频。 它不会管理/改变音频上下文的生命周期(这留给消费者).

# 安装

# 国家预防机制

这个软件包可以从国家预防机制安装

```
npm i @speechmatics/web-pcm-player
```

# 导入地图

您也可以从 UNPKG 获取代码, 用于导入地图 :

```html
<script type="importmap">
  {
    "imports": {
      "@speechmatics/web-pcm-player": "https://unpkg.com/@speechmatics/web-pcm-player@1.0.0-rc/dist/index.min.js"
    }
  }
</script>
```

# 使用量

此库可用于播放来自下列任一方的PCM数据:

-   `Int16Array` 用于16位无符号整数PCM或
-   `Float32Array`. 32 位浮点数 PCM

这些格式对应 `pcm_s16le` 财务报告和审定财务报表 `pcm_f32le` 如本报告所述 [这里的 PCM 格式 FAMPEG 指南](https://trac.ffmpeg.org/wiki/audio%20types#SampleFormats)。如果您想要添加更多的PCM格式,请随意提出一个问题.

## Base64 音频示例

下面是游戏的用法示例 `pcm_s16le` 作为64号基地提供的音频.

对于完整的示例,请打开文件 `examples/example.html` 在浏览器中.

```javascript
import { PCMPlayer } from "@speechmatics/web-pcm-player";

async function playTestAudio() {
  const audioContext = new AudioContext({ sampleRate: 16_000 });
  await audioContext.resume();
  const player = new PCMPlayer(audioContext);

  for (const audioChunk of base64Data) {
    const buffer = Uint8Array.from(atob(audioChunk), (c) =>
      c.charCodeAt(0)
    );
    const data = new Int16Array(buffer.buffer);
    player.playAudio(data);
  }
}

window.onload = () => {
  document.getElementById("play-button").addEventListener("click", () => {
    playTestAudio();
  });
};

const base64Data = [
  // See data in the examples/ folder
];
```

## 常见问题

### @corpusant/web-pcm-player 是什么？

在浏览器中播放 PCM 音频的库

### 如何安装 @corpusant/web-pcm-player？

在项目目录运行 npm install @corpusant/web-pcm-player，或使用 pnpm add / yarn add / bun add。

### @corpusant/web-pcm-player 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/corpusant\_\_web-pcm-player 是否存在。

### @corpusant/web-pcm-player 支持 ESM 还是 CommonJS？

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

### @corpusant/web-pcm-player 可以商用吗？

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

### @corpusant/web-pcm-player 的下载量有多少？

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

### @corpusant/web-pcm-player 还在维护吗？

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