Home Assistant 中 Monoprice 6-Zone 功放快照恢复（monoprice.restore）操作完整指南

Home Assistant 中 Monoprice 6-Zone 功放快照恢复monoprice.restore操作完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文介绍 Home Assistant 中monoprice.restore操作Action的完整用法它用于将 Monoprice 6-Zone 功放的一个或多个分区zone恢复到此前用monoprice.snapshot保存的状态最常见的实战场景是门铃响起 → 保存当前播放状态 → 播放提示音 → 恢复原状态保证提示音播放完毕后各分区无缝回到原来的播放状态。读完本文你将掌握该操作的 UI 配置方式、YAML 调用写法、目标选择Targets机制、与快照操作搭配使用的完整自动化示例以及其底层存储与恢复的行为细节。一、操作概述与适用场景monoprice.restore是 Home Assistant 中 Monoprice 6-Zone Amplifier 集成ha_domain: monoprice类型为 hub平台为 media_player提供的一个操作其官方定义为Restores one or more Monoprice amplifier zones to a previously saved state.也就是说它把目标分区恢复到之前用 monoprice.snapshot 保存的状态。该操作在 集成文档 中由{% include integrations/actions.md %}统一罗列是随集成一起提供的动作之一。恢复操作会一次性还原每个目标分区的四类状态电源状态power status开机还是关机静音状态mute status是否处于静音音量等级volume level当前音量值所选音源selected source该分区当前选择的输入源。最典型的应用场景是门铃/通知音播放先快照保存各分区正在做的事情播放提示音再恢复让每个分区回到播放提示音之前的状态——用户不会因为一个门铃通知而丢失原本的音乐播放。需要特别注意的是该操作只对已保存过快照的分区生效参见 快照操作文档 的说明。如果某个分区从未执行过monoprice.snapshot则没有可恢复的内容。二、在自动化或脚本 UI 中配置恢复操作该操作本身没有任何除 target目标之外的额外参数因此 UI 配置非常简单。官方文档给出了在自动化或脚本中使用它的标准步骤进入设置Settings 自动化与场景Automations scenes打开一个已有的自动化或脚本如果是新建选择创建自动化Create automation 创建新自动化Create new automation若是新建自动化在When当……时区域添加触发条件脚本不需要触发器脚本由其他自动化显式调用时才运行在Then do然后执行区域选择添加操作Add action选择要控制的对象在按目标By target下选择要恢复的分区目标选择详见下文目标Targets机制一节在该目标下显示的动作列表中选择Monoprice 6-Zone Amplifier: Restore恢复点击保存Save。UI 中的选项该操作除目标target外没有其他 UI 选项。三、YAML 中的基本用法在 YAML 中该操作以monoprice.restore引用。官方给出的最小可运行示例如下action: monoprice.restore target: entity_id: media_player.living_room这会将media_player.living_room这个分区恢复为它此前保存的状态。与 UI 一致该操作除目标外没有任何额外的 YAML 选项target是唯一需要提供的参数。如果需要对多个分区同时恢复可以像任何 Home Assistant 操作一样在target中列出多个实体action: monoprice.restore target: entity_id: - media_player.living_room - media_player.kitchen目标Targets机制恢复操作要求必须指定目标。根据官方 targets 模板目标就是操作的作用对象你可以把操作指向单个实体、设备、区域area、楼层floor或标签labelHome Assistant 会对目标背后所有匹配的media_player实体执行该操作实体Entity一个具体的media_player实体例如media_player.living_room设备Device属于某台设备的所有media_player实体区域Area某个房间/区域内的所有media_player实体楼层Floor某一楼层上的所有media_player实体标签Label共享某个标签的所有media_player实体。还可以在同一次操作中混合不同类型的目标例如同时指定一个具体实体和一个区域操作会对两者都执行。四、完整实战门铃提示音后恢复播放的自动化官方文档为monoprice.restore提供了专门的实战示例这也是该操作最常见的落地场景。完整自动化流程为触发条件Trigger门铃按钮被按下状态变为on操作 1Monoprice 6-Zone AmplifierSnapshot快照目标为 Living room操作 2播放门铃提示音操作 3Monoprice 6-Zone AmplifierRestore恢复目标为 Living room。官方给出的完整 YAML 自动化如下automation: 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逐段解读binary_sensor.doorbell状态变为on时触发即门铃被按下第一步monoprice.snapshot把客厅分区的电源、静音、音量、音源四类状态保存下来第二步media_player.play_media在客厅播放位于/local/doorbell.mp3的本地提示音文件media_content_type: musicdelay: 00:00:10让提示音播放 10 秒可按实际提示音长度调整最后monoprice.restore把客厅分区恢复为快照时的状态播放自动回到原来的节目。五、与 Snapshot 操作配合的机制细节要正确使用monoprice.restore必须理解 monoprice.snapshot 的存储行为两者是成对出现的关联操作在文档 front matter 中互为related_actions参见 related 模板 的渲染逻辑快照内容快照保存的是每个目标分区的电源状态、静音状态、音量等级和所选音源每分区只保留最新一份快照对同一分区再次执行monoprice.snapshot会用新的快照覆盖旧的因此先快照 → 播放提示音 → 再恢复必须按顺序连续执行中间不要对同一分区再次快照恢复的前提只有保存过快照的分区才能被恢复从未快照过的分区没有可恢复的状态编辑音源配置会清空快照这是集成文档与两个操作文档共同强调的关键限制——如果在集成选项集成右上角齿轮图标中编辑了音源sources那么已保存的快照会被移除monoprice.restore将无内容可恢复。集成侧的相关配置辅助背景虽然本文聚焦恢复操作本身但了解集成配置有助于理解其运行前提。根据 Monoprice 6-Zone Amplifier 集成文档该集成通过串口连接控制 Monoprice 6-Zone 功放产品型号 p_id10761若使用 IP232 模块而非直接串口连接在端口设置中使用socket://host:port格式音源可在集成选项中编辑但编辑音源会移除已保存的快照与操作文档中的注意事项一致集成为 18 个可能的分区创建设备和实体默认启用前 6 个分区11..16首次运行时尝试自动检测 12 个扩展分区21..26 与 31..36分区可通过常规 Home Assistant 方式启用、禁用和重命名。六、注意事项速查表该操作只对保存过快照的分区生效未快照分区无状态可恢复恢复还原的是电源、静音、音量、音源四类状态编辑集成选项中的音源配置会删除已保存的快照导致恢复无内容每分区只保留最近一次快照新的快照会覆盖旧的该操作除 target 外没有其他选项UI 与 YAML 均如此目标支持实体、设备、区域、楼层、标签且可混合指定与monoprice.snapshot配套使用官方推荐快照 → 播放提示音 → 恢复的自动化模式实现提示音播放后各分区无缝回到原状态。七、相关操作这些操作与该操作配合使用效果最佳monoprice.snapshot保存一个或多个 Monoprice 功放分区的当前状态以便之后恢复。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考