论坛官方淘宝店 论坛定制品牌，官方淘宝店 预先打乱 ：现在开启随机后，后台会预先排好一个乱序的队列。 直观变化 ：在媒体库 (Media Browser) 里可以看到“随机播放队列”，能看到下一首播什么。 防重复 ：尽量避免了短时间内听到同一首歌。 直观变化 ：在媒体库 (Media Browser) 里可以看到“随机播放队列”，能看到下一首播什么。 防重复 ：尽量避免了短时间内听到同一首歌。 防重复 ：尽量避免了短时间内听到同一首歌。 1f4af5aa5cc81d888aeffe72f661f4c5.png (176.12 KB, 下载次数: 0) 2025-12-9 17:10 上传 8c358f540116c18cf8c51b80e4d6456e.png (130 KB, 下载次数: 0) 2025-12-9 17:11 上传 支持在 Dashboard 里输入关键词 -> 点击搜索 -> 下拉直接选歌。 搜索结果会同步挂载到媒体库里，方便看大图封面。 搜索结果会同步挂载到媒体库里，方便看大图封面。 image.png (57.29 KB, 下载次数: 0) 2025-12-9 17:28 上传 image.png (1.01 MB, 下载次数: 0) 2025-12-9 17:12 上传 主要是适配了新版 HA 的代码规范，解决了无法加载集成的问题。 顺手加了几个 button 实体（每日推荐、我喜欢的音乐），方便接入自动化。目前喜欢的歌和每日推荐好像只能给第一个添加的媒体播放器使用。但是不影响整体使用，因为搜索之类的是全部媒体共用的。目前还在思考优化的实现逻辑。 顺手加了几个 button 实体（每日推荐、我喜欢的音乐），方便接入自动化。目前喜欢的歌和每日推荐好像只能给第一个添加的媒体播放器使用。但是不影响整体使用，因为搜索之类的是全部媒体共用的。目前还在思考优化的实现逻辑。 217f7428d8957736e238bd710e4179e9.png (36.16 KB, 下载次数: 0) 2025-12-9 17:11 上传 image.png (26.51 KB, 下载次数: 0) 2025-12-9 17:16 上传 备份 ：备份你的 HA 配置。 移除旧版 ：在 HACS 和集成页面移除原版 ha_cloud_music。 重启 ：重启 Home Assistant。 安装新版 ：通过 HACS 自定义仓库添加我的 GitHub 地址进行安装。 配置 ：重新添加集成并登录。 移除旧版 ：在 HACS 和集成页面移除原版 ha_cloud_music。 重启 ：重启 Home Assistant。 安装新版 ：通过 HACS 自定义仓库添加我的 GitHub 地址进行安装。 配置 ：重新添加集成并登录。 重启 ：重启 Home Assistant。 安装新版 ：通过 HACS 自定义仓库添加我的 GitHub 地址进行安装。 配置 ：重新添加集成并登录。 安装新版 ：通过 HACS 自定义仓库添加我的 GitHub 地址进行安装。 配置 ：重新添加集成并登录。 多级音质支持：支持从标准至母带级共 9 种规格的音质选项。 权益自动协商：播放器将根据当前登录账号的权益配置，自动请求该权益范围内的最高可用音质。 视觉分级提示：配置界面采用可视化符号（⚪/?/?）标识不同码率等级的硬件解码需求与带宽负载情况 权益自动协商：播放器将根据当前登录账号的权益配置，自动请求该权益范围内的最高可用音质。 视觉分级提示：配置界面采用可视化符号（⚪/?/?）标识不同码率等级的硬件解码需求与带宽负载情况 视觉分级提示：配置界面采用可视化符号（⚪/?/?）标识不同码率等级的硬件解码需求与带宽负载情况 image.png (82.7 KB, 下载次数: 0) 2025-12-11 15:51 上传 链路自动寻址：当主播放链路响应超时、连接重置或仅返回试听片段时，系统将自动尝试备用路由策略。 异常自动降级：在遇到网络波动或源文件不可访问时，播放器可自动切换至高可用链路，确保播放不中断。 异常自动降级：在遇到网络波动或源文件不可访问时，播放器可自动切换至高可用链路，确保播放不中断。 尽量修复了在手动拖拽进度条或跳转播放时，歌词时间戳与音频流不同步的问题（该有不同步还是有，只是现在切歌之类的情况下能尽量保持不同步的一致，不会一会快一点，一会慢一点）。 优化了歌词传输协议，减少前端渲染抖动。 优化了歌词传输协议，减少前端渲染抖动。 切歌时的元数据（封面、标题、艺术家）加载延迟大幅降低，提升了 UI 交互的流畅度。 国际化支持：规范了 zh-Hans 与 en 语言文件，优化了配置界面的文案指引。 代码重构：移除冗余的调试代码，优化了异步方法的调用开销。 代码重构：移除冗余的调试代码，优化了异步方法的调用开销。 建议升级后重启 Home Assistant 以加载新的配置选项。 新的音质选项位于集成“选项”页面中，默认为“极高 (320k)”。 新的音质选项位于集成“选项”页面中，默认为“极高 (320k)”。 ha_ncloud_music.search (搜索并播放) 输入关键词和类型（单曲/歌单/电台/专辑/歌手），自动播放搜索结果的第一项。 适用场景：语音控制“播放奥特曼的歌”。 ha_ncloud_music.play_by_id (ID 播放) 通过云音乐 ID 精准播放。 ha_ncloud_music.play_daily / play_favorites 直接播放“每日推荐”或“我喜欢的音乐”。 输入关键词和类型（单曲/歌单/电台/专辑/歌手），自动播放搜索结果的第一项。 适用场景：语音控制“播放奥特曼的歌”。 适用场景：语音控制“播放奥特曼的歌”。 ha_ncloud_music.play_by_id (ID 播放) 通过云音乐 ID 精准播放。 ha_ncloud_music.play_daily / play_favorites 直接播放“每日推荐”或“我喜欢的音乐”。 ha_ncloud_music.play_daily / play_favorites 直接播放“每日推荐”或“我喜欢的音乐”。 直接播放“每日推荐”或“我喜欢的音乐”。

/cloud_music/api?action=lyric&id=xxx: 获取完整歌词数据（LRC/YRC）。 /cloud_music/api?action=song_detail&id=xxx: 获取歌曲详情元数据。 /cloud_music/api?action=song_detail&id=xxx: 获取歌曲详情元数据。 image.png (79.48 KB, 下载次数: 0) 2025-12-13 11:50 上传 image.png (75.55 KB, 下载次数: 0) 2025-12-13 11:50 上传 原有 UI 实体（Text/Button）依然保留，仅建议在 Dashboard 手动操作时使用。 建议将现有的自动化脚本迁移至新的 Service Call 方式。 升级后请重启 Home Assistant。 建议将现有的自动化脚本迁移至新的 Service Call 方式。 升级后请重启 Home Assistant。 升级后请重启 Home Assistant。 屏幕截图 2025-12-13 111437.png (1.15 MB, 下载次数: 0) 2025-12-13 11:47 上传 屏幕截图 2025-12-13 104104.png (1005.31 KB, 下载次数: 0) 2025-12-13 11:47 上传 image.png (43.41 KB, 下载次数: 0) 2025-12-14 16:14 上传 image.png (48.48 KB, 下载次数: 0) 2025-12-14 16:15 上传 打开 HACS → 前端 点击右上角 ⋮ → 自定义存储库 添加 https://github.com/neqq3/ha_ncloud_music_card，类别选择「Dashboard」 安装「云音乐歌词卡片」 刷新浏览器 点击右上角 ⋮ → 自定义存储库 添加 https://github.com/neqq3/ha_ncloud_music_card，类别选择「Dashboard」 安装「云音乐歌词卡片」 刷新浏览器 添加 https://github.com/neqq3/ha_ncloud_music_card，类别选择「Dashboard」 安装「云音乐歌词卡片」 刷新浏览器 安装「云音乐歌词卡片」 刷新浏览器 下载 ncloud-lyrics-card.js 到 HA 配置目录的 www/ 文件夹 在仪表盘添加资源： 设置 → 仪表盘 → ⋮ → 资源 添加 /local/ncloud-lyrics-card.js，类型选择 JavaScript 模块 在仪表盘添加资源： 设置 → 仪表盘 → ⋮ → 资源 添加 /local/ncloud-lyrics-card.js，类型选择 JavaScript 模块 设置 → 仪表盘 → ⋮ → 资源 添加 /local/ncloud-lyrics-card.js，类型选择 JavaScript 模块 添加 /local/ncloud-lyrics-card.js，类型选择 JavaScript 模块 七种模式支持： 基础模式：AI DJ（只有歌曲）、默认推荐、熟悉的歌、探索新歌。 场景模式：运动 (Exercise)、专注 (Focus)、夜晚情绪 (Night Emo)。 基础模式：AI DJ（只有歌曲）、默认推荐、熟悉的歌、探索新歌。 场景模式：运动 (Exercise)、专注 (Focus)、夜晚情绪 (Night Emo)。 场景模式：运动 (Exercise)、专注 (Focus)、夜晚情绪 (Night Emo)。 image.png (34.36 KB, 下载次数: 0) 2025-12-15 02:16 上传 Dashboard 上的全局快捷按钮（每日推荐、私人 FM、我喜欢的音乐）将直接控制指定的默认设备，不再生成冗余的实体列表。 image.png (70.33 KB, 下载次数: 0) 2025-12-15 02:17 上传 ha_ncloud_music.play_fm：支持自动化调用 FM 播放，可选具体模式（如 aidj, focus）。 ha_ncloud_music.fm_trash：FM 不喜欢（垃圾桶）服务，执行“标记不喜欢 + 自动切下一首”操作。 ha_ncloud_music.fm_trash：FM 不喜欢（垃圾桶）服务，执行“标记不喜欢 + 自动切下一首”操作。 image.png (82.18 KB, 下载次数: 0) 2025-12-15 02:17 上传 状态同步：重构音量监听逻辑，解决双向同步不准确问题，增加静音功能；优化底层设备离线时的状态处理。 性能优化：用户信息改为异步加载，避免阻塞事件循环；引入线程锁机制确保并发操作下的数据一致性；优化 API 缓存过期策略。 性能优化：用户信息改为异步加载，避免阻塞事件循环；引入线程锁机制确保并发操作下的数据一致性；优化 API 缓存过期策略。 建议升级后进入集成选项设置默认播放器。 FM 模式下无法开启“随机播放”为设计预期的行为。 FM 模式下无法开启“随机播放”为设计预期的行为。 Archiver | 手机版 | 小黑屋 | Hassbian ( 晋ICP备17001384号-1 ) | 网站地图 GMT+8, 2026-9-27 20:20 , Processed in 0.017761 second(s), 4 queries , Redis On. Powered by Discuz! X3.5 © 2001-2026 Discuz! Team .