发现新文章

1524 字
8 分钟
视奸我 - 网易云音乐播放状态展示
2026-02-27
无标签

视奸我 - 网易云音乐播放状态展示#

将网易云音乐播放状态实时展示在个人主页上。

项目结构#

shijian-music/
├── api/ # API 调试工具
│ ├── music.php # 音乐数据 API
│ └── debug.html # 可视化调试面板
└── shijianwomusic/ # BetterNCM 插件
├── src/main.tsx # 插件源码
└── dist/ # 构建输出(安装此目录)
├── main.js
└── manifest.json
└── shijianwo.plugin

快速开始#

1. 环境要求#

  • PHP 7.4+
  • Web 服务器 (Apache/Nginx)
  • Node.js(用于构建插件)
  • BetterNCM >= 0.2.5

2. 构建插件#

Terminal window
cd shijianwomusic
npm install
npm run build

3. 安装 BetterNCM 插件#

  1. 安装 BetterNCM
  2. 在 BetterNCM 设置中点击 “Open Folder” 打开数据目录
  3. 创建 plugins_dev 文件夹(如果不存在)
  4. shijianwomusic/dist 目录内的文件复制到 plugins_dev/shijianwo-music/
  5. 重启网易云音乐

目录结构:

BetterNCM/
└── plugins_dev/
└── shijianwo-music/
├── main.js
└── manifest.json
└── shijianwo.plugin

4. 配置插件#

  1. 打开网易云音乐
  2. 点击右上角 BetterNCM 图标
  3. 找到 “视奸我-网易云插件”
  4. 点击配置按钮,输入 API 地址:
    http://your-domain.com/music.php
  5. 保存配置

5. 部署主页#

my-index 目录上传到 Web 服务器即可。

API 接口#

基础 URL#

http://your-domain.com/music.php

接口列表#

接口说明
?action=current获取完整播放信息
?action=song仅获取歌曲信息
?action=progress仅获取播放进度
?action=lyrics仅获取歌词
?action=status获取播放状态
?action=health健康检查

POST 更新数据#

POST /music.php?action=update
Content-Type: application/json
{
"playing": {
"isPlaying": true,
"song": {...},
"progress": {...},
"lyrics": {...}
}
}

调试工具#

访问 http://your-domain.com/api/debug.html 可视化查看 API 数据。

功能特点#

  • 实时同步播放状态
  • 显示歌曲名称、艺术家、专辑
  • 播放进度条实时更新
  • 歌词预览
  • 响应式设计,支持移动端

常见问题#

插件列表中看不到插件#

  1. 确保安装的是 dist 目录内的文件
  2. 确保 manifest.jsonmain.js 在同一目录
  3. 重启网易云音乐客户端

配置按钮无响应#

  1. 按 F12 打开开发者工具
  2. 查看控制台是否有错误
  3. 确保 BetterNCM 版本 >= 0.2.5

API 连接失败#

  1. 检查 API 地址是否正确
  2. 确保 PHP 服务器正常运行
  3. 检查跨域配置

歌曲信息为空#

  1. 确保网易云音乐正在播放歌曲
  2. 按 F12 查看控制台日志
  3. 检查 BetterNCM API 是否正常返回数据

demo展示#

这里演示的是直接调用我自己的api,api仅提供数据,播放器显示功能需要自己写#

🎵 正在播放
🎵
未在播放
-
-
00:00 00:00

温馨提醒#

本项目使用AI进行开发#

许可证#

MIT License

发现错误或想要改进这篇文章?

在 GitHub 上编辑此页

文章修订历史 (1 次)

查看变更记录
2026/02/27 3a6bae4

新增文章“视奸我 - 网易云音乐播放状态展示”

视奸我 - 网易云音乐播放状态展示
https://blog.blym.top/posts/project-1
作者
白鹿原嚒
发布于
2026-02-27
许可协议
CC BY-NC-SA 4.0