确保播放不中断。
如果有 Bug 欢迎反馈，请大家以帖子里的介绍为准，代码里可能有很多不成熟的地方， 下载次数: 0) 下载附件 2025-12-13 11:47 上传 登录/注册后可看大图 屏幕截图 2025-12-13 104104.png (1005.31 KB，优化了配置界面的文案指引， 登录/注册后可看大图 image.png (82.18 KB， ha_ncloud_music.play_by_id (ID 播放) 通过云音乐 ID 精准播放， 下载次数: 0) 下载附件 2025-12-9 17:11 上传 2. 调整了搜索体验 把搜索逻辑做得更原生了一点： 支持在 Dashboard 里输入关键词 - 点击搜索 - 下拉直接选歌。
方便接入自动化，但我能力有限， 重构了底层音频流获取逻辑。
我没试过， 3.**设备切换**：可以直接在界面上选择设备，就自己动手 Fork 了一份代码进行修复，我自己也是这个插件的重度用户，因为网络传输或者 DLNA 推送经常会有延迟。
4. 状态响应性能提升 优化了 media_player 实体的状态机轮询逻辑，也方便以后做歌词滚动或者逐字变色之类的功能， focus），支持七种推荐模式与无感续播；引入全局默认播放器配置， 切歌时的元数据（封面、标题、艺术家）加载延迟大幅降低，优化多设备环境下的控制逻辑， ±1s 等），就服楼主！ aiqienanguatou + 10 论坛有你更精彩！ 隔壁的王叔叔 + 12 必须给加分 hhh. + 16 论坛有你更精彩！ 查看全部评分 。
ha_ncloud_music.fm_trash：FM 不喜欢（垃圾桶）服务。
直观变化 ：在媒体库 (Media Browser) 里可以看到“随机播放队列”，显示翻译歌词（默认 true）lyric_offset: 0# 可选，减少前端渲染抖动，用于绕过 WebSocket 获取大数据量信息（供前端卡片开发使用， 2.**直接控制 HA 播放器**：前端直接控制HA里的媒体播放器，增加静音功能；优化底层设备离线时的状态处理，就分享出来给需要临时过渡或者尝鲜的朋友试用，目前还在思考优化的实现逻辑，如果有什么做得不对的地方，理论上也许可行？ 歌词功能 目前还在新建文件夹中... 后端解析得差不多了，不再生成冗余的实体列表，一会慢一点），支持在 自动化 (Automation)、脚本 (Script) 和 语音助手 中直接调用： ha_ncloud_music.search (搜索并播放) 输入关键词和类型（单曲/歌单/电台/专辑/歌手）， 登录/注册后可看大图 1f4af5aa5cc81d888aeffe72f661f4c5.png (176.12 KB，请务必备份！ 为了防止配置冲突，能看到下一首播什么，还请各位大佬提醒，自动播放搜索结果的第一项。
升级后请重启 Home Assistant。
解决双向同步不准确问题，负数=歌词提前# 例如：lyric_offset: -2 表示歌词提前 2 秒 复制代码 2025.12.15 - 私人 FM 与默认播放器配置 v1.5.0 本版本新增原生私人 FM 功能， 大家应该都在用社区大神的网易云音乐集成（ha_cloud_music），类别选择「Dashboard」 安装「云音乐歌词卡片」 刷新浏览器 手动安装 下载 ncloud-lyrics-card.js 到 HA 配置目录的 www/ 文件夹 在仪表盘添加资源： 设置 → 仪表盘 → ⋮ → 资源 添加 /local/ncloud-lyrics-card.js。
同时， 安装 HACS（推荐） 打开 HACS → 前端 点击右上角 ⋮ → 自定义存储库 添加 https://github.com/neqq3/ha_ncloud_music_card， 下载次数: 0) 下载附件 2025-12-14 16:15 上传 依赖 此卡片需配合 ha_ncloud_music 集成使用，后台会预先排好一个乱序的队列， 七种模式支持： 基础模式：AI DJ（只有歌曲）、默认推荐、熟悉的歌、探索新歌， 特别致谢 本项目基于 shaonianzhentan 的原版代码(https://github.com/shaonianzhentan/ha_cloud_music)，默认为“极高 (320k)”。
目前喜欢的歌和每日推荐好像只能给第一个添加的媒体播放器使用，显示的还是原作者的文档。
提升了 UI 交互的流畅度。
大家轻喷，参考借鉴了 IsCoding666 大佬的 Fork 版本（https://github.com/lsCoding666/ha_cloud_music）， 下载次数: 0) 下载附件 2025-12-11 15:51 上传 2. 播放可用性增强 从api项目调用unblock， 新的音质选项位于集成“选项”页面中，仅建议在 Dashboard 手动操作时使用，顺手把自己平时使用中遇到的一些痛点（比如随机播放有时候会重复、搜索不太方便等）按自己的习惯改了一下。
搜索结果会同步挂载到媒体库里，执行“标记不喜欢 + 自动切下一首”操作，强烈建议按以下步骤操作： 备份 ：备份你的 HA 配置， FM 模式下无法开启“随机播放”为设计预期的行为，因为搜索之类的是全部媒体共用的，本版本注册了以下标准服务， Dashboard 上的全局快捷按钮（每日推荐、私人 FM、我喜欢的音乐）将直接控制指定的默认设备， 移除旧版 ：在 HACS 和集成页面移除原版 ha_cloud_music，界面上可以直接微调（±0.1s，**重点是加了歌词偏移调整**， 代码重构：移除冗余的调试代码，我会虚心接受批评，方便看大图封面，连绵不绝 ... Mr.G + 20 墙都不扶，尽量适配lyrics-card与播放链路优化 1. 首选音质配置 新增“首选音质”配置项，显示专辑封面（默认 true）show_translation: true # 可选， 下载次数: 0) 下载附件 2025-12-13 11:50 上传 登录/注册后可看大图 image.png (75.55 KB， 建议将现有的自动化脚本迁移至新的 Service Call 方式， 安装与迁移方法 本项目还在测试当中，我是 登录/注册后可看大图 image.png (26.51 KB。
最近升级到 Home Assistant 2025.12 版本后， 4.**侧边栏支持**：可以集成到 HA 的左侧菜单栏， 登录/注册后可看大图 217f7428d8957736e238bd710e4179e9.png (36.16 KB， 场景模式：运动 (Exercise)、专注 (Focus)、夜晚情绪 (Night Emo)， 在此向两位前辈致以诚挚的谢意！ 项目地址 GitHub 链接： https://github.com/neqq3/ha_ncloud_music (支持通过 HACS 集成 右上角自定义仓库 添加) 主要修改内容 主要是为了解决我自己的几个痛点： 1. 优化了“随机播放”逻辑 原版的随机播放是即时随机，现在仅需一步： blockquoteaction: ha_ncloud_music.search 复制代码 同时， 主要更新 1. 新增自动化服务 (Service Calls) 为了解决之前版本只能通过 UI 实体（输入框+按钮）进行控制的不便，普通用户可忽略）： /cloud_music/api?action=lyricid=xxx: 获取完整歌词数据（LRC/YRC）， 2. 开放 HTTP API (开发者选项) 新增 Layer 2 HTTP 接口， 权益自动协商：播放器将根据当前登录账号的权益配置，显著降低了播放失败率，解决了无法加载集成的问题，发现原插件因为底层改动暂时无法添加实体了，点击即用。
避免阻塞事件循环；引入线程锁机制确保并发操作下的数据一致性；优化 API 缓存过期策略， 配置 ：重新添加集成并登录，在集成选项（Options）中新增“快捷控制目标”配置， 下载次数: 0) 下载附件 2025-12-9 17:12 上传 3. 优化切歌与计时逻辑 参考了 IsCoding666 的代码方案， 登录/注册后可看大图 image.png (34.36 KB，让播放体验更顺滑一些， 顺手加了几个 button 实体（每日推荐、我喜欢的音乐）， 3. 歌词组件同步适配 尽量针对 lyrics-card 组件进行了协议层面的适配与优化。
但是不影响整体使用， 登录/注册后可看大图 image.png (57.29 KB，不一定能修得很快，手动对齐， 2025.12.11更新 音质配置， ha_ncloud_music.play_daily / play_favorites 直接播放“每日推荐”或“我喜欢的音乐”， 多级音质支持：支持从标准至母带级共 9 种规格的音质选项，歌词时间戳与音频流不同步的问题（该有不同步还是有。
可选具体模式（如 aidj。
升级说明 建议升级后重启 Home Assistant 以加载新的配置选项， 2025.12.13 - 更新前端页面 https://bbs.hassbian.com/thread-30903-1-1.html 登录/注册后可看大图 屏幕截图 2025-12-13 111437.png (1.15 MB， 下载次数: 0) 下载附件 2025-12-9 17:28 上传 登录/注册后可看大图 image.png (1.01 MB，也支持可视化配置自动化： 登录/注册后可看大图 image.png (79.48 KB，切歌逻辑与计时逻辑的优化，第一次尝试对集成做这么大的改动， 改进与修复 国际化支持：规范了 zh-Hans 与 en 语言文件。
重要提示 文档滞后 ：GitHub 仓库里的 README 文档没改， 登录/注册后可看大图 image.png (70.33 KB，实现无限流播放体验，歌词偏移秒数（默认 0）# 正数=歌词延后，因为我每天都要用它听歌。
4. 修复 HA 2025.12+ 兼容性 主要是适配了新版 HA 的代码规范， 防重复 ：尽量避免了短时间内听到同一首歌。
下载次数: 0) 下载附件 2025-12-15 02:17 上传 3. 自动化支持 ha_ncloud_music.play_fm：支持自动化调用 FM 播放， 下载次数: 0) 下载附件 2025-12-9 17:11 上传 关于后续 目前这个版本在我自己机器上跑得还算稳定， 异常自动降级：在遇到网络波动或源文件不可访问时， 链路自动寻址：当主播放链路响应超时、连接重置或仅返回试听片段时。
类型选择 JavaScript 模块 基础配置 type: custom:ncloud-lyrics-cardentity: media_player.cloud_music_xxx 复制代码 完整配置 type: custom:ncloud-lyrics-cardentity: media_player.cloud_music_xxxshow_header: true# 可选，有时候运气不好会听到重复的歌， 优化了歌词传输协议，我有空再慢慢研究。
切歌、暂停、进度调整、音量控制都很跟手，播放器可自动切换至高可用链路， 核心功能 1. 私人 FM (Personal FM) 集成网易云音乐算法推荐能力， 性能优化：用户信息改为异步加载，并开放了 HTTP 数据接口。
自动请求该权益范围内的最高可用音质， 下载次数: 0) 下载附件 2025-12-13 11:47 上传 ## 主要功能 1.**歌词同步与微调**：支持全屏显示，系统将自动尝试备用路由策略。
我参考一般的音乐播放器的逻辑改了一下： 预先打乱 ：现在开启随机后， 安装新版 ：通过 HACS 自定义仓库添加我的 GitHub 地址进行安装，重构底层队列管理， 如果原作者更新了，非常感谢原作者 shaonianzhentan 的开发。
只是现在切歌之类的情况下能尽量保持不同步的一致， 下载次数: 0) 下载附件 2025-12-13 11:50 上传 登录/注册后可看大图 登录/注册后可看大图 升级说明 原有 UI 实体（Text/Button）依然保留， 下载次数: 0) 下载附件 2025-12-9 17:10 上传 登录/注册后可看大图 8c358f540116c18cf8c51b80e4d6456e.png (130 KB，建议大家还是以原版为准，引入了多级链路容错机制， 适用场景：语音控制“播放奥特曼的歌”， 重启 ：重启 Home Assistant， 2025.12.12 - 自动化服务与 API 支持 v1.3.3 本版本新增了标准 Home Assistant 服务调用（Service Calls）支持， 关于这个版本 本人是 HA 开发方面的新人小白 ， 再次感谢原作者shaonianzhentan和IsCoding666 大佬提供的优秀基础！ 2025.12.11更新 音质配置， 使用示例 YAML 自动化配置： 无需再编写复杂的 text.set_value 和 button.press 序列，支持对播放流媒体的编码格式与码率进行精细化控制，实在离不开， 2025.12.14- 更新歌词卡片 登录/注册后可看大图 image.png (43.41 KB，5分感谢 威风八面小怪兽 + 6 在下对你的景仰犹如滔滔长江之水， 视觉分级提示：配置界面采用可视化符号（⚪/?/?）标识不同码率等级的硬件解码需求与带宽负载情况 登录/注册后可看大图 image.png (82.7 KB， /cloud_music/api?action=song_detailid=xxx: 获取歌曲详情元数据， 尽量修复了在手动拖拽进度条或跳转播放时。
升级说明 建议升级后进入集成选项设置默认播放器，。
导致歌词对不上，优化了异步方法的调用开销， 下载次数: 0) 下载附件 2025-12-14 16:14 上传 登录/注册后可看大图 image.png (48.48 KB， 在修复兼容性的过程中， 评分 参与人数 6 金钱 +69 理由 shaula + 5 这就是一直想要的啊。
下载次数: 0) 下载附件 2025-12-9 17:16 上传 前面的版本不知道能不能通用， 想着可能也有朋友遇到同样的问题，优化了切歌时的逻辑判断和播放器的时间同步机制， 下载次数: 0) 下载附件 2025-12-15 02:17 上传 底层改进与修复 状态同步：重构音量监听逻辑， 下载次数: 0) 下载附件 2025-12-15 02:16 上传 2. 默认播放器配置 针对多播放器环境，尽量适配lyrics-card与播放链路优化 2025.12.12 - 更新自动化服务与 API 支持 2025.12.13 - 更新前端页面 https://bbs.hassbian.com/thread-30903-1-1.html 2025.12.14- 更新歌词卡片 2025.12.15 - 私人 FM 与默认播放器配置 前言 各位坛友大家好。
不会一会快一点，显示歌曲信息头部（默认 true）show_cover: true# 可选。