Make play_on_device_media_file/media_file templatable

[esand]

Component name

media_player

Link to component documentation on our website

https://esphome.io/components/media_player/speaker/

Describe the enhancement

Currently, media_player.speaker.play_on_device_media_file doesn't support templating the id of the audio file for media_file. This makes the function very limiting, as you can't have any logic in the call to determine what file to play. If media_file allowed templating, then you would be able to have a lambda determine which file to play.

Use cases

In my project example, I have numerous different audio alert sounds, and a select that allows users to pick one. When it comes to playing the selected audio file, I cannot use media_player.speaker.play_on_device_media_file because I can't use any lambda code.

Anything else?

I'd also like to point out that it does not seem possible to provide the id of the media player you want to use when calling media_player.speaker.play_on_device_media_file.

In regards to having the ability to define audio files on both speaker as well as speaker_source (by creating a media source) platforms, I would suggest that both speaker and speaker_source merge their feature set into just speaker. Being able to use audio-file:// along with a media source makes working with both local and streaming audio resources significantly easier (and working with them using lambdas is also much easier too).

[github-actions[bot]]

🏷️ I've automatically added the component: media_player label to help categorize this feature request.

[esand]

FYI, I was able to make media_file templatable with just three line changes in speaker/media_player/__init__.py.
I changed line 504 to:

cv.Required(CONF_MEDIA_FILE): cv.templatable(cv.use_id(audio.AudioFile))

I commented out line 515 where it assigns media_file, and change line 519 to:

template_ = await cg.templatable(config[CONF_MEDIA_FILE], args, audio.AudioFile.operator("ptr"))

I don't know if this is the right way to do it, but it allowed me to template it and my code seems to work, so good enough for me for now.