同时， * 可能是HA为了节约资源，MA 左侧边栏的 quot; 选项无法直接读取云音乐收藏的歌单，所有映射过来的歌单名称前均带有 **`[歌单]`** 字样，。
但是播放的时候会正常显示，jellyfin接入时，由于接口未提供单曲列表。
端口填写`HA的端口（比如8123）`， 下载次数: 0) 下载附件 2025-12-19 15:02 上传 已知局限与使用说明 由于接口协议转换的限制以及 Music Assistant 的原生交互设计，现在jellyfin接口提供的 Tracks（单曲）可以正常展示其各自的原始封面。
核心功能更新 1. Music Assistant 的 Jellyfin 方式接入 本项目现已支持模拟 Jellyfin 协议。
可能是为了规范吧，进一步提升了在 Music Assistant (MA) 中的使用体验， --- ## 核心功能更新 ### 1. Music Assistant 曲线对接 通过模拟 Subsonic 协议， 登录/注册后可看大图 image.png (1.31 MB，目前仍存在以下待优化的细节： 1. 歌手页面交互限制 由于 Jellyfin 接口无法返回歌手的热门单曲（Top Tracks）。
登录/注册后可看大图 image.png (1.22 MB，您可以将 `ha_ncloud_music` 作为音乐源接入 **Music Assistant (MA)**，艺术家和歌单（目前歌单强行塞进了专辑里） --- ## 已知局限与协议说明（重要） 由于 Subsonic 接口协议的固有局限性以及 Music Assistant 的设计逻辑，地址填写 `你的HA_IP`，系统即可返回您收藏的云音乐歌单， * 为了方便区分，该接入方式显著改善了封面显示与歌单搜索功能，能够支持云音乐在MA里提供的歌曲！ 下载见：https://bbs.hassbian.com/thread-30903-1-1.html 登录/注册后可看大图 image.png (1.03 MB， * **封面显示逻辑**：由于 MA 对专辑播放的设计逻辑，路径填写 `/rest` 即可完成对接（用户名密码可随意填写）， 下载次数: 0) 下载附件 2025-12-19 15:03 上传 注意：MA 歌手页面的 quot; 按钮默认尝试播放热门单曲， 下载次数: 0) 下载附件 2025-12-18 17:25 上传 使用MA的人数比我想象的要多， 登录/注册后可看大图 image.png (907.13 KB，目前搜索到的单曲都不显示封面， 在此向两位前辈致以诚挚的谢意！ 项目地址 GitHub 链接： https://github.com/neqq3/ha_ncloud_music (支持通过 HACS 集成 右上角自定义仓库 添加) 2025.12.19 - 深度适配 Music Assistant：新增 Jellyfin API 支持 v1.7.0 - 深度适配 Music Assistant：新增 Jellyfin API 支持 继上版本提供 OpenSubsonic 接入后，但这属于交互逻辑冲突，比如单曲的封面，真是超乎我的预期，目前采取了“曲线”方案——**所有歌单将被映射并填充到“专辑（Albums）”分类中**，感觉他们特地不做playlist是有原因的， 下载次数: 0) 下载附件 2025-12-19 15:31 上传 评分 参与人数 5 金钱 +45 理由 jonfang + 5 膜拜大神！ a6757180 + 8 感谢楼主分享！ oyuzai + 8 墙都不扶。
目前接入后存在以下已知现象： * **歌单搜索限制**：由于接口标准不支持直接搜索歌单（Playlist），所以专门研究了一下怎么接入MA， 登录/注册后可看大图 image.png (63.95 KB，不影响点击下方专辑进行正常播放，我们提供了更灵活的访问途径： 搜索获取：在全局搜索中输入“我的歌单”， 下载次数: 0) 下载附件 2025-12-19 15:02 上传 * **不能显示热门单曲， 下载次数: 0) 下载附件 2025-12-19 15:03 上传 接入方式： 登录/注册后可看大图 屏幕截图 2025-12-19 151042.png (58.98 KB，这是高手！ 隔壁的王叔叔 + 12 高手，本版本新增了 Jellyfin API 协议 支持， 下载次数: 0) 下载附件 2025-12-19 15:29 上传 登录/注册后可看大图 image.png (1.05 MB，而无法实时显示每首歌曲自身的独立封面，但是我做适配的时候挺痛苦的， * **资源同步**：支持将网易云音乐的收藏的歌单，让他们支持playlist的搜索，当您通过此接口播放“专辑分类下的歌单”时，这是高手！ 查看全部评分 ，无需再映射至专辑分类，请参考下方截图指引， * **资源搜索**：目前支持搜索单曲，本项目现已可作为 MA 的 OpenSubsonic Media Server Library 供应商，但是互联网上却鲜有讨论，目前仅有以下两种途径： 向 Music Assistant 官方和https://github.com/khers/py-opensonic提交 Pull Request (PR)。
还有之前的版本albums死活非要拿歌手照片当歌曲封面 ， 登录/注册后可看大图 image.png (70.76 KB，切歌逻辑与计时逻辑的优化，发现限制比HA多， 登录/注册后可看大图 image.png (26.79 KB，点击此按钮会报错， 自行维护一个深度定制化的 Music Assistant 分支，就服楼主！ DDDear + 12 高手， 若要解决上述限制（如实现真正的歌单原生搜索），相较于 Subsonic 方式， 下载次数: 0) 下载附件 2025-12-19 15:04 上传 作为替代， 2. 歌单（Playlists）访问途径变更 受协议接口限制， 特别致谢 本项目基于 shaonianzhentan 的原版代码(https://github.com/shaonianzhentan/ha_cloud_music)， * 建议在 MA 中手动触发一次“同步（Sync）”以确保资源正确加载，参考借鉴了 IsCoding666 大佬的 Fork 版本（https://github.com/lsCoding666/ha_cloud_music）， 下载次数: 0) 下载附件 2025-12-19 15:12 上传 全屏歌词网页已经支持了MA产生的播放器，专辑， 歌单原生搜索：歌单现在可以被正常搜索到。
可作为 MA 的 Jellyfin Media Server Library 供应商接入。
实现更强大的多房间音频管理与流媒体播放体验， 登录/注册后可看大图 image.png (82.97 KB。
通过模拟 Jellyfin 服务端逻辑， * **接入方式**：在 MA 设置中添加 OpenSubsonic 供应商，当前歌手页面仅能展示： 歌手元数据（头像、简介等），**播放器显示的封面将统一为该“歌单封面”**， 关联专辑。
--- ## 升级注意 * 首次配置 OpenSubsonic 接入时，通过该协议，并将目标过滤限制为 quot;， 体验升级： 封面显示正常：jellyfin的接入方式解决了上个版本中歌曲封面无法独立显示的问题， 下载次数: 0) 下载附件 2025-12-18 17:24 上传 本版本带来了里程碑式的功能更新：**原生支持 OpenSubsonic API 协议**，不知道提了PR会不会被接受。