一个文件即可嵌入
只需要 nmpv3.min.js，样式随脚本注入，不引 CSS、不依赖任何运行时框架
NeteaseMiniPlayer v3
基于 NeteaseCloudMusicApi 的轻量级可插入式音乐播放器 UI 组件库
Skip to content
Apache-2.0Web ComponentVitePress DocsjsDelivrunpkg
按场景接入
HTML / 静态站点适合 GitHub Pages、Hugo、Hexo、Jekyll 和普通静态页面PHP / WordPress Basic适合服务端模板、短代码渲染和 API 代理注入React适合 JSX 类型声明、客户端组件和 Vite React 项目Vue 3适合单文件组件、compilerOptions 和组合式项目Next.js适合 App Router、客户端边界和动态导入Nuxt适合 client plugin、SSR 安全加载和页面组件Astro适合 Astro 页面、组件插槽和静态输出Svelte适合浏览器端动态导入和自定义元素类型扩展
项目定位
NeteaseMiniPlayer v3 是一个面向开源社区维护的网页播放器项目。仓库从 v3 开始拆分为两条产品线：
- NMPv3：轻量播放器。默认只面向网易云音乐，浏览器部署只需要一个
nmpv3.min.js - NMPv3+：高级扩展框架。面向插件、皮肤、自定义来源、自定义歌词、宿主页面联动和框架适配
两条产品线在同一个仓库维护，但功能边界分开。普通嵌入优先使用 NMPv3，需要扩展能力时再使用 NMPv3+。
NMPv3 默认注入的样式都带 nmpv3- 前缀，挂载时会校验容器，不会往 <body> 上写东西， 同一个页面可以同时放多个播放器实例，互不干扰。
推荐入口
html
<script src="https://cdn.jsdelivr.net/npm/netease-mini-player-v3@3.0.1/dist/nmpv3.min.js"></script>
<nmp-player
playlist-id="14273792576"
theme="auto"
layout="compact"
></nmp-player>如果项目已经使用 npm：
bash
npm install netease-mini-player-v3
pnpm add netease-mini-player-v3ts
import "netease-mini-player-v3/auto";