前言
各位坛友大家好,
大家应该都在用社区大神的网易云音乐集成(ha_cloud_music)。我自己也是这个插件的重度用户,非常感谢原作者 shaonianzhentan 的开发。
最近升级到 Home Assistant 2025.12 版本后,发现原插件因为底层改动暂时无法添加实体了。因为我每天都要用它听歌,实在离不开,就自己动手 Fork 了一份代码进行修复。
关于这个版本
本人是 HA 开发方面的新人小白,第一次尝试对集成做这么大的改动。代码里可能有很多不成熟的地方。如果有什么做得不对的地方,还请各位大佬提醒,我会虚心接受批评。
在修复兼容性的过程中,顺手把自己平时使用中遇到的一些痛点(比如随机播放有时候会重复、搜索不太方便等)按自己的习惯改了一下。
想着可能也有朋友遇到同样的问题,就分享出来给需要临时过渡或者尝鲜的朋友试用。
如果原作者更新了,建议大家还是以原版为准。
特别致谢
本项目基于 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 > 集成 > 右上角自定义仓库 添加)
主要修改内容
主要是为了解决我自己的几个痛点:
1. 优化了“随机播放”逻辑
原版的随机播放是即时随机,有时候运气不好会听到重复的歌。我参考一般的音乐播放器的逻辑改了一下:
2. 调整了搜索体验
把搜索逻辑做得更原生了一点: