Home Assistant Snapcast Snapshot 动作实战快照与恢复多房间音频播放状态【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 用户文档中 Snapcast 集成提供的snapcast.snapshot动作展开它的作用、在 UI 与 YAML 中的完整配置方式、动作目标target的匹配规则以及如何与snapcast.restore配合搭建一套“门铃响铃时打断音乐、铃响结束后从原位置继续播放”的自动化方案。读完本文你可以在自己的 Home Assistant 实例中直接复用示例 YAML实现对一组或多组 Snapcast 音箱播放状态的非破坏性中断与精确恢复。Snapcast 动作定位snapshot 解决什么问题Snapcast 是一套多房间音频系统一个服务器Snapserver分发音频流多个客户端Snapclient 音箱同步播放。Home Assistant 通过 Snapcast 集成hub 类型配置流方式添加把这些音箱暴露为media_player域实体并提供专属的snapcast动作域。snapcast.snapshot动作的作用是保存一个或多个 Snapcast 音箱当前的播放状态以便稍后用 Restore 动作恢复到同一状态。典型场景是——门铃响了、或者要播一段通知音你希望打断当前音乐播放完又能从刚才的曲目位置继续而不是让通知音把整首曲目的播放进度冲掉。该动作的基本信息如下来源动作文档 frontmatter属性值动作名称snapcast.snapshot所属域snapcast实体域media_player目标必须是 media_player 实体附加选项无UI 与 YAML 中均无额外 data 字段相关动作snapcast.restore、snapcast.set_latency在 UI 中配置 Snapshot 动作如果偏好可视化编排Home Assistant 会一步步引导完成无需编写 YAML。完整操作步骤继承自原文档进入Settings Automations scenes设置 自动化与场景打开一个已有的自动化或脚本或选择Create automation Create new automation如果是新建自动化先在When区域添加触发器脚本不需要触发器它由其他机制调用执行在Then do区域点击Add action选择要控制的对象在By target下选择要快照的 Snapcast 音箱实体在该目标列出的可用动作中选择Snapshot点击Save保存。原文档明确说明此动作在 UI 中没有额外可配置选项——选择目标后即可使用全部参数只有一个target。YAML 中的 Snapshot 动作在 YAML 中该动作以snapcast.snapshot为键。最小可用示例原文档基础示例action: | action: snapcast.snapshot target: entity_id: media_player.snapcast_living_room执行后所选音箱的当前播放状态即被保存。文档同样强调YAML 中此动作也没有额外选项即不存在data:下的业务参数唯一必选项是target。动作目标target的匹配规则原文档引用了统一的目标说明页 targets.md其内容适用于本动作值得完整掌握因为它是批量控制多音箱的关键该动作要求必须指定 targettarget 是动作的作用对象。你可以把动作指向单个实体也可以指向设备、区域、楼层或标签Home Assistant 会解析出该目标背后的所有匹配的media_player实体并逐一执行Entity某一个具体的 media_player 实体例如media_player.snapcast_living_roomDevice属于某台设备的所有 media_player 实体Area某个房间/区域内的所有 media_player 实体Floor某个楼层上的所有 media_player 实体Label共享某个标签的所有 media_player 实体。还可以在同一个动作中混合多种目标类型例如同时指定一个具体实体和一个区域动作会同时作用于两者。这对“全屋音箱统一快照”的场景非常实用——例如给所有 Snapcast 音箱统一打一个snapcast_zones标签一个labeltarget 就能覆盖全部音箱。完整自动化示例门铃打断播放、结束后恢复原文档给出的实战示例是最核心的部分门铃按下时先对音箱做快照播放一段铃声音频延迟一段时间后恢复播放。完整 YAML 如下可直接复制到自动化/脚本中使用automation: | alias: Doorbell chime with resume triggers: - trigger: state entity_id: binary_sensor.doorbell to: on actions: - action: snapcast.snapshot target: entity_id: media_player.snapcast_living_room - action: media_player.play_media target: entity_id: media_player.snapcast_living_room data: media_content_id: media-source://media_source/local/doorbell.mp3 media_content_type: music - delay: 00:00:10 - action: snapcast.restore target: entity_id: media_player.snapcast_living_room逐步拆解这段编排的调用链触发器binary_sensor.doorbell状态变为on门铃按钮按下第一步snapcast.snapshot把客厅 Snapcast 音箱的当前播放状态存入快照第二步media_player.play_media通过 play_media 动作播放本地门铃音频media-source://media_source/local/doorbell.mp3请将路径替换为你实例中真实的媒体源地址第三步delay: 00:00:10留出 10 秒让铃声完整播放完毕避免恢复动作与铃声抢同一播放通道第四步snapcast.restore调用 Restore 动作将音箱还原为第一步保存的播放状态。几个实践要点延迟时长应与铃声时长匹配。示例中 10 秒对应一段 10 秒的门铃声如果铃声更短或更长应相应调整delay否则恢复时可能仍在播放铃声或出现短暂静默snapshot 与 restore 必须作用于同一音箱或同一组音箱。restore 文档的 “Good to know” 明确指出必须先对相同音箱执行过 snapshot否则没有可恢复的状态如果希望多房间统一打断可把两个 snapcast 动作的target改为区域或标签见上一节的 target 规则而play_media仍只指向门口那只音箱。验证与调试原文档引用的通用验证入口try_it.md提供了无需 YAML 的验证方式打开Settings Tools Actions设置 工具 动作搜索snapcast.snapshot填入目标实体后点击Perform action即可在真实实体上执行一次快照无需写任何配置。随后用同一入口执行一次snapcast.restore即可验证快照—恢复这对动作在你实例上工作正常。如果配置不生效原文档提供了“遇到问题”求助入口stuck 说明建议按自动化日志顺序检查触发器是否命中、每个动作是否执行成功。相关动作与配套能力snapcast域下与 snapshot 配合使用的主要动作来源set_latency 文档、restore 文档snapcast.restore把音箱恢复到之前 snapshot 保存的状态同样无附加选项仅要求 targetsnapcast.set_latency以毫秒为单位设置音箱的音频延迟取值 1–1000用于微调某个走慢速链路的音箱与其他音箱的同步。YAML 示例action: | action: snapcast.set_latency target: entity_id: media_player.snapcast_kitchen data: latency: 100在“门铃打断”类自动化之外snapshot restore 的组合模式也适用于语音播报、定时提醒等一切需要临时接管播放通道的场景先快照、再播放、最后恢复三步即可保证用户的音乐从不被“打断丢失”。小结与延伸阅读动作文档snapcast.snapshot、snapcast.restore、snapcast.set_latency集成文档Snapcast 集成说明如何把 Snapcast 服务器接入 Home Assistant动作目标规则targets 说明配合使用的媒体动作media_player.play_media。一句话记忆snapcast.snapshot与snapcast.restore构成一对“保存/恢复”原语参数极少只有 target、行为确定是多房间音频自动化中实现无损打断的标准组合。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Home Assistant Snapcast Snapshot 动作实战快照与恢复多房间音频播放状态【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 用户文档中 Snapcast 集成提供的snapcast.snapshot动作展开它的作用、在 UI 与 YAML 中的完整配置方式、动作目标target的匹配规则以及如何与snapcast.restore配合搭建一套“门铃响铃时打断音乐、铃响结束后从原位置继续播放”的自动化方案。读完本文你可以在自己的 Home Assistant 实例中直接复用示例 YAML实现对一组或多组 Snapcast 音箱播放状态的非破坏性中断与精确恢复。Snapcast 动作定位snapshot 解决什么问题Snapcast 是一套多房间音频系统一个服务器Snapserver分发音频流多个客户端Snapclient 音箱同步播放。Home Assistant 通过 Snapcast 集成hub 类型配置流方式添加把这些音箱暴露为media_player域实体并提供专属的snapcast动作域。snapcast.snapshot动作的作用是保存一个或多个 Snapcast 音箱当前的播放状态以便稍后用 Restore 动作恢复到同一状态。典型场景是——门铃响了、或者要播一段通知音你希望打断当前音乐播放完又能从刚才的曲目位置继续而不是让通知音把整首曲目的播放进度冲掉。该动作的基本信息如下来源动作文档 frontmatter属性值动作名称snapcast.snapshot所属域snapcast实体域media_player目标必须是 media_player 实体附加选项无UI 与 YAML 中均无额外 data 字段相关动作snapcast.restore、snapcast.set_latency在 UI 中配置 Snapshot 动作如果偏好可视化编排Home Assistant 会一步步引导完成无需编写 YAML。完整操作步骤继承自原文档进入Settings Automations scenes设置 自动化与场景打开一个已有的自动化或脚本或选择Create automation Create new automation如果是新建自动化先在When区域添加触发器脚本不需要触发器它由其他机制调用执行在Then do区域点击Add action选择要控制的对象在By target下选择要快照的 Snapcast 音箱实体在该目标列出的可用动作中选择Snapshot点击Save保存。原文档明确说明此动作在 UI 中没有额外可配置选项——选择目标后即可使用全部参数只有一个target。YAML 中的 Snapshot 动作在 YAML 中该动作以snapcast.snapshot为键。最小可用示例原文档基础示例action: | action: snapcast.snapshot target: entity_id: media_player.snapcast_living_room执行后所选音箱的当前播放状态即被保存。文档同样强调YAML 中此动作也没有额外选项即不存在data:下的业务参数唯一必选项是target。动作目标target的匹配规则原文档引用了统一的目标说明页 targets.md其内容适用于本动作值得完整掌握因为它是批量控制多音箱的关键该动作要求必须指定 targettarget 是动作的作用对象。你可以把动作指向单个实体也可以指向设备、区域、楼层或标签Home Assistant 会解析出该目标背后的所有匹配的media_player实体并逐一执行Entity某一个具体的 media_player 实体例如media_player.snapcast_living_roomDevice属于某台设备的所有 media_player 实体Area某个房间/区域内的所有 media_player 实体Floor某个楼层上的所有 media_player 实体Label共享某个标签的所有 media_player 实体。还可以在同一个动作中混合多种目标类型例如同时指定一个具体实体和一个区域动作会同时作用于两者。这对“全屋音箱统一快照”的场景非常实用——例如给所有 Snapcast 音箱统一打一个snapcast_zones标签一个labeltarget 就能覆盖全部音箱。完整自动化示例门铃打断播放、结束后恢复原文档给出的实战示例是最核心的部分门铃按下时先对音箱做快照播放一段铃声音频延迟一段时间后恢复播放。完整 YAML 如下可直接复制到自动化/脚本中使用automation: | alias: Doorbell chime with resume triggers: - trigger: state entity_id: binary_sensor.doorbell to: on actions: - action: snapcast.snapshot target: entity_id: media_player.snapcast_living_room - action: media_player.play_media target: entity_id: media_player.snapcast_living_room data: media_content_id: media-source://media_source/local/doorbell.mp3 media_content_type: music - delay: 00:00:10 - action: snapcast.restore target: entity_id: media_player.snapcast_living_room逐步拆解这段编排的调用链触发器binary_sensor.doorbell状态变为on门铃按钮按下第一步snapcast.snapshot把客厅 Snapcast 音箱的当前播放状态存入快照第二步media_player.play_media通过 play_media 动作播放本地门铃音频media-source://media_source/local/doorbell.mp3请将路径替换为你实例中真实的媒体源地址第三步delay: 00:00:10留出 10 秒让铃声完整播放完毕避免恢复动作与铃声抢同一播放通道第四步snapcast.restore调用 Restore 动作将音箱还原为第一步保存的播放状态。几个实践要点延迟时长应与铃声时长匹配。示例中 10 秒对应一段 10 秒的门铃声如果铃声更短或更长应相应调整delay否则恢复时可能仍在播放铃声或出现短暂静默snapshot 与 restore 必须作用于同一音箱或同一组音箱。restore 文档的 “Good to know” 明确指出必须先对相同音箱执行过 snapshot否则没有可恢复的状态如果希望多房间统一打断可把两个 snapcast 动作的target改为区域或标签见上一节的 target 规则而play_media仍只指向门口那只音箱。验证与调试原文档引用的通用验证入口try_it.md提供了无需 YAML 的验证方式打开Settings Tools Actions设置 工具 动作搜索snapcast.snapshot填入目标实体后点击Perform action即可在真实实体上执行一次快照无需写任何配置。随后用同一入口执行一次snapcast.restore即可验证快照—恢复这对动作在你实例上工作正常。如果配置不生效原文档提供了“遇到问题”求助入口stuck 说明建议按自动化日志顺序检查触发器是否命中、每个动作是否执行成功。相关动作与配套能力snapcast域下与 snapshot 配合使用的主要动作来源set_latency 文档、restore 文档snapcast.restore把音箱恢复到之前 snapshot 保存的状态同样无附加选项仅要求 targetsnapcast.set_latency以毫秒为单位设置音箱的音频延迟取值 1–1000用于微调某个走慢速链路的音箱与其他音箱的同步。YAML 示例action: | action: snapcast.set_latency target: entity_id: media_player.snapcast_kitchen data: latency: 100在“门铃打断”类自动化之外snapshot restore 的组合模式也适用于语音播报、定时提醒等一切需要临时接管播放通道的场景先快照、再播放、最后恢复三步即可保证用户的音乐从不被“打断丢失”。小结与延伸阅读动作文档snapcast.snapshot、snapcast.restore、snapcast.set_latency集成文档Snapcast 集成说明如何把 Snapcast 服务器接入 Home Assistant动作目标规则targets 说明配合使用的媒体动作media_player.play_media。一句话记忆snapcast.snapshot与snapcast.restore构成一对“保存/恢复”原语参数极少只有 target、行为确定是多房间音频自动化中实现无损打断的标准组合。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
