本版本带来了里程碑式的功能更新：**原生支持 OpenSubsonic API 协议**。通过该协议，您可以将 `ha_ncloud_music` 作为音乐源接入 **Music Assistant (MA)**，实现更强大的多房间音频管理与流媒体播放体验。
---
## 核心功能更新
### 1. Music Assistant 曲线对接
通过模拟 Subsonic 协议，本项目现已可作为 MA 的 "OpenSubsonic Media Server Library" 供应商。
* **接入方式**：在 MA 设置中添加 OpenSubsonic 供应商，地址填写 `你的HA_IP`，端口填写`HA的端口（比如8123）`，路径填写 `/rest` 即可完成对接（用户名密码可随意填写）。
* **资源同步**：支持将网易云音乐的收藏的歌单。
* **资源搜索**：目前支持搜索单曲，专辑，艺术家和歌单（目前歌单强行塞进了专辑里）
---
## 已知局限与协议说明（重要）
由于 Subsonic 接口协议的固有局限性以及 Music Assistant 的设计逻辑，目前接入后存在以下已知现象：
* **歌单搜索限制**：由于接口标准不支持直接搜索歌单（Playlist），目前采取了“曲线”方案——**所有歌单将被映射并填充到“专辑（Albums）”分类中**。
* 为了方便区分，所有映射过来的歌单名称前均带有 **`[歌单]`** 字样。
* **封面显示逻辑**：由于 MA 对专辑播放的设计逻辑，当您通过此接口播放“专辑分类下的歌单”时，**播放器显示的封面将统一为该“歌单封面”**，而无法实时显示每首歌曲自身的独立封面。
* 可能是HA为了节约资源，目前搜索到的单曲都不显示封面，但是播放的时候会正常显示。
---
## 升级注意
* 首次配置 OpenSubsonic 接入时，请参考下方截图指引。
* 建议在 MA 中手动触发一次“同步（Sync）”以确保资源正确加载。
使用MA的人数比我想象的要多，但是互联网上却鲜有讨论，真是超乎我的预期。所以专门研究了一下怎么接入MA。发现限制比HA多，可能是为了规范吧，但是我做适配的时候挺痛苦的，比如单曲的封面，还有之前的版本albums死活非要拿歌手照片当歌曲封面 。
若要解决上述限制（如实现真正的歌单原生搜索），目前仅有以下两种途径：
特别致谢 本项目基于 shaonianzhentan 的原版代码(https://github.com/shaonianzhentan/ha_cloud_music)。 同时，切歌逻辑与计时逻辑的优化，参考借鉴了 IsCoding666 大佬的 Fork 版本（https://github.com/lsCoding666/ha_cloud_music）。 在此向两位前辈致以诚挚的谢意！ 项目地址 GitHub 链接： https://github.com/neqq3/ha_ncloud_music (支持通过 HACS > 集成 > 右上角自定义仓库 添加)
| 
发表于 
