Home Assistant Yamaha select_scene 动作详解在自动化与脚本中切换功放场景【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读yamaha.select_scene是 Home Assistant 中用于控制 Yamaha 网络影音接收器AV Receiver的动作action它允许你在自动化或脚本中直接切换功放上预配置的场景例如电影观看场景、收音机收听场景等。本文以 yamaha.select_scene 动作文档 为核心结合 Yamaha 集成文档完整讲解该动作的 UI 操作路径、YAML 配置字段、目标target选择方式、调试方法及其在家庭影院自动化中的实战用法。读完本文你将能够在自动化中一键切换 Yamaha 功放的音视频场景并掌握该动作在底层与媒体播放器实体的绑定关系。动作概述yamaha.select_scene用于在 Yamaha 接收器上选择一个场景scene。所谓场景是 Yamaha 功放本身预置的一组音视频参数组合例如面向电影观影的TV Viewing场景、面向纯音频收听的Radio场景等。在 Home Assistant 中调用该动作相当于通过遥控器按下功放上的场景按键但可以将其无缝嵌入到自动化流程中。该动作属于yamaha域domain目标实体类型为media_player。在动作文档的元数据中它还关联了两个常用动作方便组合使用yamaha.enable_output启用或禁用功放的输出端口如 HDMI 端口常用于切换场景后配套调整输出通道yamaha.menu_cursor模拟功放菜单方向键操作用于浏览 NET RADIO 等菜单类音源。前置条件先接入 Yamaha 功放在使用yamaha.select_scene之前需要先把功放作为媒体播放器集成到 Home Assistant 中。根据 Yamaha Network Receivers 集成文档在configuration.yaml中做如下最小化配置media_player: - platform: yamaha该集成支持 HTR-4065、RX-V473、RX-V573、RX-V585、RX-V673、RX-V685、RX-V773、RX-V3067 等型号以及更多型号。文档特别强调必须启用接收器的网络待机network standby功能否则在功放处于关机状态时Home Assistant 启动过程可能会挂起等待。更完整的配置示例包含主机地址、音源与分区重命名等media_player: - platform: yamaha host: 192.168.0.10 source_ignore: - AUX - HDMI6 source_names: HDMI1: ChromeCast AV4: Vinyl zone_ignore: - Zone_2 zone_names: Main_Zone: Family Room接入成功后每个分区zone会生成一个media_player实体例如media_player.living_room_stereo主区或media_player.living_room_stereo_zone_2Zone 2。yamaha.select_scene的动作目标正是这些media_player实体。在用户界面中使用该动作在 UI 中配置该动作的完整步骤如下对应 动作文档 的 UI 章节进入SettingsAutomations scenes设置 自动化与场景打开已有的自动化或脚本或选择Create automationCreate new automation新建自动化如果新建的是自动化在When触发条件区域添加一个触发器脚本则无需触发器脚本在别处调用它时才运行在Then do执行动作区域选择Add action添加动作在By target按目标详见下文目标选择下选择要控制的功放在该目标可用的动作列表中选择Yamaha: Select scene设置要切换的Scene场景点击Save保存。UI 中的选项选项说明是否必填Scene要选择的场景名称例如TV Viewing必填在 UI 模式下无需编写任何 YAMLHome Assistant 会引导你逐步完成目标选择与选项设置见 ui_header.md。在 YAML 中使用该动作如果你更习惯直接编写 YAML或在自动化、脚本中需要精确控制可以按如下方式引用该动作动作名称为yamaha.select_sceneaction: | action: yamaha.select_scene target: entity_id: media_player.living_room_stereo data: scene: TV Viewing上面的示例将在media_player.living_room_stereo客厅音响上选择TV Viewing场景。注意动作引用本身采用 YAML 块语法action: |内层才是完整的动作调用结构。YAML 选项字段说明类型是否必填scene要选择的场景名称例如TV Viewingstring必填scene的值必须与功放内预置场景的名称完全一致建议在 UI 中确认功放实际显示的场景名后再填入 YAML。目标选择Targetsyamaha.select_scene必须指定目标target目标是动作的作用对象。你可以把目标指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标下所有匹配的media_player实体执行动作详见 targets.md实体Entity单个media_player实体如media_player.living_room_stereo设备Device属于某个设备的所有media_player实体区域Area某个房间或区域内的所有media_player实体楼层Floor某个楼层上的所有media_player实体标签Label共享某个标签的所有media_player实体。你也可以在同一次动作中混合多种目标类型例如同时指定一个实体和一个区域让动作同时作用于两者。实战场景观影模式一键切换结合 Yamaha 集成支持的分区与音源能力yamaha.select_scene非常适合构建一键观影类自动化。一个完整的实战示例是电视打开时自动将功放切到TV Viewing场景、启用对应 HDMI 输出并设置音量。automation: - alias: Movie night setup trigger: - platform: state entity_id: media_player.tv to: on action: - action: yamaha.select_scene target: entity_id: media_player.living_room_stereo data: scene: TV Viewing - action: yamaha.enable_output target: entity_id: media_player.living_room_stereo data: port: hdmi1 enabled: true - action: media_player.volume_set target: entity_id: media_player.living_room_stereo data: volume_level: 0.35这里把yamaha.select_scene与关联动作 yamaha.enable_output启用 HDMI1 输出及媒体播放器通用动作组合使用体现了动作文档中列出的相关动作组合使用的典型模式。需要说明的是yamaha.select_scene切换的是功放内预置场景而集成文档中还提到play_media动作支持NET RADIO音源通过分隔的菜单路径如BookmarksInternetWAMC 90.3 FMMusicCast 设备为RadioFavoritesWAMC 90.3 FM播放网络收音机。如果你的目标是构建收音机收听场景可以先播放电台再用场景动作固化参数两者可互补使用。立即尝试与排障在 Actions 面板直接测试无需编写任何 YAML就可以在开发工具中验证该动作进入SettingsToolsActions工具 动作搜索yamaha.select_scene填写字段后点击Perform action执行动作即可在真实实体上看到执行效果见 try_it.md。这是排查场景名是否正确目标实体是否可被控制等问题的首选方式。仍然无法工作如果动作执行不符合预期可以参考 stuck.md 的排障思路在社区论坛发帖时附上你调用的动作、目标实体以及期望与实际结果能更快获得帮助也可以向 AI 助手用自然语言描述你的需求让它协助解释动作字段或推荐正确的动作组合。此外务必回顾前置条件——接收器是否开启了网络待机、host配置是否正确、场景名是否与功放端一致。总结yamaha.select_scene是 Home Assistant 控制 Yamaha 网络功放场景切换的核心动作通过 UI 的可视化引导或 YAML 的精确编写你可以在自动化与脚本中一键切换电影、收音机等预置场景并借助目标系统将动作批量作用于实体、设备、区域、楼层或标签。结合yamaha.enable_output、yamaha.menu_cursor等关联动作以及 Yamaha 集成的分区能力可以构建出完整的观影、听音自动化方案。在动手之前请确保功放已完成接入并开启网络待机且场景名称与功放端完全一致。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考