mirror of
https://github.com/xmqywx/mio-plugin-music.git
synced 2026-04-12 03:34:33 +00:00
77 lines
2.0 KiB
Markdown
77 lines
2.0 KiB
Markdown
|
# MioIsland 音乐播放器插件
|
|||
|
|
|
|||
|
|
一款原生插件，将实时音乐播放信息带到你的 MioIsland Notch 栏。无需离开工作流，即可查看 Mac 上正在播放的音乐。
|
|||
|
|
|
|||
|
|
## 功能特性
|
|||
|
|
|
|||
|
|
- 显示当前播放的曲目、艺术家和专辑，支持任何 macOS 音乐应用（Apple Music、Spotify 等）
|
|||
|
|
- 读取系统 NowPlaying 元数据，无需单独配置各个应用
|
|||
|
|
- 轻量级原生 `.bundle` 插件，资源占用极低
|
|||
|
|
- 流畅的动画界面，与 MioIsland 设计语言一致
|
|||
|
|
- 以头部图标按钮的形式显示在 Notch 栏中
|
|||
|
|
|
|||
|
|
## 截图
|
|||
|
|
|
|||
|
|
*即将添加*
|
|||
|
|
|
|||
|
|
## 安装方式
|
|||
|
|
|
|||
|
|
### 从 MioIsland 插件商店安装
|
|||
|
|
|
|||
|
|
1. 访问 [miomio.chat](https://miomio.chat)
|
|||
|
|
2. 找到「音乐播放器」并点击安装
|
|||
|
|
3. MioIsland 会自动下载并激活插件
|
|||
|
|
|
|||
|
|
### 手动安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cp -r music-player.bundle ~/.config/codeisland/plugins/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
重启 MioIsland 即可加载插件。
|
|||
|
|
|
|||
|
|
## 从源码编译
|
|||
|
|
|
|||
|
|
环境要求：
|
|||
|
|
- macOS 15.0+
|
|||
|
|
- Xcode 命令行工具
|
|||
|
|
- Swift 5.9+
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://github.com/xmqywx/mio-plugin-music.git
|
|||
|
|
cd mio-plugin-music
|
|||
|
|
bash build.sh
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
编译脚本会输出：
|
|||
|
|
- `build/music-player.bundle` — 插件文件（复制到 `~/.config/codeisland/plugins/`）
|
|||
|
|
- `build/music-player.zip` — 压缩包，用于上传到插件商店
|
|||
|
|
|
|||
|
|
## 插件架构
|
|||
|
|
|
|||
|
|
| 文件 | 用途 |
|
|||
|
|
|------|------|
|
|||
|
|
| `MioPlugin.swift` | 插件协议定义 |
|
|||
|
|
| `MusicPlugin.swift` | 插件主入口 — 激活、停用、创建视图 |
|
|||
|
|
| `MusicPlayerView.swift` | SwiftUI 视图，显示曲目信息 |
|
|||
|
|
| `MusicHeaderButton.swift` | Notch 栏的头部图标按钮 |
|
|||
|
|
| `NowPlayingBridge.swift` | 桥接 macOS NowPlaying 系统 API |
|
|||
|
|
|
|||
|
|
## 工作原理
|
|||
|
|
|
|||
|
|
插件使用 macOS `MRMediaRemoteGetNowPlayingInfo` API 读取系统级的 NowPlaying 信息。这适用于任何向系统报告播放状态的应用，包括：
|
|||
|
|
|
|||
|
|
- Apple Music
|
|||
|
|
- Spotify
|
|||
|
|
- YouTube（浏览器中）
|
|||
|
|
- VLC
|
|||
|
|
- 任何使用 MPNowPlayingInfoCenter 的应用
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
MIT
|
|||
|
|
|
|||
|
|
## 作者
|
|||
|
|
|
|||
|
|
[@xmqywx](https://github.com/xmqywx)
|