使用 yamaha.menu_cursor 动作控制 Yamaha 功放的屏幕菜单光标【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南以 Home Assistant 官方文档仓库中的 yamaha.menu_cursor 动作文档 为骨架系统讲解如何通过 Home Assistant 向 Yamaha 网络功放发送屏幕菜单OSD光标按键指令——包括上下左右移动、确认select与返回return。读完本文你将掌握该动作在 UI 与 YAML 两种场景下的完整用法、cursor参数的合法取值以及目标target选择机制并能结合yamaha集成的配置与配套动作yamaha.enable_output、yamaha.select_scene搭建出完整的家庭影院自动化。动作是什么一条菜单光标指令yamaha.menu_cursor是 Home Assistant 中yamaha域提供的动作action旧称 service其作用等价于在 Yamaha 功放遥控器上按下一个方向键将功放电视屏幕上显示的系统菜单光标向上、向下、向左、向右移动或者执行确认、返回操作。该动作面向的是Yamaha 网络功放Network Receiver集成相关集成文档位于 source/_integrations/yamaha.markdown。该集成属于媒体播放器media player平台支持 HTR-4065、RX-V473、RX-V573、RX-V673、RX-V773、RX-V3067 等众多型号。这一动作最初于 Home Assistant 2021.7 版本中随yamaha组件新增见 2021.7 发布说明 中 Add a menu_cursor service to the yamaha component 一条。在实际场景中这个动作特别适合用于模拟遥控器按键例如在自动化中先使用yamaha.select_scene切换到看电影场景再用yamaha.menu_cursor在功放菜单中逐级下移并确认某个选项无需用户手动触碰遥控器。前置条件先配置好 yamaha 集成要使用yamaha.menu_cursor首先需要将 Yamaha 功放接入 Home Assistant。根据 yamaha 集成文档在configuration.yaml中最小配置如下# Example configuration.yaml entry media_player: - platform: yamaha配置完成后需重启 Home Assistant 使配置生效。注意必须在功放上开启网络待机network standby否则功放处于关机状态时会导致 Home Assistant 启动挂起。如需更精确的控制可结合集成支持的可选参数详见 yamaha 集成文档 的配置表格# Example configuration.yaml entry 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 Roomhost功放的 IP 地址或主机名source_ignore在界面上隐藏的音源列表source_names将内部音源名如HDMI1重命名为自定义名称如ChromeCastzone_ignore在界面上隐藏的区zone列表zone_names将区名称如Main_Zone重命名为自定义名称如Family Room。配置完成后功放会以media_player实体形式出现在 Home Assistant 中例如media_player.living_room_stereo这就是yamaha.menu_cursor的动作目标。在 UI 中创建自动化或脚本如果偏好可视化编辑可以通过 UI 分步创建使用该动作的自动化或脚本无需编写 YAML对应仓库中的 actions/ui_header.md 模板内容。操作步骤如下进入设置自动化与场景Automations scenes。打开一个已有的自动化或脚本或选择创建自动化创建新自动化。若为新建自动化在当When部分添加一个触发条件脚本不需要触发器脚本由其他方式调用时运行。在然后执行Then do部分选择添加动作Add action。选择要控制的设备在按目标By target下选择要控制的功放目标机制的说明见下文动作目标一节。在该目标展示的动作列表中选择Yamaha: Menu cursor。设置要按下的Cursor键。选择保存。UI 中的选项选项说明必填Cursor要按下的光标键up、down、left、right、select或return是在 YAML 中调用如果需要直接编写 YAML自动化、脚本或通过开发者工具测试或想了解 Home Assistant 底层的精确字段行为可参考 actions/yaml_header.md 中描述的技术参考方式动作名称为yamaha.menu_cursor字段名、类型与必填性如下表。一个基本示例来自 yamaha.menu_cursor 动作文档action: yamaha.menu_cursor target: entity_id: media_player.living_room_stereo data: cursor: down该示例会在media_player.living_room_stereo即某台 Yamaha 功放上按下向下光标键。YAML 中的选项字段说明必填类型cursor要按下的光标键up、down、left、right、select或return是stringcursor取值含义up/down/left/right在屏幕菜单中按对应方向移动光标select确认当前高亮的菜单项相当于按遥控器上的确定键return返回上一层菜单相当于按返回键。在自动化/脚本中的完整用法将该动作与yamaha集成的其他能力组合可实现完整的功放操作序列。例如参考 yamaha 集成文档 中的play_media脚本示例我们可以构建一个包含开机、调音量、光标导航确认的脚本script: movie_night: alias: Movie night on living room stereo sequence: - action: media_player.turn_on target: entity_id: media_player.living_room_stereo - action: media_player.volume_set target: entity_id: media_player.living_room_stereo data: volume_level: 0.35 - action: yamaha.select_scene target: entity_id: media_player.living_room_stereo data: scene: TV Viewing - action: yamaha.menu_cursor target: entity_id: media_player.living_room_stereo data: cursor: select上述示例展示了该动作在脚本序列中的典型定位作为整个流程中的一步向功放发送一次按键。动作目标Target该动作必须指定目标目标即动作的作用对象。根据 actions/targets.md 模板你可以把动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标下每一个匹配的media_player实体执行该动作实体Entity某一个具体的media_player实体例如media_player.living_room_stereo设备Device属于某台设备的所有media_player实体区域Area某个房间/区域内的所有media_player实体楼层Floor某个楼层上的所有media_player实体标签Label共享某个标签的所有media_player实体。同一个动作中还可以混用不同类型的多个目标例如同时指定一个具体实体和一个区域动作会依次作用到两者之上。由于 Yamaha 功放可能暴露多个区域zone实体如主区与 Zone 2通过实体级目标可以精确控制某个区而通过设备级目标则会对该功放的所有媒体播放器实体一次性发送光标指令请根据实际需求选择。动作调试与常见问题尝试运行在 UI 中创建动作后可参考 actions/try_it.md 的方式直接执行该动作验证效果——观察功放屏幕菜单是否发生了预期的光标移动或菜单确认/返回行为。卡住时排查如果动作没有生效可参考 actions/stuck.md 的排查思路重点检查以下几点功放是否已成功接入 Home Assistant实体是否可见、状态是否正常功放是否开启了网络待机功放处于完全关机状态时无法接收指令目标实体是否正确确认entity_id与功放的 zone 命名对应cursor参数是否在up、down、left、right、select、return六个合法值之内屏幕菜单当前是否处于可交互状态例如功放当前显示的是视频源而非 OSD 菜单时光标键可能无效。若此前已经通过 YAML 添加过集成配置请在修改configuration.yaml后重启 Home Assistant参见 yamaha 集成文档。相关动作组合根据 yamaha.menu_cursor 动作文档 的 front matter 中related_actions声明渲染规则见 actions/related.md以下动作与yamaha.menu_cursor搭配使用效果最佳yamaha.enable_output启用或禁用功放的某个输出端口如 HDMI 端口YAML 中使用port如hdmi1与enabled布尔字段yamaha.select_scene选择功放上预设的场景如TV Viewing、RadioYAML 中使用scene字符串字段。这三个动作覆盖了 Yamaha 功放选场景 → 切换输出 → 菜单光标导航的主要遥控操作面可灵活组合进自动化与脚本中实现全自动的影院、音乐等使用流程。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考