Music Assistant 点歌机集成(已弃用)
注意:此集成不再主动维护。
Music Assistant 现在有一个插件应当替代使用,且提供了大部分相同功能。 请参阅 https://beta.music-assistant.io/plugins/party-mode/
一个 Home Assistant 集成,提供基于网页的点歌系统,结合 Music Assistant 为宾客打造互动点歌机体验!
功能
- 跨所有连接的 Music Assistant 提供商实时搜索歌曲
- 极简响应式设计,显示专辑封面
- 实时查看当前播放和下一个播放的歌曲
- 宾客无需登录,只需分享网址
- 通过 Home Assistant 实体管理队列
- 当请求队列为空时,自动排入默认派对播放列表
- 控制排队频率(限制队列刷屏)
- 通过 Home Assistant 进行访问控制
- 自动撤销/创建访问令牌以保障安全
前提条件
安装此集成前,请确保您具备:
- 运行 Home Assistant 实例并安装了 Music Assistant 集成
- Home Assistant 中安装了 Music Assistant 服务器插件(分开托管的 HA/MA 实例可能无法工作)
- 在 Music Assistant 中配置了支持的音乐提供商(例如 Spotify、Apple Music 等)
- 在 Home Assistant 中配置了媒体播放器实体
安装
HACS(推荐)
或者
- 将此仓库添加到 HACS 作为自定义仓库
- HACS > 菜单 > 自定义仓库
- URL:
https://github.com/DJS91/HAMusicAssistantJukebox - 分类:集成
- 点击安装
- 重启 Home Assistant
手动安装
- 下载最新版本
- 将
custom_components/music_assistant_jukebox文件夹复制到你的 Home Assistantcustom_components文件夹中 - 重启 Home Assistant
配置
- 进入 设置 > 设备与服务
- 点击“添加集成”
- 搜索“Music Assistant Jukebox”
- 选择你的 Music Assistant 实例和媒体播放器实体
- 进入 设置 > 自动化与场景 > + 创建自动化
- 从列表中选择“Music Assistant Jukebox 控制器”。
- 输入步骤4中相同的媒体播放器实体,输入你的 Music Assistant 默认播放列表名称,然后点击保存。
使用
使用“JukeBox:允许访问”开关开启点唱机。通过新的“Music Assistant Jukebox”侧边栏面板访问点唱机 或者
扫描任意二维码实体 或者
直接访问点唱机界面:
http://homeassistant:8123/local/jukebox/jukebox.html实体
该集成向 Home Assistant 添加了以下实体:开关
switch.jukebox_queue:启用/禁用歌曲排队(无需手动控制,由自动化管理。)switch.jukebox_allow_access:启用/禁用点歌机界面访问权限switch.music_assistant_jukebox_jukebox_play_music_on_start:点歌机开启时是否自动播放默认播放列表的开关。
数值
number.jukebox_queue_length:显示当前队列长度(无需手动调整,由自动化管理)number.music_assistant_jukebox_jukebox_queuing_delay:设置来宾点歌请求之间的延迟(秒)(0 = 关闭)
传感器
music_assistant_jukebox_external_qr_code:外部点歌机 UI 访问二维码图片,便于在仪表板上与非网络用户共享music_assistant_jukebox_internal_qr_code:内部点歌机 UI 访问二维码图片,便于在网络内用户间共享
自动化蓝图
该集成包含一个自动化蓝图,用于处理:
- 队列长度跟踪
- 默认播放列表回退
- 访问控制
- 媒体播放器控制
- 进入 设置 > 自动化与场景
- 点击 “+ 创建自动化”
- 选择 “Music Assistant 点歌机控制器”
- 配置:
- 媒体播放器:选择你的 Music Assistant 媒体播放器
- 默认播放列表:输入你的回退播放列表名称