Link Search Menu Expand Document


External music services

The MusicServicesService is available on these models: v1-S1 / v1-S5 / v1-S9.

  1. Available actions
    1. GetSessionId
    2. ListAvailableServices
    3. UpdateAvailableServices
  2. Events
    1. Subscribe to events
    2. Event variables

Service data

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

Sample request

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

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="" s:encodingStyle="">

Available actions


Action body:

<u:GetSessionId xmlns:u="urn:schemas-upnp-org:service:MusicServices:1">


parameter type description
ServiceId ui4 ย 
Username string ย 


parameter type description
SessionId string ย 


Load music service list as xml

Action body:

<u:ListAvailableServices xmlns:u="urn:schemas-upnp-org:service:MusicServices:1">

No input arguments


parameter type description
AvailableServiceDescriptorList string ย 
AvailableServiceTypeList string ย 
AvailableServiceListVersion string ย 

Remarks Some libraries also support ListAndParseAvailableServices


Action body:

<u:UpdateAvailableServices xmlns:u="urn:schemas-upnp-org:service:MusicServices:1">

No input arguments


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

Subscribe to events

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

Event variables

Variable Sends events* type possible values
ServiceId โŒ ui4 ย 
ServiceListVersion โœ” string ย 
SessionId โŒ string ย 
Username โŒ 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.