本帖最后由 neqq3 于 2025-12-13 13:35 编辑
大家好，之前发布了云音乐的后端集成 `ha_ncloud_music` (fork和改自原作者shaonianzhentan的项目——https://github.com/shaonianzhentan/ha_cloud_music)。
但是 HA 自带的媒体卡片功能比较局限，而且我实在是搞不太明白卡片怎么写。
整了个配套的 Web 前端项目 `ha_ncloud_music_web`，主要就是为了能全屏显示歌词。
自己用了一段时间，感觉配合侧边栏 (`panel_iframe`) 放在平板或者副屏上用还行，发出来给有需要的朋友试用。
## 主要功能
1. **歌词同步与微调**：支持全屏显示，**重点是加了歌词偏移调整**。因为网络传输或者 DLNA 推送经常会有延迟，导致歌词对不上，界面上可以直接微调（±0.1s, ±1s 等），手动对齐。
2. **直接控制 HA 播放器**：前端直接控制HA里的媒体播放器，切歌、暂停、进度调整、音量控制都很跟手。
3. **设备切换**：可以直接在界面上选择设备。
4. **侧边栏支持**：可以集成到 HA 的左侧菜单栏，点击即用。
## 界面截图
**集成到 HA 侧边栏的效果：**
**歌词偏移微调：**
**设备选择：**
## ⚠️ 关于 Token 的重要说明 (必读)
**目前的初版方案 (v1.0)** 为了能让前端网页直接控制 Home Assistant 的播放器实体，**需要用户填入 HA 的“长期访问令牌” (Long-Lived Access Token)**。
* **注意安全**：令牌是保存在你本地浏览器的缓存中的。请**不要在公共电脑或不可信的设备上使用**，以免令牌泄露导致安全风险。
* **未来计划**：后续版本我会尝试优化鉴权流程（例如通过后端转发或专用鉴权接口），来解决暴露 Token 的问题。
介意的朋友可以先观望，或者在仅限内网访问的设备上使用。
## 安装方式
**前提**：必须先安装后端组件 `ha_ncloud_music`。(https://bbs.hassbian.com/thread-30870-1-1.html)
**HACS 安装**：
## 使用说明
安装后访问：
http://<HA_IP>:8123/local/community/ha_ncloud_music_web/lyrics-player.html
首次打开需要配置一下 HA 的连接信息，输入令牌。
项目开源，纯属个人兴趣开发，有 bug 或者改进建议可以在 GitHub 提 issue 或者楼下留言。
致谢原作者：我的后端组件 Fork 自 `shaonianzhentan` 大佬的 `ha_cloud_music` 项目，并且参考了 `IsCoding666` 大佬的优化版本。 | 
发表于 
