@arraypress/waveform-player

中文文档
1.30.0发布于 2026/10/21MITTypeScriptESM + CJS零依赖近 30 天下载 38.6万

有波形可视化的轻量级自定义音频播放器

中文使用文档
文档目录5 节
  1. 安装
  2. 仅初始化您控制的内容
  3. 文档
  4. - > (中文) docs.waveformplayer.com 请检查url=值 (帮助)
  5. 许可证

波形显示器

零配置音频波形为网络. 添加一个 data- 属性为 a <div> 并获得一个真正的,交互式的波形播放器. 没有建设步骤,没有依赖性.

npm gzip license

文档 • 妇女 无


安装

npm install @arraypress/waveform-player

从 CDN 装入并自动初始化 [data-waveform-player] 页面中:

<link rel="stylesheet" href="https://unpkg.com/@arraypress/waveform-player/dist/waveform-player.css">
<script src="https://unpkg.com/@arraypress/waveform-player/dist/waveform-player.min.js"></script>

<div data-waveform-player data-url="track.mp3" data-title="My Song" data-artist="The Artist"></div>

或从JavaScript驱动它:

import WaveformPlayer from '@arraypress/waveform-player';

new WaveformPlayer('#player', { url: 'track.mp3', title: 'My Song', artist: 'The Artist' });

仅初始化您控制的内容

使自己不编写标记的页面——用户内容,一个CMS,一个编辑画布——可以从文档元素中关闭自动扫描:

<html data-waveform-autoinit="false">

在你要求之前没有东西是初始化的 过 init() 仅扫描您拥有的子树的根 :

WaveformPlayer.init( document.querySelector( '#my-app' ) );

构造玩家直接仍然有效;只有导入时的扫描被压制.

这个属性是用于页面的. 狦琌 捆绑成一个你没有写的页面 —— CMS 块,插件,部件掉入他人模板——没有 <html> 在范围中标注在您之前 import 评估。 导入没有扫描的库 :

import WaveformPlayer from '@arraypress/waveform-player/no-autoinit';

// Identical in every other way. Nothing is initialized until you say so:
WaveformPlayer.init( myContainer );
new WaveformPlayer( el, { url: 'track.mp3' } );

同样的课,相同的选项,相同的 window.WaveformPlayer船舶作为无害环境管理和CJS。 每捆选择一个入境点——每个入境点都带有自己的类别副本和自己的实例登记册.

这种瞄准镜初始化——它不是消毒剂. playIcon 编号 : pauseIcon (及其资源) data-play-icon 编号 : data-pause-icon 等值),针对任何您所构建的玩家按设计注入原始标记. 未经信任的内容在到达页面前仍需进行消毒.

文档

每个选项、风格、事件和方法都记录在文件网站上.

- > (中文) docs.waveformplayer.com 请检查url=值 (帮助)

选项 • 妇女 波形样式 • 妇女 活动 • 妇女 方法 • 妇女 无障碍

扩展名 : 栏 • 妇女 播放列表 • 妇女 跟踪器 • 妇女 常规 —— 说 框架: 反应 • 妇女 阴道 • 妇女 丝绒 • 妇女 天体

许可证

麻省理工学院 矩阵压力

版本与发布记录

@arraypress/waveform-player 共发布 62 个版本,首次发布于 2025/09/14;过去 12 个月发布了 54 个版本。

版本发布日期距今
1.30.0latest2026/10/2117 天前
1.29.12026/09/281 个月前
1.29.02026/09/281 个月前
1.28.12026/09/251 个月前
1.28.02026/09/241 个月前
1.27.12026/09/241 个月前

关于 @arraypress/waveform-player 的常见问题

@arraypress/waveform-player 是什么?

有波形可视化的轻量级自定义音频播放器

如何安装 @arraypress/waveform-player?

在项目目录运行 npm install @arraypress/waveform-player,或使用 pnpm add / yarn add / bun add。

@arraypress/waveform-player 支持 TypeScript 吗?

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

@arraypress/waveform-player 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@arraypress/waveform-player 需要什么版本的 Node.js?

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

@arraypress/waveform-player 可以商用吗?

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

@arraypress/waveform-player 的下载量有多少?

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

@arraypress/waveform-player 还在维护吗?

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