2025.3.4
首页 ▸ Integrations ▸

Onkyo

The onkyo integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] allows you to control Onkyo and Integra (from 2011 onward) and also Pioneer (from 2016 onward) receivers using Home Assistant. Please be aware that you need to enable “Network Standby” for this integration to work with your hardware.

配置

要将 Onkyo device 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

Onkyo 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

Host

Hostname or IP address of the device, for example:192.168.1.2.

Volume Resolution

Number of steps it takes for the receiver to go from the lowest to the highest possible volume. Possible values are 50, 80, 100, 200. For older Onkyo receivers, this typically is 80; newer Onkyo receivers use 200.

Input sources

List of input sources supported by the receiver.

Listening modes

List of listening modes supported by the receiver.

The above settings can also be adjusted later. To change Host or Volume Resolution, select the three-dot menu on the integration entry and select Reconfigure.

选项

Onkyo 的选项可以通过用户界面设置，具体步骤如下：

  • 浏览到您的 Home Assistant 实例。
  • 转到 设置 > 设备与服务。
  • 如果配置了多个 Onkyo 实例，请选择您想配置的实例。
  • 选择集成，然后选择 配置。
Max Volume

Maximum volume limit as a percentage. Often the maximum volume of the receiver is far too loud. Setting this will set Home Assistant’s 100% volume to be this setting on the amp, i.e., if you set this to 50%, when you set Home Assistant to be 100%, then your receiver will be set to 50% of its maximum volume.

Input sources

Mappings of input sources to their names.

Listening modes

Mappings of listening modes to their names.

Zones

If your receiver has a second or third zone available, they are displayed as additional media players with functionality similar to the main zone.

Actions

Action onkyo_select_hdmi_output

Changes HDMI output of your receiver

Data attribute Optional Description
entity_id no String or list of a single entity_id that will change output.
hdmi_output no The desired output code.

Accepted values are: ‘no’, ‘analog’, ‘yes’, ‘out’, ‘out-sub’, ‘sub’, ‘hdbaset’, ‘both’, ‘up’ which one to use seems to vary depending on model so you will have to try them out. ( For model TX-NR676E it seems to be ‘out’ for main, ‘out-sub’ for sub, and ‘sub’ for both )

Example onkyo_select_hdmi_output script 

# Example onkyo_select_hdmi_output script
#
script:
  hdmi_sub:
    alias: "Hdmi out projector"
    sequence:
      - action: media_player.onkyo_select_hdmi_output
        data:
          entity_id: media_player.onkyo
          hdmi_output: out-sub

Example play_media script

The play_media function can be used in script to play radio station by preset number. Not working for NET radio.

# Example play_media script
#
script:
  radio1:
    alias: "Radio 1"
    sequence:
      - action: media_player.turn_on
        target:
          entity_id: media_player.onkyo
      - action: media_player.play_media
        target:
          entity_id: media_player.onkyo
        data:
          media_content_type: "radio"
          media_content_id: "1"

Supported devices

Network receivers from Onkyo and Integra are supported starting with models from the year 2011. Pioneer network receivers are supported starting with models from 2016.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

从Home Assistant中移除集成实例

  1. 前往 设置 > 设备与服务 并选择集成卡片。
  2. 从设备列表中，选择要删除的集成实例。
  3. 在条目旁边，选择三个点 菜单。然后，选择 删除。