Document HEOS clear playlist behavior (#37781)

* Add clear playlist limitation to HEOS docs

Clear playlist action generates an error if the playlist is already empty and will halt automations after home-assistant/core#136049. Referenced in issue home-assistant/core#139659. Documenting the workaround.

* Move update to actions section

* Tweak language

---------

Co-authored-by: Andrew Sayre <6730289+andrewsayre@users.noreply.github.com>
This commit is contained in:
kernelpanic85 2025-03-03 11:20:25 -05:00 committed by GitHub
parent a075f37ce9
commit c300493ec2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -204,6 +204,11 @@ data:
The HEOS integration makes available the standard [Media Player actions](/integrations/media_player#actions).
{% note %}
Actions may fail if they cannot be processed by the HEOS device. For example, attempting to call `media_player.clear_playlist` when the queue is empty will result in an error. To prevent this from halting a script or automation, set [`continue_on_error: true`](/docs/scripts/#continuing-on-error) in the action call.
{% endnote %}
## Supported devices
Denon and Marantz do not currently publish an inventory of HEOS-enabled devices, however, many receiver and hi-fi products began including HEOS since 2013. Consult your product model to confirm support: