d0a12847-494a-4347-ae88-d87969ea41c2/README.zh-CN.md

MioIsland 音乐播放器插件

一款原生插件，将实时音乐播放信息带到你的 MioIsland Notch 栏。无需离开工作流，即可查看 Mac 上正在播放的音乐。

功能特性

• 显示当前播放的曲目、艺术家和专辑，支持任何 macOS 音乐应用（Apple Music、Spotify 等）
• 读取系统 NowPlaying 元数据，无需单独配置各个应用
• 轻量级原生 .bundle 插件，资源占用极低
• 流畅的动画界面，与 MioIsland 设计语言一致
• 以头部图标按钮的形式显示在 Notch 栏中

截图

即将添加

安装方式

从 MioIsland 插件商店安装

1. 访问 miomio.chat
2. 找到「音乐播放器」并点击安装
3. MioIsland 会自动下载并激活插件

手动安装

cp -r music-player.bundle ~/.config/codeisland/plugins/

重启 MioIsland 即可加载插件。

从源码编译

环境要求：

• macOS 15.0+
• Xcode 命令行工具
• Swift 5.9+

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