코디(Kodi)

kodi 플랫폼을 사용하면 Home Assistant에서 Kodi 멀티미디어 시스템을 제어할 수 있습니다.

Kodi 플랫폼을 설정하는 기본 방법은 Kodi 설치에서 활성화된 web interface가 필요한 discovery component를 활성화하는 것입니다.

현재 홈어시스턴트에는 다음과 같은 장치 유형이 지원됩니다.

• Media Player
• Notifications

설정

검색(discovery이 작동하지 않거나 특정 설정 변수가 필요한 경우 configuration.yaml 파일에 다음을 추가 할 수 있습니다.

# Example configuration.yaml entry
media_player:
  - platform: kodi
    host: IP_ADDRESS

서비스

kodi.add_to_playlist 서비스

기본 재생 목록에 음악을 추가합니다 (즉, playlistid=0).

kodi.call_method 서비스

선택적 매개 변수를 사용하여 Kodi JSONRPC API 메소드를 호출하십시오. Kodi API 호출의 결과는 Home Assistant 이벤트인 kodi_call_method_result에서 리디렉션됩니다.

이벤트 트리거하기(Event triggering)

kodi.call_method 서비스를 호출할 때 Kodi JSONRPC API가 데이터를 리턴하면 홈어시스턴트가 수신할 때 다음 event_data와 함께 이벤트 버스에서 kodi_call_method_result 이벤트를 발생시킵니다.

entity_id: "<Kodi media_player entity_id>"
result_ok: <boolean>
input: <input parameters of the service call>
result: <data received from the Kodi API>

Kodi turn on/off 예시

turn_on_action 및 turn_off_action 매개 변수를 사용하면 홈어시스턴트 작업을 조합하여 Kodi 인스턴스를 켜거나 끌 수 있습니다. 이전의 turn_off_action 옵션 목록에 대한 마이그레이션 지침을 포함하여 이 사용법의 몇 가지 예가 있습니다.

Wake on LAN으로 Kodi 켜기

이 설정으로 Kodi 장치에서 media_player/turn_on을 호출하면 magic packet 이 지정된 MAC 주소로 전송됩니다. 이 서비스를 사용하려면 먼저 Home Assistant에서 wake_on_lan 통합구성요소를 설정해야합니다. 이는 wake_on_lan:을 configuration.yaml에 추가하기 만하면됩니다.

media_player:
  - platform: kodi
    host: 192.168.0.123
    turn_on_action:
      - service: wake_on_lan.send_magic_packet
        data:
          mac: aa:bb:cc:dd:ee:ff
          broadcast_address: 192.168.255.255

API 호출로 Kodi 끄기

다음은 Kodi를 끄도록 각 이전 옵션을 설정하는 동등한 방법입니다 (quit, hibernate, suspend, reboot 또는 shutdown).

• Quit method (before was turn_off_action: quit)

media_player:
  - platform: kodi
    host: 192.168.0.123
    turn_off_action:
      service: kodi.call_method
      data:
        entity_id: media_player.kodi
        method: Application.Quit

• Hibernate method (before was turn_off_action: hibernate)

media_player:
  - platform: kodi
    host: 192.168.0.123
    turn_off_action:
      service: kodi.call_method
      data:
        entity_id: media_player.kodi
        method: System.Hibernate

• Suspend method (before was turn_off_action: suspend)

media_player:
  - platform: kodi
    host: 192.168.0.123
    turn_off_action:
      service: kodi.call_method
      data:
        entity_id: media_player.kodi
        method: System.Suspend

• Reboot method (before was turn_off_action: reboot)

media_player:
  - platform: kodi
    host: 192.168.0.123
    turn_off_action:
      service: kodi.call_method
      data:
        entity_id: media_player.kodi
        method: System.Reboot

• Shutdown method (before was turn_off_action: shutdown)

media_player:
  - platform: kodi
    host: 192.168.0.123
    turn_off_action:
      service: kodi.call_method
      data:
        entity_id: media_player.kodi
        method: System.Shutdown

Kodi JSON-CEC 애드온으로 TV 켜고 끄기

CEC 가능 TV (예: OSMC / OpenElec 및 Rasperry Pi에서 실행되는 시스템과 같은 시스템)에 연중 무휴로 연결된 Kodi 장치의 경우 이 설정을 통해 Kodi는 항상 홈어시스턴트에서 연결된 TV를 켜고 끌 수 있습니다 활성 및 준비 :

media_player:
  - platform: kodi
    host: 192.168.0.123
    turn_on_action:
      service: kodi.call_method
      data:
        entity_id: media_player.kodi
        method: Addons.ExecuteAddon
        addonid: script.json-cec
        params:
          command: activate
    turn_off_action:
    - service: media_player.media_stop
      data:
        entity_id: media_player.kodi
    - service: kodi.call_method
      data:
        entity_id: media_player.kodi
        method: Addons.ExecuteAddon
        addonid: script.json-cec
        params:
          command: standby

Kodi 서비스 사례

시간 함수로 일부 채널에서 PVR을 켜는 간단한 스크립트

script:
  play_kodi_pvr:
    alias: Turn on the silly box
    sequence:
      - alias: TV on
        service: media_player.turn_on
        data:
          entity_id: media_player.kodi
      - alias: Play TV channel
        service: media_player.play_media
        data_template:
          entity_id: media_player.kodi
          media_content_type: "CHANNEL"
          media_content_id: >
            {% if (now().hour < 14) or ((now().hour == 14) and (now().minute < 50)) %}
              10
            {% elif (now().hour < 16) %}
              15
            {% elif (now().hour < 20) %}
              2
            {% elif (now().hour == 20) and (now().minute < 50) %}
              10
            {% elif (now().hour == 20) or ((now().hour == 21) and (now().minute < 15)) %}
              15
            {% else %}
              10
            {% endif %}

스마트 재생 목록을 재생하는 간단한 스크립트

script:
  play_kodi_smp:
    alias: Turn on the silly box with random Firefighter Sam episode
    sequence:
      - alias: TV on
        service: media_player.turn_on
        data:
          entity_id: media_player.kodi
      - service: media_player.play_media
        data:
          entity_id: media_player.kodi
          media_content_type: DIRECTORY
          media_content_id: special://profile/playlists/video/feuerwehrmann_sam.xsp

Kodi 비디오 라이브러리 업데이트 트리거

script:
  update_library:
    alias: Update Kodi Library
    sequence:
      - alias: Call Kodi update
        service: kodi.call_method
        data:
          entity_id: media_player.kodi
          method: VideoLibrary.Scan

알림

kodi 알림 플랫폼을 사용하면 Home Assistant에서 Kodi 멀티미디어 시스템으로 메시지를 보낼 수 있습니다.

설치에 Kodi를 추가하려면 configuration.yaml 파일에 다음을 추가하십시오.

# Example configuration.yaml entry
notify:
  - platform: kodi
    name: NOTIFIER_NAME
    host: IP_ADDRESS

스크립트 사례

kodi_notification:
  sequence:
  - service: notify.NOTIFIER_NAME
    data:
      title: "Home Assistant"
      message: "Message to KODI from Home Assistant!"
      data:
        displaytime: 20000
        icon: "warning"

메시지 변수들

알림을 사용하려면 getting started with automation page를 참조하십시오.