版本已弃用

Netease Mini Player v1 已停止维护并归档,请立即访问最新版本 v2。

访问新版

🎵 NeteaseMiniPlayer

轻量级网易云音乐迷你播放器 - 纯原生 JavaScript 实现

📖 快速开始

一个轻量级的网易云音乐迷你播放器库,使用纯原生 JavaScript 和 CSS 开发,基于NeteaseCloudMusicApi的网易云API二次开发

1. 引入文件

你可以选择本地引入或 CDN 引入:

HTML - 本地文件
<!-- 引入样式和脚本 -->
<link rel="stylesheet" href="netease-mini-player.css">
<script src="netease-mini-player.js"></script>
HTML - CDN 引入
<!-- 引入样式和脚本 -->
<link rel="stylesheet" href="https://api.hypcvgm.top/NeteaseMiniPlayer/netease-mini-player.css">
<script src="https://api.hypcvgm.top/NeteaseMiniPlayer/netease-mini-player.js"></script>

2. 添加播放器

HTML - 基础用法
<!-- 基础用法 -->
<div class="netease-player" 
     data-playlist-id="14273792576"></div>

<!-- 完整配置 -->
<div class="netease-player" 
     data-playlist-id="14273792576" 
     data-position="bottom-right"
     data-embedded="false"></div>

🎛️ 播放器模式

播放器支持两种模式:页面模式嵌入模式,通过 data-embedded 属性控制。

🌐 页面模式 (默认)

HTML
<div class="netease-player" 
     data-playlist-id="14273792576" 
     data-embedded="false"></div>
  • 固定定位在页面角落
  • 支持缩小/展开功能
  • 可拖拽移动位置
  • 适合作为页面背景音乐

📦 嵌入模式

HTML
<div class="netease-player" 
     data-playlist-id="14273792576" 
     data-embedded="true"></div>
  • 相对定位,嵌入页面内容
  • 无缩小按钮
  • 响应式宽度适配
  • 适合作为内容组件
嵌入模式演示:下面是一个嵌入在页面内容中的播放器示例

📍 位置配置

页面模式下,通过 data-position 属性可以设置播放器在页面中的固定位置:

左上角
top-left
顶部居中
top-center
右上角
top-right
左下角
bottom-left
底部居中
bottom-center
右下角
bottom-right
HTML - 位置示例
<!-- 示例:左上角位置 -->
<div class="netease-player" 
     data-playlist-id="14273792576" 
     data-position="top-left"></div>

✨ 主要特性

🎨 拟态化设计

采用现代拟态化(Neumorphism)设计风格,视觉效果精美

📱 响应式布局

完美适配各种屏幕尺寸,从桌面到移动设备

🎵 完整播放控制

支持播放/暂停、进度控制、音量调节等全功能

🎤 歌词显示

支持原文歌词和翻译歌词同时显示

🔄 自动播放

支持自动下一首、播放列表循环播放

💾 智能缓存

音频 URL 智能缓存,减少网络请求

🎛️ 双模式支持

支持页面模式和嵌入模式,适应不同使用场景

⚡ 轻量无依赖

纯原生实现,文件小巧,加载速度快

🔧 完整 API 参数

HTML - 完整参数
<div class="netease-player"
     data-playlist-id="歌单ID"     
     data-position="位置"         
     data-embedded="嵌入模式"></div>

参数说明:

🛠️ JavaScript API

JavaScript - API 使用
// 获取所有播放器实例
const players = window.NeteaseMiniPlayer.instances;

// 重新初始化所有播放器
window.NeteaseMiniPlayer.init();

// 销毁所有播放器
window.NeteaseMiniPlayer.destroy();

// 获取特定播放器实例
const playerElement = document.querySelector('.netease-player');
const player = window.NeteaseMiniPlayer.instances.get(playerElement);

// 播放器控制方法
if (player) {
    player.play();        // 播放
    player.pause();       // 暂停
    player.next();        // 下一首
    player.prev();        // 上一首
    player.setVolume(0.5); // 设置音量 (0-1)
}

🎯 使用场景示例

场景1: 博客背景音乐

HTML - 博客背景音乐
<!-- 页面模式,右下角,可缩小 -->
<div class="netease-player" 
     data-playlist-id="14273792576" 
     data-position="bottom-right"
     data-embedded="false"></div>

场景2: 文章内嵌播放器

HTML - 文章内嵌播放器
<!-- 嵌入模式,融入页面内容 -->
<div class="netease-player" 
     data-playlist-id="14273792576" 
     data-embedded="true"></div>

场景3: 多个播放器

HTML - 多个播放器
<!-- 不同歌单的多个播放器 -->
<div class="netease-player" 
     data-playlist-id="14273792576" 
     data-position="top-left"></div>
     
<div class="netease-player" 
     data-playlist-id="另一个歌单ID" 
     data-position="bottom-right"></div>
注意: 由于该页面极其依赖 http://iwenwiki.com:3000/ 网站的API,以及二次API代理(因为根据浏览器规则无法加载http页面,需要进行代理,代理服务器可能不稳),如果服务异常可能API服务器异常,建议本地部署NeteaseCloudMusicApi来获取稳定API