fresh-home/components/packages/clever_announcements.yaml

script:
  make_clever_announcement:
    alias: Make Clever Announcement
    description: Play an announcement cleverly
    icon: mdi:bullhorn
    mode: queued
    fields:
      entity_id:
        description: Media player to use for announcements (If left empty, uses the ytube music player speaker(s) currently in use)
        example: media_player.announcements
        selector:
          entity:
            multiple: false
            domain: media_player

      media_content_id:
        description: "Media Content ID to announce"
        example: media-source://media_source/tts/welcome_to_daddys_house.mp3
        selector:
          text:

      media_content_type:
        description: "The media content type of the specified media"
        example: music
        selector:
          text:

      volume:
        description: "The volume that the announcement should play at"
        example: "0.6"
        selector:
          number:
            min: 0.0
            max: 1.0
            step: 0.01

    variables:
      # This beast of a line uses the media players in this order:
      # If an entity_id was specified, use that always
      # If an entity_id was not specified, check if YTube Music Player is in use:
      # If YTube Music Player is in use, play the announcement over those speakers
      # If YTube Music Player is not in use, play the announcement over the media_player.announcements speaker group
      media_player: '{{ iif(entity_id is defined, entity_id, iif(is_state("media_player.ytube_music_player","playing") or is_state("media_player.ytube_music_player","idle") or is_state("media_player.ytube_music_player","paused"),state_attr("media_player.ytube_music_player","remote_player_id"),"media_player.announcements")) }}'
      remote_player: '{{ iif(entity_id is defined, entity_id, iif(is_state("media_player.ytube_music_player","playing") or is_state("media_player.ytube_music_player","idle") or is_state("media_player.ytube_music_player","paused"),state_attr("media_player.ytube_music_player","remote_player_id"),"")) }}'
      content_id: '{{ iif(media_content_id is defined,media_content_id,"media-source://media_source/tts/welcome_to_daddys_house.mp3") }}'
      content_type: '{{ iif(media_content_type is defined,media_content_type,"music") }}'
      volume: "{{ iif(volume is defined,volume,0.6) }}"
      original_volume: '{{ iif(is_state("media_player.ytube_music_player","off"),0.0)}}' #,state_attr(state_attr("media_player.ytube_music_player","remote_player_id"), "volume")) }}'
      ytube_in_use: '{{ is_state("media_player.ytube_music_player","playing") or is_state("media_player.ytube_music_player","idle") or is_state("media_player.ytube_music_player","paused") }}'

    sequence:
      - action: logbook.log
        data:
          name: Clever Announcement Values
          entity_id: script.make_clever_announcement
          message: >
            Hopefully this contains all of the values:
            media_player: {{ media_player }}
            content_id: {{ content_id }}
            content_type: {{ content_type }}
            volume: {{ volume }}
            original_volume: {{ original_volume }}
            ytube_in_use: {{ ytube_in_use }}
          domain: script

      - choose:
          - alias: "Ytube music player is playing something"
            conditions: "{{ ytube_in_use }}"
            sequence:
              - alias: "Interrupt ytube music player"
                action: ytube_music_player.call_method
                entity_id: media_player.ytube_music_player
                data:
                  command: interrupt_start

              - alias: "Then wait a second"
                delay:
                  hours: 0
                  minutes: 0
                  seconds: 2

      - alias: "Set the volume on the announcement speakers"
        action: media_player.volume_set
        target:
          entity_id: "{{media_player}}"
        data:
          volume_level: "{{volume}}"

      - alias: "Play the announcement"
        action: media_player.play_media
        target:
          entity_id: "{{media_player}}"
        data:
          media_content_id: "{{content_id}}"
          media_content_type: "{{content_type}}"

      - alias: Wait for the specified media_player(s) to become idle
        wait_for_trigger:
          - platform: template
            value_template: "{{ is_state(media_player, 'idle') or is_state(media_player, 'off') or is_state(media_player, 'unavailable')}}"
        timeout: "00:00:30"

      - alias: "Give a second of dead air after the announcement"
        delay:
          hours: 0
          minutes: 0
          seconds: 2

      - choose:
          - alias: "Ytube music player was playing something earlier"
            conditions: "{{ ytube_in_use }}"
            sequence:
              - alias: "Mute the remote speakers momentarily"
                action: media_player.volume_set
                target:
                  entity_id: "{{ remote_player }}"
                data:
                  volume_level: 0

              - alias: "Resume the ytube music player playlist"
                action: ytube_music_player.call_method
                entity_id: media_player.ytube_music_player
                data:
                  command: interrupt_resume

              - alias: "Reset the volume of the remote speakers to the previous level"
                action: media_player.volume_set
                target:
                  entity_id: "{{ remote_player }}"
                data:
                  volume_level: "{{original_volume}}"

        default:
          - alias: "Since we're not resuming music, turn off the speakers used to make the announcement"
            action: media_player.turn_off
            data: {}
            target:
              entity_id: "{{ media_player }}"

      - alias: "Wait at least 1 seconds before handling the next announcement in queue"
        delay: "00:00:02"