Home Assistant 的 Monoprice 多区功放快照动作（monoprice.snapshot）：保存与恢复功放区状态

Home Assistant 的 Monoprice 多区功放快照动作monoprice.snapshot保存与恢复功放区状态【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇文章以 Home Assistant 官方文档仓库中的动作参考页 monoprice.snapshot 动作文档 为骨架讲解如何在自动化与脚本中为 Monoprice 6-Zone Amplifier 保存快照指定功放区当前状态并在播放门铃、通知音后借助配套动作monoprice.restore一键恢复。读完本文你将掌握该动作的 UI 配置与 YAML 写法、目标Target选择规则、快照覆盖与失效的边界条件以及一个可直接落地的门铃播报完整自动化示例。动作概览快照保存了什么monoprice.snapshot是 Monoprice 6-Zone Amplifier集成文档提供的动作之一用于保存一个或多个功放区的当前状态。根据 monoprice.snapshot 文档每次快照会为每个被指定的区保存以下四项电源状态Power status该区当前是开机还是关机静音状态Mute status该区是否处于静音音量级别Volume level当前音量选中音源Selected source当前接入的音源。典型的使用套路是先快照 → 随意改变功放区如播放通知音→ 再用monoprice.restore恢复原状。该动作的 Front Matter 中通过related_actions声明了配套动作monoprice.restore两者在文档中互为补充、成对出现。在用户界面中创建快照动作文档要求从 UI 配置时完整操作步骤如下进入Settings Automations scenes自动化与场景打开一个已有的自动化或脚本如果是新建设置选择Create automation Create new automation创建自动化 创建新自动化如果是新自动化在When触发条件部分添加一个触发器脚本不需要触发器——脚本由其他自动化或实体调用时才会运行在Then do执行动作部分选择Add action添加动作在By target按目标中选择你要快照的功放区详见下文“Targets 目标选择”一节在该目标列出的动作中选择Monoprice 6-Zone Amplifier: Snapshot点击Save保存。关于“目标”的语义仓库中的通用动作目标说明见 source/_includes/actions/targets.md目标就是动作的作用对象可以是单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后所有匹配的media_player实体执行该动作。例如目标选“客厅”这个区域则该区域内所有 Monoprice 功放区实体都会被快照。UI 选项说明文档明确指出该动作除目标target外没有任何额外的选项所有可配置项就是选择哪些功放区。在 YAML 中使用该动作基础示例在 YAML自动化/脚本中动作引用名为monoprice.snapshot。文档给出的基础示例如下action: monoprice.snapshot target: entity_id: media_player.living_room该示例将media_player.living_room这个功放区的当前状态保存下来。YAML 选项说明与 UI 一样YAML 模式下该动作除目标外没有额外的 YAML 选项——只有action与target两个字段。target支持entity_id、device_id、area_id、floor_id、label_id等键并且可以在一次动作中混合不同目标类型例如同时指定一个具体实体和一个区域Home Assistant 会一并处理。动作开发测试入口如果你想在不写任何 YAML 的情况下验证动作行为仓库中的 source/_includes/actions/try_it.md 提供了官方建议打开Settings Tools Actions工具 动作搜索该动作填入目标后点击Perform action执行动作即可在真实实体上观察快照效果。Targets目标选择详解根据 source/_includes/actions/targets.md目标可以是Entity实体单个具体的media_player实体如media_player.living_roomDevice设备该设备下的所有media_player实体Area区域某个房间/区域内的所有media_player实体Floor楼层某个楼层上的所有media_player实体Label标签共享某个标签的所有media_player实体。由于 Monoprice 集成创建的是media_player平台实体见 source/_integrations/monoprice.markdown快照动作的目标最终会展开为一系列对应的媒体播放器实体。Good to know快照的边界与失效条件文档在 Good to know 一节中强调了三点关键行为快照内容每个被指定区保存的是电源、静音、音量、音源四项状态每区只保留最新一份快照再次对同一区执行快照会覆盖上一次保存的结果不存在历史版本编辑集成音源列表会清空快照在集成选项选中集成后右上角的齿轮图标中编辑 Sources 会删除已保存的快照。第 3 点在 Monoprice 集成文档 的 “Configuration notes” 中同样被明确提及“editing sources will remove the snapshot you may have saved”说明该行为是集成层面的设计而非动作层面。相应地配套动作 monoprice.restore 文档 也注明只有先用快照动作保存过状态的功放区才能被恢复一旦快照被编辑音源的操作清空就没有任何东西可以恢复了。实战示例播放门铃音并恢复播放这是文档提供的完整自动化示例也是monoprice.snapshotmonoprice.restore组合最典型的应用场景保存客厅功放区状态 → 播放门铃提示音 → 10 秒后恢复原状。自动化逻辑图形化描述Trigger触发器State状态门铃按钮被按下binary_sensor.doorbell变为onActionMonoprice 6-Zone Amplifier:Snapshot目标为客厅Action播放门铃声音ActionMonoprice 6-Zone Amplifier:Restore目标为客厅。对应的完整 YAML 如下alias: Doorbell announcement on the living room speakers triggers: - trigger: state entity_id: binary_sensor.doorbell to: on actions: - action: monoprice.snapshot target: entity_id: media_player.living_room - action: media_player.play_media target: entity_id: media_player.living_room data: media_content_id: /local/doorbell.mp3 media_content_type: music - delay: 00:00:10 - action: monoprice.restore target: entity_id: media_player.living_room该示例的要点快照动作在任何状态改变之前最先执行确保后续操作播放、延迟不会影响恢复的准确性media_player.play_media播放本地媒体目录下的doorbell.mp3对应仓库 source/_includes/actions/more_examples.md 中“复制示例并按需调整”的用法delay控制通知音的播放时长之后monoprice.restore将客厅功放区恢复为快照时刻的电源、静音、音量与音源状态。该场景也适用于其他通知类自动化比如当门被打开、摄像头检测到人时先快照再播放提示音播完自动还原不会打扰正在收听的音乐或节目。配套动作与进一步了解恢复动作monoprice.restore与快照动作成对使用其文档位于 source/_actions/monoprice.restore.markdown用于把功放区恢复到之前保存的状态文档的 “Related actions” 机制见 source/_includes/actions/related.md会在动作页面自动列出彼此关联的动作。集成级说明Monoprice 集成支持最多 18 个功放区默认启用前 6 个区编号 11..16首次运行时尝试自动检测 12 个扩展区21..26 与 31..36实体可按 Home Assistant 常规方式启用、禁用与重命名详见 source/_integrations/monoprice.markdown。遇到问题时参考 source/_includes/actions/stuck.md 的建议——在社区论坛发帖时附上你调用的动作与预期结果也可使用 AI 助手用自然语言描述需求来获得动作选型建议。掌握快照 恢复这对动作后你可以在不中断用户体验的前提下安全地插入任意临时播报是构建“多区背景音乐 通知”类自动化的重要基础能力。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考