Home Assistant 使用 soundtouch.play_everywhere 让全部 Bose SoundTouch 设备同步播放【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistanthome-assistant.io 文档仓库中soundtouch.play_everywhere动作展开讲解如何让家中所有 Bose SoundTouch 设备一次性播放同一内容、如何在 UI 与 YAML 中配置该动作并结合仓库中的相邻动作建组、加成员、减成员说明其底层机制与典型使用场景。读完本文你将能够在自动化、脚本或开发者工具中熟练使用多房间同步播放并理解它与 Zone 分组 API 的关系。动作概述一键全屋同步播放在 Home Assistant 中soundtouch.play_everywhere是一个由 Bose SoundTouch 集成ha_domain: soundtouch媒体播放器平台提供的动作。其官方定义为Plays the same content on all Bose SoundTouch devices.也就是说使用该动作可以让所有已接入 Home Assistant 的 Bose SoundTouch 设备同时播放同一个内容源。它本质上是创建一个包含全部设备的多房间 Zone的快捷方式你只需指定一个Leader主设备其余设备会自动加入该 Zone 并跟随主设备播放。相关文档见 soundtouch.play_everywhere.markdown。这一设计在 Bose SoundTouch 的多房间机制中称为 Zone一个 Zone 由一台 Leader 设备协调其余设备作为 Follower跟随设备播放与 Leader 相同的内容。play_everywhere与以下三个动作共享同一套 Zone 概念见 soundtouch.create_zone.markdown、soundtouch.add_zone_slave.markdown、soundtouch.remove_zone_slave.markdown动作作用soundtouch.create_zone由 Leader 与一个或多个 Follower 创建多房间 Zonesoundtouch.add_zone_slave向已有 Zone 添加一个或多个 Followersoundtouch.remove_zone_slave从已有 Zone 移除一个或多个 Followersoundtouch.play_everywhere快捷创建包含全部设备的 Zone指定一台设备为 Leader前置条件接入 Bose SoundTouch 集成在调用该动作之前需要先完成 Bose SoundTouch 设备的接入。根据 soundtouch.markdown 集成文档该集成类型为 device支持配置流ha_config_flow: true并通过 Zeroconf 自动发现设备ha_zeroconf: true集成提供的平台为media_player每个设备会生成形如media_player.soundtouch_living_room的实体集成特性为 Local Polling本地轮询通信发生在局域网内。接入完成后Home Assistant 中会出现一台或多台媒体播放器实体它们既是 Zone 的候选成员也是play_everywhere中 Leader 字段的取值来源。集成自带的多媒体能力作为背景知识集成本身还支持两类播放方式可与 Zone 播放配合使用详见 soundtouch.markdown# 播放 6 个预配置电台预设之一media_content_id: 1..6 - action: media_player.play_media target: entity_id: media_player.soundtouch_living_room data: media_content_id: 1..6 media_content_type: PLAYLIST # 播放 HTTP 音频 URL注意仅支持 HTTP不支持 HTTPS - action: media_player.play_media target: entity_id: media_player.soundtouch_living_room data: media_content_id: http://example.com/music.mp3 media_content_type: MUSIC文档仓库还特别注明TTS 服务如 Google text-to-speech、Amazon Polly只有在 Home Assistant 以 HTTP 而非 HTTPS 提供服务时才能被设备直接拉取如需公网 HTTPS 发布官方建议通过 NGINX 反向代理让内网设备以 HTTP 访问 TTS 文件。在 UI 中使用该动作如果你更习惯可视化搭建自动化与脚本可以在界面中逐步完成配置无需编写 YAML对应 ui_header.md 的说明。按照 soundtouch.play_everywhere.markdown 的步骤进入SettingsAutomations scenes打开一个已有的自动化或脚本或选择Create automationCreate new automation若新建自动化在When部分添加触发器脚本不需要触发器它们由其他内容调用时执行在Then do部分选择Add action在搜索框中搜索并选择Bose SoundTouch: Play everywhere在Leader字段中选择媒体播放器——该设备负责协调分组并提供播放内容点击Save保存。UI 中的选项选项说明必填Leader协调分组的主媒体播放器其内容将在所有设备上播放是需要注意该动作不支持 targets。在其他动作中常用的目标实体选择方式在此处不适用设备只能在Leader字段中显式指定。在 YAML 中使用该动作如果你直接编写 YAML或想确切了解 Home Assistant 底层做了什么可以参考技术参考对应 yaml_header.md 的说明。YAML 中该动作的名称为soundtouch.play_everywhere。基础示例文档仓库给出的基本示例如下见 soundtouch.play_everywhere.markdownaction: soundtouch.play_everywhere data: master: media_player.living_room该示例将客厅设备的内容同步到所有 SoundTouch 设备上播放。YAML 选项字段说明必填类型master协调分组的主媒体播放器其内容在所有设备上播放是string与create_zone动作不同play_everywhere只需提供master一个参数设备集合由动作内部自动枚举为全部设备无需像create_zone那样显式罗列slaves列表。与相邻动作的对比示例为了更清晰地理解该动作的定位可对比仓库中 Zone 系列动作的 YAML 写法见 soundtouch.create_zone.markdown、soundtouch.add_zone_slave.markdown、soundtouch.remove_zone_slave.markdown# 创建 Zone客厅为 Leader厨房与卧室为 Follower action: soundtouch.create_zone data: master: media_player.living_room slaves: - media_player.kitchen - media_player.bedroom# 向已有 Zone 添加成员 action: soundtouch.add_zone_slave data: master: media_player.living_room slaves: - media_player.office# 从已有 Zone 移除成员移除最后一个 Follower 会解散 Zone action: soundtouch.remove_zone_slave data: master: media_player.living_room slaves: - media_player.office可以这样理解四者的分工create_zone精确控制哪些设备进组add_zone_slave/remove_zone_slave动态增删组成员而play_everywhere是全量分组的一键快捷方式——省去枚举所有设备的步骤适合全家一起听这类场景。在自动化与脚本中的实战将play_everywhere融入自动化或脚本时注意以下几点触发器与脚本自动化需要触发器When 部分脚本不需要触发器直接由其他自动化、服务调用或仪表盘按钮触发组合使用可以先调用media_player.play_media让 Leader 播放指定内容再调用soundtouch.play_everywhere使全部设备跟随播放也可以先建组、播放再通过remove_zone_slave逐步解散某个房间的播放解散 Zone根据 soundtouch.remove_zone_slave.markdown 的说明移除最后一个 Follower 会销毁整个 Zone之后若需重新分组必须重新创建实体命名master字段填写的是 Leader 的media_player.xxx实体 ID例如示例中的media_player.living_room实际 ID 取决于设备在集成接入后生成的实体名称。动手验证在开发者工具中测试按 try_it.md 的指引你可以不写一行 YAML 就验证该动作的效果打开SettingsToolsActions开发者工具中的 Actions 页面搜索soundtouch.play_everywhere在Leader字段选择一个媒体播放器实体点击Perform action。执行后即可观察实际实体状态的变化所有 Bose SoundTouch 设备应同步播放 Leader 的内容。这既是快速排障的手段也是学习动作参数最直观的方式。常见问题排查找不到该动作确认 Bose SoundTouch 集成已成功接入参考 soundtouch.markdown 的配置流说明且至少存在一台media_player实体无法播放 HTTPS 内容设备固件限制仅能访问 HTTP 资源TTS 等场景请按集成文档的建议使用反向代理如 NGINX处理Zone 状态与预期不符检查是否误用了create_zone/remove_zone_slave导致 Zone 被创建或解散play_everywhere是全量语义而 Zone 系列动作是精确增删语义仍未解决官方建议到社区求助发帖时附上你所调用的动作、参数以及预期结果便于他人快速定位见 stuck.md。小结soundtouch.play_everywhere是 Bose SoundTouch 多房间能力在 Home Assistant 中的高效入口一个动作、一个master参数即可让全部设备同步播放同一内容。将其与 soundtouch.create_zone、soundtouch.add_zone_slave、soundtouch.remove_zone_slave 配合使用你就能在自动化与脚本中灵活编排全屋播放—分组管理—逐步退出的完整多房间体验。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考