@gfazioli/mantine-audio

中文文档
1.1.10发布于 2026/11/09MITTypeScriptESM + CJS零依赖近 30 天下载 2.9万

由Web Audio API所建的一款以波形可视化和活频谱分析器为React的Mantine-native音频播放器. 化合物成分 API + 无头用 Audio 钩.

中文使用文档
文档目录5 节
  1. 概览
  2. 特征
  3. 安装
  4. 使用量
  5. 发起人

Maintine 音频组件

Mantine Audio

mantine-audio at a glance, refreshed daily: commits, releases, stars, issues and pull requests, a year of commit activity, the weekly rhythm, languages, latest commits and releases, contributors
制造的 外观卡 * 每日刷新

概览

本部分建在 曼汀语Name 图书馆.

这个 曼汀音频 组件是用于反相的 Maintine 内置音频播放器 波形可视 (单位:千美元) 活频谱分析器,在Web Audio API上构建. 单包装为三层:被抛光的默认 <Audio /> 4个变体,一个完全可复合的化合物 API(可以重新排序和重排的10个子组件),一个完全无头 useAudio 钩子可以构建100%自定义 UI.

特征

  • 🎧 滴入播放器 —— 说 <Audio src="…" /> 您有一个风格化,可访问的音频播放器
  • 🧩 化合物 API - 10个分部门Audio.PlayButton, (中文(简体) ), Audio.Timeline, (中文(简体) ), Audio.Waveform, (中文(简体) ), Audio.Spectrum, (中文(简体) ), Audio.VolumeSlider, (中文(简体) ), Audio.SpeedControl,.)可重排和重排
  • 🪝 无头 useAudio 钩子 ——16个状态值+12个完全自定义 UI 动作
  • 🌊 波形可视 ——峰值通过Web Audio+点击/drag来解码以寻求,60fps播放头跟踪通过RAF
  • 🎚️ 活频谱分析器 —— 说 AnalyserNode 驱动、 固态或梯度条, 可选镜像
  • 🔀 多个 <source> 支助 —— 说 sources={[…]} 编码器/格式/介质-克赖里倒置+ fallbackSrc 运行时间错误
  • 🎛️ 5个大小×4个变种 —— 说 xs/sm/md/lg/xl × overlay/minimal/floating/bordered (所有 CSS 通过数据属性驱动)
  • 🌅 asBackground 预设 – 将同一玩家变成一行中的英雄/ 分区环境轨道
  • 🎚️ 有声音的刷子 - 可选 scrubSound 让用户在拖曳时听到片段( Audacity / iTunes 样式)
  • ⌨️ 键盘快捷键 - 空间,J/K/L,QQ/ ,QX/ ,M, > / <
  • 🎨 完整样式 API —— 说 classNames, (中文(简体) ), styles, (中文(简体) ), vars, (中文(简体) ), unstyled,从框中认识到主题
  • 📦 类型脚本 ——严格类型,每个道具都有记载

[!注]

→ 演示文稿和文件 → 更多曼汀组件

安装

npm install @gfazioli/mantine-audio

或者说

yarn add @gfazioli/mantine-audio

在应用程序根部安装导入包样式后:

import '@gfazioli/mantine-audio/styles.css';

使用量

import { Audio } from '@gfazioli/mantine-audio';

function Demo() {
  return <Audio src="/track.mp3" />;
}

上面有波形和自定义跳过按钮的复合布局 :

<Audio src="/track.mp3">
  <Audio.Waveform height={80} />
  <Audio.Controls>
    <Audio.SkipButton seconds={-15} />
    <Audio.PlayButton />
    <Audio.SkipButton seconds={15} />
    <Audio.Timeline />
    <Audio.TimeDisplay />
    <Audio.MuteButton />
    <Audio.VolumeSlider />
    <Audio.SpeedControl />
  </Audio.Controls>
</Audio>

无头用法 useAudio 钩:

import { useAudio } from '@gfazioli/mantine-audio';

function MyPlayer() {
  const { playing, currentTime, duration, peaks, analyser, toggle, audioRef } = useAudio({
    src: '/track.mp3',
  });

  return (
    <div>
      <audio ref={audioRef} crossOrigin="anonymous" />
      <button onClick={toggle}>{playing ? 'Pause' : 'Play'}</button>
      <span>{currentTime.toFixed(1)} / {duration.toFixed(1)}</span>
    </div>
  );
}

发起人

你的支持帮助了我:

  • 积极维护项目,及时修复错误并更新安全信息
  • 添加新特性, 提高性能,并完善开发者的经验
  • 扩大测试范围和文件,以更顺利地采用
  • 确保长期可持续性而不依赖临时自由时间
  • 优先处理最重要的社区请求和路线图项目

开放源码的繁荣,如果受益的人能够回报——即使每月的小额捐款也会产生真正的变化。 赞助有助于覆盖维护时间、基础设施和无数使项目保持健康的无形任务.

你的帮助真的很重要.

💚 成为提案国 今天,帮助我保持这一项目的可靠性,更新,并为每个人成长.

版本与发布记录

@gfazioli/mantine-audio 共发布 18 个版本,首次发布于 2026/05/20;过去 12 个月发布了 18 个版本。

版本发布日期距今
1.1.10latest2026/11/096 天前
1.1.92026/11/069 天前
1.1.82026/10/2621 天前
1.1.72026/10/2224 天前
1.1.62026/10/131 个月前
1.1.52026/10/101 个月前

关于 @gfazioli/mantine-audio 的常见问题

@gfazioli/mantine-audio 是什么?

由Web Audio API所建的一款以波形可视化和活频谱分析器为React的Mantine-native音频播放器. 化合物成分 API + 无头用 Audio 钩.

如何安装 @gfazioli/mantine-audio?

在项目目录运行 npm install @gfazioli/mantine-audio,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.x || ^19.x)、react-dom(^18.x || ^19.x)、@mantine/core(>=9.0.0)、@mantine/hooks(>=9.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gfazioli/mantine-audio 支持 TypeScript 吗?

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

@gfazioli/mantine-audio 支持 ESM 还是 CommonJS?

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

@gfazioli/mantine-audio 可以商用吗?

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

@gfazioli/mantine-audio 的下载量有多少?

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

@gfazioli/mantine-audio 还在维护吗?

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