document remove_from_queue (#38219)

This commit is contained in:
Andrew Sayre 2025-03-28 11:40:04 -05:00 committed by GitHub
parent 51f1476989
commit 917b40f649
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -87,7 +87,7 @@ In addition to the standard [Media Player actions](/integrations/media_player#ac
Group volume actions: `heos.group_volume_set`, `heos.group_volume_down`, and `heos.group_volume_up` for entities joined to a group.
Queue actions: `heos.get_queue` to manage a player's queue items.
Queue actions: `heos.get_queue` and `heos.remove_from_queue` to manage a player's queue items.
### Action `heos.group_volume_set`
@ -129,6 +129,24 @@ media_player.office:
album_id: "134788273"
```
### Action `heos.remove_from_queue`
Removes one or more items from the target player(s) queue. The play queue can be enumerated by using the `heos.get_queue` service. Example action data payload:
```yaml
action: heos.remove_from_queue
target:
entity_id: media_player.family_room_receiver
data:
queue_ids:
- 1
- 3
```
| Data attribute | Optional | Description |
| ---------------------- | -------- | ------------------------------------------------------- |
| `queue_ids` | no | The IDs (indexes) of the items in the queue to remove. |
## Examples
### Playing media