APlayer 播放器总览与核心能力

它是什么

APlayer 是由 DIYgod 开发并维护的一款轻量级 HTML5 网页音乐播放器。它不依赖 Flash、不嵌入 VLC、不加载任何前端框架，直接基于浏览器原生的 HTML5 Audio API 构建——这意味着它能在所有现代浏览器中直接运行，从桌面 Chrome 到移动 Safari，从微信内置浏览器到跨平台 WebView。

它能做什么

APlayer 的核心功能可以归纳为以下几条：

• 播放音频：支持 MP3、WAV、Ogg Vorbis、MP4 H.264（AAC 或 MP3）等浏览器原生支持的音频格式
• 管理播放列表：一次传入多首音频，自动生成列表 UI，支持循环模式（全部循环 / 单曲循环 / 不循环）和播放顺序（顺序 / 随机）
• 显示实时滚动歌词：通过 LRC 文件、JS 字符串或 HTML 内嵌三种方式传入歌词，播放时逐行高亮、自动滚动到可视区域
• 三种显示形态：正常模式完整展示封面 + 控件 + 列表；吸底模式固定在页面底部；迷你模式只保留一行精简控件
• 主题色定制：全局指定一个主题色；也可以为每首歌单独设置主题色，切歌时自动切换
• HLS 流媒体：配合 hls.js 可以播放 m3u8 直播流
• 丰富的 API 和事件：play / pause / seek / skip / volume / theme 等全套程序化控制，音频事件和播放器事件双重绑定

它不能做什么

了解边界同样重要：

• 不是音频转换工具：APlayer 不提供 mp3 / wav / flac 之间的格式转换，它只负责"播放"
• 不是在线音乐聚合器：纯原生 APlayer 不内置任何音乐源，你需要自己提供音频 URL。如需接入网易云、QQ 音乐等平台，需要配合 MetingJS 使用——这属于 MetingJS 接入音乐平台 要讲的内容
• 不支持原生 FLAC / APE / M4A：这取决于浏览器本身的编解码能力，APlayer 不做额外的解码层
• 没有可视化频谱：如需频谱显示，需要找第三方插件或自行开发

版本与开源

• 当前 npm 最新版本：1.10.1
• npm 包名：aplayer
• 开源许可：MIT（可商用、可修改、可二次分发）
• 主要维护者：DIYgod
• GitHub 仓库：MoePlayer 组织下的 APlayer 仓库

体积参考

APlayer 的压缩产物非常轻量：

• APlayer.min.js 压缩后约 50KB
• APlayer.min.css 压缩后约 15KB
• gzip 传输后两者合计不到 20KB

这比引入 Plyr（约 100KB+）或 Video.js（约 400KB+）要节省得多。

与同类产品对比

APlayer 是这几款里唯一"只做音频"的，这意味着它的界面和 API 都是围绕音乐播放场景设计的，没有视频播放器的冗余逻辑。