Sonos
AI-generatedSummary
Controls Sonos devices in a selected household. Choose an action to manage playback, favorites, audio clips, volume, grouping, home theater settings, TV power, or list groups.
Inputs
- Household (required) — Select the Sonos household. The node uses it to load groups, players, and favorites.
- Action (required) — Choose an operation: play, pause, toggle playback, skip tracks, play a favorite or URL audio clip, change volume, group all players, configure home theater or TV power, or list groups.
- Group(s) — For group actions, select one or more groups. If left empty, playback, pause, toggle, skip, favorite, and volume actions target the first available group. Audio clip playback requires at least one group.
- Player(s) — For player actions, select one or more players. Player-targeted actions require at least one player.
- Favorite — Select the Sonos favorite to load and play.
- Shuffle — Enable or disable shuffle when playing a favorite. Defaults to true.
- Repeat — Enable or disable repeat when playing a favorite. Defaults to true.
- Crossfade — Enable or disable crossfade when playing a favorite. Defaults to true.
- Volume — Set volume from 1 to 100. Used by volume actions and also applied before playback or favorite actions when shown.
- Soundfile — URL of the audio clip to play on selected players or groups.
- Night Mode — Set the home theater night mode option. Defaults to false.
- Enhance Dialog — Set the home theater dialog enhancement option. Defaults to false.
- Power State — Set the selected home theater player’s TV power state: true sends ON; false sends STANDBY.
Output shape
A list containing a single item with {"message":"ok"} for successful actions, or group records for List All Groups.
List All Groups returns the Sonos group records directly. With Continue On Fail enabled, errors are returned as an item containing an error message; otherwise execution fails. Most actions perform API side effects and return only the success message.