GroupManagementService
The GroupManagementService is available on these models: v1-S1
/ v1-S5
/ v1-S9
.
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. A โ
doesnโt mean that is wonโt emit events.
This file is automatically generated with @svrooij/sonos-docs, do not edit manually.