Link Search Menu Expand Document

GroupManagementService

The GroupManagementService is available on these models: Sonos One (S13) S2 / Sonos Roam (S27) S2 / Sonos Play:5 (S6) S2 / Sonos Sub (Sub) S2 / Sonos Play:1 (S1) S1 / Sonos Play:5 (S5) S1 / Sonos Playbar (S9) S1.

  1. Available actions
    1. AddMember
    2. RemoveMember
    3. ReportTrackBufferingResult
    4. SetSourceAreaIds
  2. Events
    1. Subscribe to events
    2. Event variables

Service data

name value
Control URL http://192.168.x.x:1400/GroupManagement/Control
Event subscription URL http://192.168.x.x:1400/GroupManagement/Event
Discovery url http://192.168.x.x:1400/xml/GroupManagement1.xml
Service ID urn:upnp-org:serviceId:GroupManagement
Service type urn:schemas-upnp-org:service:GroupManagement:1

Sample request

POST /GroupManagement/Control
Host: 192.168.x.x:1400
soapaction: "urn:schemas-upnp-org:service:GroupManagement:1#{ActionName}"
Content-Type: text/xml; charset="utf-8"

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <s:Body>
    {ActionBodyHere}
  </s:Body>
</s:Envelope>

Available actions

AddMember

Action body:

<u:AddMember xmlns:u="urn:schemas-upnp-org:service:GroupManagement:1">
  <MemberID>string</MemberID>
  <BootSeq>ui4</BootSeq>
</u:AddMember>

Inputs:

parameter type description
MemberID string  
BootSeq ui4  

Outputs:

parameter type description
CurrentTransportSettings string  
CurrentURI string  
GroupUUIDJoined string  
ResetVolumeAfter boolean  
VolumeAVTransportURI string  

RemoveMember

Action body:

<u:RemoveMember xmlns:u="urn:schemas-upnp-org:service:GroupManagement:1">
  <MemberID>string</MemberID>
</u:RemoveMember>

Inputs:

parameter type description
MemberID string  

ReportTrackBufferingResult

Action body:

<u:ReportTrackBufferingResult xmlns:u="urn:schemas-upnp-org:service:GroupManagement:1">
  <MemberID>string</MemberID>
  <ResultCode>i4</ResultCode>
</u:ReportTrackBufferingResult>

Inputs:

parameter type description
MemberID string  
ResultCode i4  

SetSourceAreaIds

Action body:

<u:SetSourceAreaIds xmlns:u="urn:schemas-upnp-org:service:GroupManagement:1">
  <DesiredSourceAreaIds>string</DesiredSourceAreaIds>
</u:SetSourceAreaIds>

Inputs:

parameter type description
DesiredSourceAreaIds string  

Events

The GroupManagementService has variables that might be emitted if you subscribe to events.

Subscribe to events

SUBSCRIBE /GroupManagement/Event
Host: 192.168.x.x:1400
callback: <http://...>
NT: upnp:event
Timeout: Second-3600

Event variables

Variable Sends events* type possible values
GroupCoordinatorIsLocal boolean  
LocalGroupUUID string  
ResetVolumeAfter boolean  
SourceAreaIds   string  
VirtualLineInGroupID string  
VolumeAVTransportURI string  

If the variable has a in the Sends events column, the service discovery specifies this variable emits events. Other properties might be send as a part of LastChange


This file is automatically generated with @svrooij/sonos-docs, do not edit manually.

Device Software generation Software version Discovery date
Sonos One (S13) S2 63.2-90210 2021-07-21T23:31:19.273Z
Sonos Roam (S27) S2 63.2-90210 2021-07-21T23:31:31.207Z
Sonos Play:5 (S6) S2 63.2-90210 2021-07-21T23:31:45.324Z
Sonos Sub (Sub) S2 63.2-90210 2021-07-21T23:31:40.304Z
Sonos Play:1 (S1) S1 57.6-88280 2021-07-21T14:51:41.469Z
Sonos Play:5 (S5) S1 57.6-88280 2021-07-21T14:51:44.187Z
Sonos Playbar (S9) S1 57.6-88280 2021-07-21T14:51:47.050Z