2025.3.4
首页 ▸ Integrations ▸

Yamaha Network Receivers

The yamaha integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] allows you to control Yamaha Network Receivers from Home Assistant.

Supported devices:

To add a Yamaha Network Receiver to your installation, add the following to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file. 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# Example configuration.yaml entry
media_player:
  - platform: yamaha

You must enable network standby on your receiver, or else startup of Home Assistant will hang if you have your receiver switched off.

Configuration Variables

Looking for your configuration file?
name string (Optional)

Name of the device. This overrides the default name (often model number) that is returned by the device.

host string (Optional)

IP address or hostname of the device.

source_ignore list (Optional)

List of sources to hide in the front-end.

source_names list (Optional)

Mapping of internal AVR source names to custom ones, allowing one to rename e.g., HDMI1 to ChromeCast.

zone_ignore list (Optional)

List of zones to hide in the front-end.

zone_names list (Optional)

Mapping of zone names to custom ones, allowing one to rename e.g., Main_Zone to Family Room.

Supported operations

  • Media players created by Yamaha support powering on/off, mute, volume control and source selection. Playback controls, for instance play and stop are available for sources that supports it.
  • The play_media action is implemented for NET RADIO source only. The media_id is a > separated string of the menu path on the vtuner service. For instance Bookmarks>Internet>WAMC 90.3 FM. MusicCast devices use the path Radio>Favorites>WAMC 90.3 FM.

Example configuration

A full configuration example will look like the sample below:

# 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 Room"

Example play_media script

The play_media function can be used in scripts easily to build media player presets. When done in scripts, the sequence will also allow you to set volume per source.

# Example play_media script
#
# This is for an environment where Zone 2 of the receiver named
# `Living Room Stereo` drives outdoor speakers on the porch.
script:
 rp_porch:
    alias: "Radio Paradise Porch"
    sequence:
      - action: media_player.turn_on
        target:
          entity_id: media_player.living_room_stereo_zone_2
      - action: media_player.volume_set
        target:
          entity_id: media_player.living_room_stereo_zone_2
        data:
          volume_level: 0.48
      - action: media_player.play_media
        target:
          entity_id: media_player.living_room_stereo_zone_2
        data:
          media_content_type: "NET RADIO"
          media_content_id: "Bookmarks>Internet>Radio Paradise"

Action enable_output

Enable or disable an output port (HDMI) on the receiver.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_ids of Yamaha receivers.
port no Port to enable or disable, e.g., hdmi1.
enabled no To enable set true, otherwise set to false.

Action menu_cursor

Control the menu cursor.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_ids of Yamaha receivers.
cursor no Name of the cursor key to press: up, down, left, right, select, return

Action select_scene

Select a scene on the receiver.

Data attribute Optional Description
entity_id yes String or list of strings that point at entity_ids of Yamaha receivers.
scene no Scene to select, e.g., BD/DVD Movie Viewing, TV Viewing, NET Audio Listening or Radio Listening.

相关主题