找回密码
 立即注册

微信扫码登录

搜索
查看: 1289|回复: 27

[插件集成] Music Assistant 原生云音乐插件

[复制链接]

6

主题

58

回帖

559

积分

高级会员

积分
559
金钱
495
HASS币
0
发表于 2026-1-17 14:08:59 | 显示全部楼层 |阅读模式
本帖最后由 neqq3 于 2026-1-17 14:10 编辑

# v0.1.0 - Music Assistant 原生云音乐插件

image.png

## 核心功能
- **原生集成**:作为 Music Assistant 的原生 Music Provider 运行。
- **扫码登录**:支持通过 MA 界面直接扫码登录云音乐账号。
- **功能支持**:
  - **我的歌单**:同步用户创建和收藏的歌单。
  - **搜索**:支持搜索歌曲、专辑、歌手和歌单。
  - **高清封面**:自动获取高清专辑和歌手封面。
  - **音质选择**:支持多种期望音质选择(实际播放音质取决于账号权益)。
  - **播放优化**:集成 API 的增强播放策略,提升播放成功率。

## 安装说明 (Music Assistant Docker)

1. 下载本 Release 中的 `ncloud_music.zip` 并解压。
2. 将解压出的 `ncloud_music` 文件夹上传到你的 NAS 或服务器(例如 `/volume1/docker/ma/providers/ncloud_music`)。
3. 修改music assistant的 `docker-compose.yaml`,添加挂载:
   ```yaml
   volumes:
     # ⚠️ 请将左侧的 /你的实际存放路径/ncloud_music 替换为你上传的真实路径
     - /你的实际存放路径/ncloud_music:/app/venv/lib/python3.13/site-packages/music_assistant/providers/ncloud_music
   ```
   *(注意:请根据你的 MA 版本确认 Python 路径,可能是 python3.11 或 python3.12)*

## 配置说明
1. 在 MA 设置 -> Providers 中添加 "NCloud Music"。
image.png

2. **API 服务地址**:填入你的 NeteaseCloudMusicApi 地址 (例如 `http://192.168.x.x:3000`)。
   > 本插件依赖 [NeteaseCloudMusicApi-Enhanced](https://github.com/neteasecloudmusicapienhanced/api-enhanced) 运行,请确保你已部署该服务。
image.png


3. 点击 "扫码登录" 按钮获取登录二维码,使用云音乐 APP 扫码登录。
4. **重要**:扫码成功后,**务必点击右上角的“保存”按钮**以保存登录状态。
   > 如需切换账号,请重新点击扫码登录,并在扫码后再次点击“保存”。

## 致谢
感谢 [Music Assistant](https://github.com/music-assistant/server) 团队提供的优秀平台。
感谢 [NeteaseCloudMusicApi-Enhanced](https://github.com/neteasecloudmusicapienhanced/api-enhanced) 提供的 API 支持。

容器挂载插件的路径参考的是https://bbs.hassbian.com/?114397 的 https://bbs.hassbian.com/thread-31141-1-1.html

ncloud_music.zip

25.17 KB, 下载次数: 46

评分

参与人数 1金钱 +8 收起 理由
silent!!! + 8 感谢楼主分享!

查看全部评分

回复

使用道具 举报

5

主题

71

回帖

1394

积分

金牌会员

积分
1394
金钱
1318
HASS币
0
发表于 2026-1-17 14:25:45 | 显示全部楼层
大佬牛逼
HAOS有没有方案哦?找了半天没找到addon的ma路径
回复

使用道具 举报

6

主题

58

回帖

559

积分

高级会员

积分
559
金钱
495
HASS币
0
 楼主| 发表于 2026-1-17 14:58:03 | 显示全部楼层
chaosl 发表于 2026-1-17 14:25
大佬牛逼
HAOS有没有方案哦?找了半天没找到addon的ma路径

你可以使用我的集成https://bbs.hassbian.com/thread-30947-1-1.html来接入
或者在haos里面安装docker的ma。
目前这个插件的定位还比较模糊,暂时定位是面向单独使用ma的人群的。
回复

使用道具 举报

3

主题

50

回帖

356

积分

中级会员

积分
356
金钱
298
HASS币
20
发表于 2026-1-17 16:01:57 | 显示全部楼层
支持这哥们,是你接入了云音乐 API 给 MA,所以才激发我写了补齐歌手专辑封面图的
歌词自动补全也在测试中了
回复

使用道具 举报

79

主题

665

回帖

3407

积分

论坛元老

积分
3407
金钱
2658
HASS币
0
发表于 2026-1-17 20:22:43 | 显示全部楼层
大佬,这是单独把云音乐的服务器放在nas了吧。不用那个集成接入了,对吧。
回复

使用道具 举报

6

主题

58

回帖

559

积分

高级会员

积分
559
金钱
495
HASS币
0
 楼主| 发表于 2026-1-17 20:26:28 | 显示全部楼层
lichao622 发表于 2026-1-17 20:22
大佬,这是单独把云音乐的服务器放在nas了吧。不用那个集成接入了,对吧。 ...

对的,但还是需要那个云音乐api的项目。
回复

使用道具 举报

79

主题

665

回帖

3407

积分

论坛元老

积分
3407
金钱
2658
HASS币
0
发表于 2026-1-17 20:30:31 | 显示全部楼层
neqq3 发表于 2026-1-17 20:26
对的,但还是需要那个云音乐api的项目。

通过加载项安装的ma不能用这个吧。
回复

使用道具 举报

6

主题

58

回帖

559

积分

高级会员

积分
559
金钱
495
HASS币
0
 楼主| 发表于 2026-1-17 20:32:08 | 显示全部楼层
Andychao2025 发表于 2026-1-17 16:01
支持这哥们,是你接入了云音乐 API 给 MA,所以才激发我写了补齐歌手专辑封面图的
歌词自动补全也在测试中 ...

现在头疼的是使用这种接入方式的话加载项怎么使用,感觉ha用户里使用haos的人会很多。不知道ma官方会不会接纳这种需要第三方api的项目呢。
回复

使用道具 举报

79

主题

665

回帖

3407

积分

论坛元老

积分
3407
金钱
2658
HASS币
0
发表于 2026-1-17 20:34:47 | 显示全部楼层
我用的是ha的ma加载项,其实需求是想通过加载项原生接入,哪怕单独建个服务也行,就是不太想用集成然后在转接ma的方式
回复

使用道具 举报

6

主题

58

回帖

559

积分

高级会员

积分
559
金钱
495
HASS币
0
 楼主| 发表于 2026-1-17 20:35:06 | 显示全部楼层
lichao622 发表于 2026-1-17 20:30
通过加载项安装的ma不能用这个吧。

是的。加载项安装的ma本质也是docker。你可以在haos里安装docker版本ma来使用。但是都用haos了,可能使用集成方式接入会更好。如果以后能接入ma官方可能会更好,但是概率不大。目前这个项目只是一个试水吧。
回复

使用道具 举报

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

本版积分规则

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

GMT+8, 2026-2-15 22:50 , Processed in 0.035810 second(s), 4 queries , Redis On.

Powered by Discuz! X3.5

© 2001-2026 Discuz! Team.

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