找回密码
 立即注册

微信扫码登录

搜索
查看: 339|回复: 13

[插件集成] 新版HA可用,增加搜索,优化随机播放:网易云音乐集成 (ha_cloud_music) 个人修改版

[复制链接]
5 金钱 回复本帖可获得 1 金钱奖励! 每人限 1 次

1

主题

12

回帖

170

积分

注册会员

积分
170
金钱
157
HASS币
0
发表于 昨天 17:32 | 显示全部楼层 |阅读模式
本帖最后由 neqq3 于 2025-12-10 01:12 编辑

前言
各位坛友大家好,
大家应该都在用社区大神的网易云音乐集成(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. 优化了“随机播放”逻辑
原版的随机播放是即时随机,有时候运气不好会听到重复的歌。我参考一般的音乐播放器的逻辑改了一下:
  • 预先打乱:现在开启随机后,后台会预先排好一个乱序的队列。
  • 直观变化:在媒体库 (Media Browser) 里可以看到“随机播放队列”,能看到下一首播什么。
  • 防重复:尽量避免了短时间内听到同一首歌。


1f4af5aa5cc81d888aeffe72f661f4c5.png 8c358f540116c18cf8c51b80e4d6456e.png

2. 调整了搜索体验
把搜索逻辑做得更原生了一点:
  • 支持在 Dashboard 里输入关键词 -> 点击搜索 -> 下拉直接选歌。
  • 搜索结果会同步挂载到媒体库里,方便看大图封面。


image.png image.png

3. 优化切歌与计时逻辑
参考了 IsCoding666 的代码方案,优化了切歌时的逻辑判断和播放器的时间同步机制,让播放体验更顺滑一些。也方便以后做歌词滚动或者逐字变色之类的功能。
4. 修复 HA 2025.12+ 兼容性
  • 主要是适配了新版 HA 的代码规范,解决了无法加载集成的问题。
  • 顺手加了几个 button 实体(每日推荐、我喜欢的音乐),方便接入自动化。目前喜欢的歌和每日推荐好像只能给第一个添加的媒体播放器使用。但是不影响整体使用,因为搜索之类的是全部媒体共用的。目前还在思考优化的实现逻辑。


217f7428d8957736e238bd710e4179e9.png

关于后续
目前这个版本在我自己机器上跑得还算稳定。我是
image.png
前面的版本不知道能不能通用,我没试过,理论上也许可行?
歌词功能 目前还在新建文件夹中... 后端解析得差不多了,我有空再慢慢研究。

安装与迁移方法
本项目还在测试当中,请务必备份!
为了防止配置冲突,强烈建议按以下步骤操作:
  • 备份:备份你的 HA 配置。
  • 移除旧版:在 HACS 和集成页面移除原版 ha_cloud_music。
  • 重启:重启 Home Assistant。
  • 安装新版:通过 HACS 自定义仓库添加我的 GitHub 地址进行安装。
  • 配置:重新添加集成并登录。

重要提示
文档滞后:GitHub 仓库里的 README 文档没改,显示的还是原作者的文档,请大家以帖子里的介绍为准。
如果有 Bug 欢迎反馈,但我能力有限,不一定能修得很快,大家轻喷。
再次感谢原作者shaonianzhentan和IsCoding666 大佬提供的优秀基础!


评分

参与人数 2金钱 +28 收起 理由
隔壁的王叔叔 + 12 必须给加分
hhh. + 16 论坛有你更精彩!

查看全部评分

回复

使用道具 举报

1

主题

70

回帖

293

积分

中级会员

积分
293
金钱
222
HASS币
0
发表于 昨天 22:12 | 显示全部楼层

回帖奖励 +1 金钱

厉害了,骚年
回复

使用道具 举报

1

主题

12

回帖

170

积分

注册会员

积分
170
金钱
157
HASS币
0
 楼主| 发表于 12 小时前 | 显示全部楼层
歌词已经有雏形了,现在正在考虑要不要做的炫酷一点,以及做了之后性能开销如何。暂定再单独做一个前端,这样资源消耗更小。想要简单功能可以安装集成就可以,高级功能再安装一个就行。
7acc0d08-112f-4806-ae12-ddae32835053.png
回复

使用道具 举报

15

主题

555

回帖

3182

积分

论坛元老

积分
3182
金钱
2612
HASS币
0
发表于 5 小时前 | 显示全部楼层

回帖奖励 +1 金钱

大佬牛批
回复

使用道具 举报

2

主题

515

回帖

3343

积分

论坛元老

积分
3343
金钱
2826
HASS币
0
QQ
发表于 5 小时前 | 显示全部楼层

回帖奖励 +1 金钱

厉害了,老der
回复

使用道具 举报

79

主题

624

回帖

3214

积分

论坛元老

积分
3214
金钱
2506
HASS币
0
发表于 5 小时前 | 显示全部楼层

回帖奖励 +1 金钱

可以调用音乐搜索功能吗,这个音质怎么样。
回复

使用道具 举报

15

主题

292

回帖

1607

积分

金牌会员

积分
1607
金钱
1290
HASS币
40
发表于 5 小时前 | 显示全部楼层

回帖奖励 +1 金钱

二维码扫码登录报错

"检测到当前设备环境异常本次操作已拦截
您可以尝试以下办法解除异常
方法
1:切换网络或更换设备尝试方法
2:删除如越狱/外挂等异常插件,重启尝试方法
3:更新网易云音乐app至最新版方法
4:不要频繁操作,24H后尝试"
回复

使用道具 举报

15

主题

555

回帖

3182

积分

论坛元老

积分
3182
金钱
2612
HASS币
0
发表于 3 小时前 | 显示全部楼层
搭好了,怎用,前端呢
回复

使用道具 举报

1

主题

12

回帖

170

积分

注册会员

积分
170
金钱
157
HASS币
0
 楼主| 发表于 2 小时前 | 显示全部楼层
lovelyelfpop 发表于 2025-12-10 09:40
二维码扫码登录报错

"检测到当前设备环境异常本次操作已拦截

https://github.com/neteasecloudmusicapienhanced/api-enhanced
换这个项目。之前的已经没人维护了
回复

使用道具 举报

1

主题

12

回帖

170

积分

注册会员

积分
170
金钱
157
HASS币
0
 楼主| 发表于 2 小时前 | 显示全部楼层
jjss520 发表于 2025-12-10 10:52
搭好了,怎用,前端呢

能具体一点吗?不知道是哪一步?你可以看看论坛里关于原作者的集成的教程
https://bbs.hassbian.com/thread-20812-1-1.html
添加集成之类的都基本一样。
api项目换这个https://github.com/neteasecloudmusicapienhanced/api-enhanced
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|Hassbian ( 晋ICP备17001384号-1 )

GMT+8, 2025-12-10 14:44 , Processed in 1.447897 second(s), 8 queries , MemCached On.

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

快速回复 返回顶部 返回列表