本帖最后由 neqq3 于 2025-12-19 17:34 编辑
本版本带来了里程碑式的功能更新：**原生支持 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 > 集成 > 右上角自定义仓库 添加)
2025.12.19 - 深度适配 Music Assistant：新增 Jellyfin API 支持v1.7.0 - 深度适配 Music Assistant：新增 Jellyfin API 支持继上版本提供 OpenSubsonic 接入后，本版本新增了 Jellyfin API 协议 支持。通过模拟 Jellyfin 服务端逻辑，进一步提升了在 Music Assistant (MA) 中的使用体验。相较于 Subsonic 方式，该接入方式显著改善了封面显示与歌单搜索功能。
核心功能更新1. Music Assistant 的 Jellyfin 方式接入本项目现已支持模拟 Jellyfin 协议，可作为 MA 的 "Jellyfin Media Server Library" 供应商接入。 - 体验升级：
- 封面显示正常：jellyfin的接入方式解决了上个版本中歌曲封面无法独立显示的问题，现在jellyfin接口提供的 Tracks（单曲）可以正常展示其各自的原始封面。
- 歌单原生搜索：歌单现在可以被正常搜索到，无需再映射至专辑分类。
已知局限与使用说明由于接口协议转换的限制以及 Music Assistant 的原生交互设计，目前仍存在以下待优化的细节： 1. 歌手页面交互限制由于 Jellyfin 接口无法返回歌手的热门单曲（Top Tracks），当前歌手页面仅能展示：
* **不能显示热门单曲。
注意：MA 歌手页面的 " LAY" 按钮默认尝试播放热门单曲。由于接口未提供单曲列表，点击此按钮会报错。但这属于交互逻辑冲突，不影响点击下方专辑进行正常播放。
2. 歌单（Playlists）访问途径变更受协议接口限制，jellyfin接入时，MA 左侧边栏的 "laylists" 选项无法直接读取云音乐收藏的歌单。 作为替代，我们提供了更灵活的访问途径： - 搜索获取：在全局搜索中输入“我的歌单”，并将目标过滤限制为 "laylists"，系统即可返回您收藏的云音乐歌单。
接入方式：
全屏歌词网页已经支持了MA产生的播放器，能够支持云音乐在MA里提供的歌曲！
下载见：https://bbs.hassbian.com/thread-30903-1-1.html
| 
发表于 2025-12-18 17:33:17
别睡了 快起来更新啊