仅需两行代码,快速集成网页音乐播放器
这里预留播放器演示视频位置,可展示云端歌单、主题切换、歌词、移动端适配和调试流程。 后续只需替换视频地址即可发布。
从音频生命周期、云端歌单、歌词同步到主题扩展和异常兜底, 播放器把复杂交互收束为稳定的配置与实例 API,接入成本更低,线上表现更可控。
基于 Howler 统一处理加载、播放、暂停、切歌、释放和错误恢复,降低多实例音频资源泄漏风险。
提供 Web Component 标签、IIFE、ESM、npm 和 JS 实例化方式,Vue、React、静态页面都能直接使用。
延迟渲染、懒加载、请求取消和状态节流协同工作,减少首屏压力和高频播放状态更新开销。
内置多套主题,同时支持随机主题、自动主题、CSS 变量和自定义主题样式,适配不同品牌视觉。
支持 LRC、结构化歌词、外链歌词、底部歌词和全屏歌词,切歌时自动处理请求竞态和滚动定位。
支持 Tab、Space、左右方向键控制播放器,并自动避开输入框、滑块和组合键,兼容 macOS 与 Windows。
顺序播放、单曲循环、随机播放、记忆播放和自动播放都可通过属性或实例 API 精确控制。
默认支持云端 api-url,也支持本地歌单和 audioProvider,接口异常时提供重拉歌单、跳歌和连续失败保护。
调试页可视化配置云端接口、本地歌单、主题、音量和播放参数,并生成可直接复制的集成代码。