本帖最后由 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` 大佬的优化版本。 |