In Sonos version 9.3, we added subscribe and unsubscribe commands to the audioClip namespace and made some updates. We also added a settings namespace. See Release notes for Sonos software for customer-facing features.
Audio clip
We made the following updates:
- You can
subscribeandunsubscribeto theaudioClipnamespace to receiveaudioClipStatusevents. - The
statusparameter in theaudioClipobject lets you know whether the clip is scheduled for playback, is currently playing, has played, or has been dismissed.
Note: This namespace is experimental. Some of the functionality may not yet work as documented. For example, the AUDIO_CLIP capability in the player object has not yet been released, so you won’t be able to tell which players support audio clips and which do not. Currently, the only players that support audio clips are the Sonos One and the Beam. See the groups object for details about capabilities.
We’ll let you know when we’ve added more functionality. Keep an eye on this blog for details.
Settings
You can use the setPlayerSettings command to change playerSettings. For example:
- Change the
volumeModetoPASS_THROUGHa Sonos device such as the Amp or Connect. - Change the
volumeScalingFactorto limit the maximum volume for Sonos players. - Turn on
monoModefor a pair of Sonos players. - Disable WiFi on a Sonos player (
wifiDisable).
Soon you will be able to use getPlayerSettings to see the current values for these settings. Watch this space for an update on when you can use this command.
We hope you enjoy these changes and look forward to seeing what you build with them!